z/OS MVS Programming: Sysplex Services Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Return and Reason Codes

z/OS MVS Programming: Sysplex Services Reference
SA38-0658-00

Start of change
When the IXCNOTE macro returns control to your program:
  • GPR 15 (and retcode, when you code RETCODE) contains a return code.
  • When the value in GPR 15 is not zero, GPR 0 (and rsncode, when you code RSNCODE) contains a reason code. Note that bits 0-15 of the reason code might contain component diagnostic data for use by IBM® service personnel. XCF provides the IXCNOTERSNCODEMASK constant to mask off the component-diagnostic data.
The IXCYCON macro provides equate symbols for the return and reason codes. The equate symbols associated with each hexadecimal return code are as follows:
0
IXCRETCODEOK
4
IXCRETCODEWARNING
8
IXCRETCODEPARMERROR
C
IXCRETCODEENVERROR
10
IXCRETCODECOMPERROR

The following table identifies the hexadecimal return and reason codes. IBM support personnel might request the entire reason code, including the xxxx value.

Table 1. Return and Reason Codes for the IXCNOTE Macro

Hexadecimal
Return Code

Hexadecimal
Reason Code

Equate Symbol
Meaning and Action

0 None. Meaning: Successful completion.
4 xxxx0401 Equate Symbol: IXCNOTERSNMOREDATA

Meaning: The request was processed and some of the requested data was stored in the answer area. The ANSAREA is large enough to hold the header (IXCYNOTE_TANSAREA) but does not have room for all the requested data. The AA_ANSAREASIZENEEDED returned in the ANSAREA indicates how much storage is required in order for the ANSAREA to hold all the requested data.

For requests that produce varying quantities of output data due to the dynamics of the system (for example, query of a note pad), the actual amount of storage needed for the answer area when the request is reissued can differ from the indicated size. One might choose to obtain more storage than indicated by AA_ANSAREASIZENEEDED in order to reduce the likelihood of getting this return and reason code when the request is reissued.

Action: As needed, obtain storage for the answer area that is at least as large as the indicated size and reissue the request.

4 xxxx0402 Equate Symbol: IXCNOTERSNMORENOTES

Meaning: A request to read notes in the note pad completed prematurely. The answer area, and as applicable, the buffer area, were filled with as many notes as would fit.

Action: After processing these results, continue reading the remaining notes by reissuing the IXCNOTE request specifying the RESUMETOKEN that was returned in the RESUMETOKEN output variable.

4 xxxx0403 Equate Symbol: IXCNOTERSNRESUMED

Meaning: As a result of an IXCNOTE REQUEST=CONNECTION REQTYPE=PAUSE request, the connector was being paused until the note pad was no longer quiesced. The pause request was resumed due to some condition other than the note pad becoming unquiesced. For example, some other work unit called IXCNOTE REQUEST=CONNECTION REQTYPE=RESUME to resume the paused work unit, or the connection terminated, or the note pad failed.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSRESUMED.

Action: As needed, reissue the IXCNOTE REQUEST=CONNECTION REQTYPE=PAUSE request to wait for the quiesce conditions to clear. If an answer area was provided, examine the data returned in the answer area for additional information.

4 xxxx0441 Equate Symbol: IXCNOTERSNPENDING
Meaning: The request is pending.
  • If REQUEST=CONNECTION REQTYPE=CREATE was specified, the connection was successfully created. However, the connection is currently in a quiesced state. If an answer area was provided, the field aa_Details provides additional information. The data is mapped by IXCYNOTE_TDETAILSQUIESCED.
  • If REQUEST=CONNECTION REQTYPE=RESUME was specified, no connection was found to be paused. The resume request was recorded so that the next pause request will be immediately resumed.
  • If REQUEST=CONNECTION REQTYPE=DELETE was specified, the connection was marked for deletion. However, not all of the necessary cleanup could be accomplished because XCF was not able to access the relevant coupling facility structures. XCF will automatically complete the deletion when access to the structures is restored. If an answer area was provided, the field aa_Details provides additional information. The data is mapped by IXCYNOTE_TDETAILSQUIESCED or by IXCYNOTE_TDETAILSNORESOURCES.
  • If REQUEST=NOTEPAD REQTYPE=DELETE was specified, the note pad was marked for deletion. However, not all of the necessary cleanup could be accomplished because XCF was not able to access the relevant coupling facility structures. XCF will automatically complete the deletion when access to the structures is restored. While deletion of the note pad is pending, some requests can get unexpected results. For example, you might be able to create a new connection to the note pad, or an attempt to create a new instance of the note pad might be rejected because the old instance still exists.
Action:
  • If REQUEST=CONNECTION REQTYPE=CREATE or REQTYPE=DELETE was specified, consider using IXCNOTE REQUEST=CONNECTION REQTYPE=PAUSE to wait until the connection is no longer quiesced. If an answer area was provided, examine the data returned in the answer area for additional information.
  • If REQUEST=NOTEPAD REQTYPE=DELETE was specified, consider using REQUEST=NOTEPAD REQTYPE=QUERY to verify that the note pad has been deleted before proceeding. You might need to be sensitive to the particular instance of the note pad (see NPD_ETODWHENCREATED in macro IXCYNOTE).
8 xxxx0001 Equate Symbol: IXCNOTERSNPLISTBADSTG

Meaning: Program error. The storage containing the parameter list is not accessible. It must be both addressable and accessible using the PSW key of the caller.

The error occurred while trying to store output data in the parameter list after the IXCNOTE request had been processed. The request might or might not have completed successfully. The note pad might or might not have been altered. In the specific case of REQUEST=CONNECTION REQTYPE=CREATE, the connection that was created, if any, has been deleted by XCF.

Action:
  • Verify that the correct parameter list storage area was specified, and the storage area was not inadvertently freed.
  • As needed, verify whether the request had been processed using REQTYPE=QUERY or REQTYPE=READ.
  • Take an appropriate recovery action.
8 xxxx0003 Equate Symbol: IXCNOTERSNPLISTBADRSVD

Meaning: Program error. A reserved field in the parameter list is not zero. Either the parameter list was corrupted or the program is running on a system that does not have the necessary support.

Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of z/OS® your program is running on.

8 xxxx0004 Equate Symbol: IXCNOTERSNPLISTBADVERSION

Meaning: Program error. The parameter list version number value is not valid. Either the parameter list was corrupted or the program is running on a system that does not have the necessary support.

Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of z/OS your program is running on.

8 xxxx0005 Equate Symbol: IXCNOTERSNPLISTBADREQUEST

Meaning: Program error. The parameter list content for the REQUEST keyword is not valid. Either the parameter list was corrupted or the program is running on a system that does not have the necessary support.

Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of z/OS your program is running on.

8 xxxx0006 Equate Symbol: IXCNOTERSNPLISTBADREQTYPE

Meaning: Program error. The parameter list content for the REQTYPE keyword is not valid. Either the parameter list was corrupted or the program is running on a system that does not have the necessary support.

Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of z/OS your program is running on.

8 xxxx0008 Equate Symbol: IXCNOTERSNPLISTBADTAGGING

Meaning: Program error. The parameter list content for the TAGGING keyword is not valid. Either the parameter list was corrupted or the program is running on a system that does not have the necessary support.

Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of z/OS your program is running on.

8 xxxx0010 Equate Symbol: IXCNOTERSNNOTEPADBADVAL

Meaning: Program error. The parameter list content for the NOTEPAD keyword is not valid. The indicated note pad name does not conform to the requirements for a valid name. Note pad names consist of four 8 byte sections. Each 8 byte section must be left justified, padded on the right with EBCDIC blanks as needed. Each section can contain any uppercase alphabetic (A-Z), numeric (0-9), national (@, #, $), or underscore (_) character.

Action: Verify that the note pad name specified for the NOTEPAD keyword meets the requirements of the keyword.

8 xxxx0011 Equate Symbol: IXCNOTERSNNOTEPADNOTEXIST

Meaning: The specified note pad does not exist. For REQUEST=NOTEPAD or for REQUEST=CONNECTION with REQTYPE=CREATE, the note pad named by the NOTEPAD keyword does not exist. For any other request, the note pad to which the CONNECTION token applies no longer exists. The connection token is no longer valid for use.

Action: As needed, create a new instance of the note pad, establish a new connection, and reconstruct the notes.

8 xxxx0012 Equate Symbol: IXCNOTERSNNOTEPADFAILED

Meaning: The note pad failed and could not be recovered by XCF. It no longer exists. The connection token is no longer valid for use.

This condition will typically be detected by an in-flight request. Subsequent attempts to issue IXCNOTE requests with the input connection token might be rejected with a return and reason code indicating that the connection no longer exists. IXCNOTE requests issued by other connectors might be rejected with a return and reason code indicating that the note pad no longer exists (IXCNOTERSNNOTEPADNOTEXIST) or that the connection no longer exists (IXCNOTERSNCONNECTIONNOTEXIST).

Action: As needed, create a new instance of the note pad, establish a new connection, and reconstruct the notes.

8 xxxx0013 Equate Symbol: IXCNOTERSNNOTEPADEXISTS

Meaning: The specified note pad already exists.

If an answer area was provided, the note pad data record (IXCYNOTE_TNOTEPADDATA) stored therein describes the existing note pad.

Action:
  • If an answer area was provided, review the note pad data returned in the answer area.
  • If an answer area was not provided, consider querying the note pad data using REQUEST=NOTEPAD REQTYPE=QUERY.
8 xxxx0014 Equate Symbol: IXCNOTERSNNOTEPADINUSE

Meaning: Program error. A request to delete the note pad is rejected because the specified note pad is still in use. It either has connectors, or contains notes, or both.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSDELETENP.

Action: Try the request again after the relevant connectors, notes, or both have been deleted, or specify the appropriate CONDITIONS when issuing the delete request.

8 xxxx0015 Equate Symbol: IXCNOTERSNNOTEPADMULTIWRITENO

Meaning: A request to create a connection with ACCESS=UPDATE is rejected. Since the creator of the note pad specified MULTIWRITE=NO, at most one connector with ACCESS=UPDATE can be connected to the note pad. Such a connection already exists.

Action: Consider using REQUEST=NOTEPAD REQTYPE=QUERY to find out which system in the sysplex owns the connection that was created with ACCESS=UPDATE.

8 xxxx0018 Equate Symbol: IXCNOTERSNCONNECTIONBADVAL

Meaning: Program error. The value specified for CONNECTION is not a valid connection token.

Action: Ensure the correct connection token was specified.

8 xxxx0019 Equate Symbol: IXCNOTERSNCONNECTIONNOTEXIST

Meaning: The specified CONNECTION does not exist.

In the specific case of REQUEST=CONNECTION REQTYPE=CREATE, the connection was created but then deleted before the service routine could return to the caller. You might see this situation, for example, if the entity indicated by TERMSCOPE terminated while the connection was being created. You might also see this result if the work unit that requested the create fails to thrive. XCF deletes the connection if the requesting work unit appears to be unresponsive. Increasing the TIMEOUT can help overcome cases where the dynamics of the system are such that the requesting work unit does not get enough system resources to make timely progress.

Action: As needed, establish a new connection and retry the request.

8 xxxx001B Equate Symbol: IXCNOTERSNCONNECTIONBADTERM

Meaning: Program error. The TERMSCOPE specification is not valid.

A program running in SRB mode must either specify TERMSCOPE=HOME, TERMSCOPE=PRIMARY, or TERMSCOPE=TASK with a nonzero TTOKEN. When a program specifies TERMSCOPE=TASK, the task indicated by the TTOKEN keyword must be a task in either the home address space or the primary address space of the caller. When a program running in problem state with a PKM allowing key 8-15 specifies TERMSCOPE=TASK, the relevant task must be the job step task or one of its descendents and it must be the current task or one of its ancestors.

Action: Verify that the TERMSCOPE meets the requirements for the keyword.

8 xxxx001C Equate Symbol: IXCNOTERSNCONNECTIONBADPAUSE

Meaning: Program error.

For REQTYPE=PAUSE, a work unit is already paused for the indicated connection. At most one work unit can be paused for a given connection.

Action: As an alternative to using the PAUSE request, the connector can simply retry a request after allowing some time for the condition to clear.

8 xxxx001D Equate Symbol: IXCNOTERSNCONNECTIONBADUSER

Meaning: Program error. The specified CONNECTION token is not valid for use by the caller.

When processing notes (REQUEST=NOTE or REQUEST=NOTES), the requester must satisfy at least one of the following conditions:
  • Requester is the connector
  • Home is connector address space and the requester has SAF authorization appropriate for the REQTYPE
  • Running in supervisor state or with a PKM allowing key 0-7 and either:
    • Running as an address space resource manager, or
    • The creator of the connection specified USAGE=SERVER and primary is the connector address space, or
    • The creator of the connection specified USAGE=CLIENT
When deleting a connection (REQUEST=CONNECTION REQTYPE=DELETE), the requester must satisfy at least one of the following conditions:
  • Requester is the connector
  • Home is connector address space and the requester has SAF authorization appropriate for the ACCESS specified by the creator of the connection
  • Running in supervisor state or with a PKM allowing key 0-7 and either:
    • The creator of the connection specified USAGE=SERVER and primary is the connector address space, or
    • The creator of the connection specified USAGE=CLIENT
When pausing or resuming a connection (REQUEST=CONNECTION with REQTYPE=PAUSE or REQTYPE=RESUME), the requester must satisfy at least one of the following conditions:
  • Requester is the connector
  • Home is the connector address space
  • Primary is the connector address space
  • Running in supervisor state or with a PKM allowing key 0-7

Action: Verify that the caller is a valid user of the connection.

8 xxxx001E Equate Symbol: IXCNOTERSNCONNECTIONBADACCESS

Meaning: Program error. The specified CONNECTION token is not valid for use with the specified request.

If the connection was created with ACCESS=READ, one cannot use the token to create, write, replace, or delete notes.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSACCESS.

Action: Verify that the connection token has the right type of access for the request.

8 xxxx001F Equate Symbol: IXCNOTERSNCONNECTIONBADAUTH

Meaning: Program error.

When creating a connection with USAGE=SERVER or USAGE=CLIENT, the program was not running in supervisor state or with a PKM allowing key 0-7.

For any other request, the specified connection was created when SAF was not available or when there was no IXCNOTE.owner.application resource defined for the note pad in the FACILITY class. It can only be used by programs running in supervisor state or with a PKM allowing key 0-7.

Action: Verify that a proper SAF profile was set up for the note pad resources, and that the caller has the proper authorization to issue the request.

8 xxxx0020 Equate Symbol: IXCNOTERSNDESCBADSTG

Meaning: Program error. The storage identified by the DESCRIPTION keyword is not accessible. It must be both addressable and accessible using the PSW key of the caller.

Action: Take one or more of the following actions:
  • Ensure that the correct storage area was used.
  • If your program is running in AR mode, ensure that:
    • The ALET for the storage area is correct.
    • You specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the storage area was not inadvertently freed by your program.
8 xxxx0021 Equate Symbol: IXCNOTERSNDESCBADALET

Meaning: Program error. The ALET that qualifies the address of the storage area indicated by the DESCRIPTION keyword is neither zero, nor a valid entry on the Dispatchable Unit Access List (DU-AL) of the caller, nor a valid entry for a common area data space.

Action: Take one or more of the following actions:
  • If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the ALET for the storage area is correct.
8 xxxx0022 Equate Symbol: IXCNOTERSNDESCBADVAL

Meaning: Program error. The storage identified by the DESCRIPTION keyword does not contain a valid description. Descriptions can contain any alphanumeric (A-Z, a-z, 0-9), national (@, #, $), or special (underscore or blank) character. Leading blanks and all blank descriptors are not permitted.

Action: Verify that the DESCRIPTION meets the requirements of the keyword.

8 xxxx0023 Equate Symbol: IXCNOTERSNINFOBADSTG

Meaning: Program error. The storage identified by the INFO keyword is not accessible. It must be both addressable and accessible using the PSW key of the caller.

Action: Take one or more of the following actions:
  • Ensure that the correct storage area was used.
  • If your program is running in AR mode, ensure that:
    • The ALET for the storage area is correct.
    • You specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the storage area was not inadvertently freed by your program.
8 xxxx0024 Equate Symbol: IXCNOTERSNINFOBADALET

Meaning: Program error. The ALET that qualifies the address of the storage area indicated by the INFO keyword is neither zero, nor a valid entry on the Dispatchable Unit Access List (DU-AL) of the caller, nor a valid entry for a common area data space.

Action: Take one or more of the following actions:
  • If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the ALET for the storage area is correct.
8 xxxx0025 Equate Symbol: IXCNOTERSNCRITERIABADSTG

Meaning: Program error. The storage identified by the CRITERIA keyword is not accessible. It must be both addressable and accessible using the PSW key of the caller.

In the case of a delete request, zero or more notes might have been deleted before the problem was detected.

If an answer area was provided, the field AA_DETAILS provides additional information to identify the problem. The data is mapped by IXCYNOTE_TDETAILSCRITERIA.

Action: Take one or more of the following actions:
  • Ensure that the correct storage area was used.
  • If your program is running in AR mode, ensure that:
    • The ALET for the storage area is correct.
    • You specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the storage area was not inadvertently freed by your program.
8 xxxx0026 Equate Symbol: IXCNOTERSNCRITERIABADALET

Meaning: Program error. The ALET that qualifies the address of the storage area indicated by the CRITERIA keyword is neither zero, nor a valid entry on the Dispatchable Unit Access List (DU-AL) of the caller, nor a valid entry for a common area data space.

Action: Take one or more of the following actions:
  • If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the ALET for the storage area is correct.
8 xxxx0027 Equate Symbol: IXCNOTERSNCRITERIABADVAL

Meaning: Program error. The specified CRITERIA do not contain valid selection criteria.

In the case of a delete request, zero or more notes might have been deleted before the problem was detected.

If an answer area was provided, the field AA_DETAILS provides additional information to identify the problem. The data is mapped by IXCYNOTE_TDETAILSCRITERIA.

Action: Verify that the CRITERIA meets the requirements of the keyword.

8 xxxx0029 Equate Symbol: IXCNOTERSNBUFFERBADSTGNP

Meaning: Program error. The storage identified by the BUFFER keyword is not accessible. It must be both addressable and accessible using the PSW key of the caller.

The note pad was not altered. XCF might have altered the content of the storage containing the buffer and the answer area.

Action: Take one or more of the following actions:
  • Ensure that the correct storage area was used.
  • If your program is running in AR mode, ensure that:
    • The ALET for the storage area is correct.
    • You specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the storage area was not inadvertently freed by your program.
8 xxxx002A Equate Symbol: IXCNOTERSNBUFFERBADALET

Meaning: Program error. The ALET that qualifies the address of the storage area indicated by the BUFFER keyword is neither zero, nor a valid entry on the Dispatchable Unit Access List (DU-AL) of the caller, nor a valid entry for a common area data space.

Action: Take one or more of the following actions:
  • If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the ALET for the storage area is correct.
8 xxxx002B Equate Symbol: IXCNOTERSNBUFLENBADVAL

Meaning: Program error. The value specified by the BUFLEN keyword is not valid. BUFLEN must be a multiple of 1024. If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSBUFLEN.

For REQUEST=NOTE with REQTYPE of READ or DELETE, BUFLEN must be greater than or equal to the size of the designated note. For REQUEST=NOTE with REQTYPE of CREATE, WRITE, or REPLACE, BUFLEN must be less than or equal to the size of the largest note supported by the note pad.

When reading multiple notes with REQUEST=NOTES REQTYPE=READ, BUFLEN must be greater than or equal to the length in bytes of the largest note, or at least the first note, selected.

Action: Verify that the BUFLEN meets the requirements of the keyword.

8 xxxx002C Equate Symbol: IXCNOTERSNBUFFERBADSTG

Meaning: Program error. The storage identified by the BUFFER keyword is not accessible. It must be both addressable and accessible using the PSW key of the caller.

The error occurred while trying to store note data in the buffer. The request might or might not have completed successfully. In the particular case of a delete note request (IXCNOTE REQUEST=NOTE REQTYPE=DELETE), the note was successfully deleted.

Action:
  • Verify that the correct buffer storage area was specified, and the storage area was not inadvertently freed.
  • As needed, verify whether the request had been processed using REQTYPE=READ.
  • Take an appropriate recovery action.
8 xxxx002E Equate Symbol: IXCNOTERSNRESUMETOKENBADVAL

Meaning: Program error. The value specified by the RESUMETOKEN keyword is not valid. The value must either be zero or a token that was returned by a previous IXCNOTE request.

Action: Take one or more of the following actions:
  • Ensure that the correct resume token was specified.
  • Ensure that the parameter list was not inadvertently overlaid and that it was correctly specified.
8 xxxx0030 Equate Symbol: IXCNOTERSNANSAREAREQUIRED

Meaning: Program error. An answer area is required for the particular IXCNOTE request that was issued.

Action: Reissue the request with a valid answer area.

8 xxxx0031 Equate Symbol: IXCNOTERSNANSAREABADSTG

Meaning: Program error. The storage identified by the ANSAREA keyword is not accessible. It must be both addressable and accessible using the PSW key of the caller.

The error occurred while trying to store output data after the IXCNOTE request had been processed. The request might or might not have completed successfully. In the specific case of REQUEST=CONNECTION REQTYPE=CREATE, the connection that was created, if any, has been deleted by XCF.

Action:
  • Verify that the correct storage area was specified, and the storage area was not inadvertently freed.
  • As needed, verify whether the request had been processed.
  • Take an appropriate recovery action.
8 xxxx0032 Equate Symbol: IXCNOTERSNANSAREABADALET

Meaning: Program error. The ALET that qualifies the address of the storage area indicated by the ANSAREA keyword is neither zero, nor a valid entry on the Dispatchable Unit Access List (DU-AL) of the caller, nor a valid entry for a common area data space.

Action: Take one or more of the following actions:
  • If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the ALET for the storage area is correct.
8 xxxx0033 Equate Symbol: IXCNOTERSNANSLENBADVAL

Meaning: Program error. The value specified by the ANSLEN keyword is not valid. The length of the answer area must be at least as long as the number of bytes in the answer area header.

Action: Obtain storage for the answer area that is at least as long as the number of bytes in the answer area header and reissue the request.

8 xxxx0034 Equate Symbol: IXCNOTERSNANSLENMORE

Meaning: The request was not processed because the ANSAREA is too small. The ANSAREA is large enough to hold the header (IXCYNOTE_TANSAREA) but does not have room for the requested data. The AA_ANSAREASIZENEEDED returned in the ANSAREA indicates how much storage is required in order for the ANSAREA to hold the requested data. In the case of a REQUEST=NOTES REQTYPE=READ request, AA_ANSAREASIZENEEDED will indicate the amount of space needed for the required minimum number of notes.

Action: Obtain storage for the answer area that is at least as large as the indicated size and reissue the request.

8 xxxx0035 Equate Symbol: IXCNOTERSNANSAREABADSTGNP

Meaning: Program error. The storage identified by the ANSAREA keyword is not accessible. It must be both addressable and accessible using the PSW key of the caller.

The note pad was not altered. XCF might have altered the content of the storage containing the answer area, and as applicable, the buffer area.

Action: Take one or more of the following actions:
  • Ensure that the correct storage area was used.
  • If your program is running in AR mode, ensure that:
    • The ALET for the storage area is correct.
    • You specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the storage area was not inadvertently freed by your program.
8 xxxx0037 Equate Symbol: IXCNOTERSN#NOTESEXCEEDED

Meaning: The note request cannot be processed because the note pad already contains the maximum number of notes.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSCONSTRAINED.

Action: Try the request again after deleting some notes.

8 xxxx0038 Equate Symbol: IXCNOTERSN#NOTESBADVAL

Meaning: Program error. The value specified by the #NOTES keyword is not valid. It must be a number greater than or equal to one.

Action: Verify that the #NOTES meets the requirements of the keyword.

8 xxxx0040 Equate Symbol: IXCNOTERSNNOTENOTEXIST

Meaning: The specified note does not exist.

Action: Verify that the input note name was validly specified.

8 xxxx0041 Equate Symbol: IXCNOTERSNNOTEEXISTS

Meaning: An attempt to create a new note (REQUEST=NOTE REQTYPE=CREATE) is rejected because the named note already exists.

As applicable, the current tag value of the note was stored in the TAG variable. As applicable, the current instance number for the note was stored in the INSTANCE# variable.

Action: Verify that the input note name was unique in the note pad.

8 xxxx0042 Equate Symbol: IXCNOTERSNNOTEBADINSTANCE#

Meaning: The specified note was not processed due to an instance number mismatch (INSTANCE#). The current instance number of the note was stored in the INSTANCE# variable. As applicable, the tag value of the note was stored in the TAG variable.

Action: As needed, retry the request with the updated INSTANCE#.

8 xxxx0043 Equate Symbol: IXCNOTERSNNOTEBADTAGGING

Meaning: Program error. The TAGGING specification does not match the TAGGING specified by the creator of the note pad. If TAGGING=XCF was specified by the creator of the note pad, the connector must also specify TAGGING=XCF when processing notes. Similarly, if TAGGING=USER was specified by the creator of the note pad, the connector must also specify TAGGING=USER.

Action: Reissue the request with a suitable tagging specification.

8 xxxx0044 Equate Symbol: IXCNOTERSNNOTELOWTAG

Meaning: Program error. The specified tag value was less than the current tag value of the note. The current tag value of the note was stored in the TAG variable. As applicable, the current instance number of the note was stored in the INSTANCE# variable.

When the maximum user assigned tag values are being tracked for the note pad (the creator of the note pad specified TAGGING=USER and either TRACKTAG=CURRENT or TRACKTAG=LIFETIME), the tag value to be assigned to an existing note must be greater than or equal to the current tag value of the note. The write, replace, or delete request was rejected because the new tag value (TAG) specified for the note was not greater than or equal to the current tag value of the note.

Action: As appropriate, reissue the request with a tag value that is greater than the current tag value of the note.

8 xxxx0045 Equate Symbol: IXCNOTERSNNOTENOINSTANCE#

Meaning: Program error. The creator of the note pad indicated that an instance number comparison must be performed (INSTCOMP=REQUIRED) when invoking IXCNOTE REQUEST=NOTE to replace, write, or delete a note. The specified note was not processed because the required instance number comparison value was not provided. Either INSTANCE#=IGNORE was specified, or the value of the INSTANCE# variable was zero.

Action: As appropriate, obtain the current instance number of the relevant note and try the request again, specifying the nonzero instance number for comparison. The current instance number of a note can be obtained using an IXCNOTE REQUEST=NOTE REQTYPE=READ request with a valid answer area specified.

8 xxxx00A4 Equate Symbol: IXCNOTERSNR0CONFLICT

Meaning: Program error. The request data in the parameter list is not consistent with the request data in register 0 on entry to the IXCNOTE service routine. The parameter list or the register contents were corrupted before the service routine received control.

Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of z/OS on which your program is running.

8 xxxx0128 Equate Symbol: IXCNOTERSNTASKTERM

Meaning: Program error. The specified request is not valid when called from a task that is terminating. Furthermore, when creating a connection to a note pad, TERMSCOPE cannot be assigned to a task that is terminating.

Action: As appropriate, reissue the request from a task that is not terminating. If applicable, verify that the TERMSCOPE meets the requirements of the keyword.

8 xxxx0129 Equate Symbol: IXCNOTERSNSPACETERM

Meaning: Program error. The specified request is not valid when called from an address space that is terminating. Furthermore, when creating a connection to a note pad, TERMSCOPE cannot be assigned to an address space that is terminating.

Action: As appropriate, reissue the request from an address space that is not terminating. If applicable, verify that the TERMSCOPE meets the requirements of the keyword.

8 xxxx012A Equate Symbol: IXCNOTERSNRESMGR

Meaning: Program error. The specified request is not valid when called by a program running as a resource manager.

Action: As appropriate, reissue the request from a program that is not running as a resource manager.

8 xxxx0130 Equate Symbol: IXCNOTERSNBADSENV

Meaning: Program error. When creating a connection with USAGE=SERVER, a program running in task mode must not have a task specific security environment. That is, TCBSENV must be zero.

Action: Verify that the program has the proper security environment set up.

8 xxxx0801 Equate Symbol: IXCNOTERSNPLISTBADSTGNP

Meaning: Program error. The storage containing the parameter list is not accessible. It must be both addressable and accessible using the PSW key of the caller.

The note pad was not altered.

Action: Take one or more of the following actions:
  • Ensure that the correct storage area was used.
  • If your program is running in AR mode, ensure that:
    • The ALET for the storage area is correct.
    • You specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the storage area was not inadvertently freed by your program.
8 xxxx0802 Equate Symbol: IXCNOTERSNPLISTBADALETNP

Meaning: Program error. The parameter list ALET is not valid. The ALET that qualifies the address of the parameter list is neither zero nor a valid entry on the caller's Dispatchable Unit Access List (DU-AL), nor a valid entry for a common area data space.

The IXCNOTE request was not processed.

Action: Take one or more of the following actions:
  • If your program is running in AR mode, ensure that you specified SYSSTATE ASCENV=AR before issuing the request.
  • Ensure that the ALET for the storage area is correct.
8 xxxx0804 Equate Symbol: IXCNOTERSNNOTINSTALLEDVN

Meaning: Program error.

This reason is returned only if the program issues an IXCNOTE request while running on a system that does not have IXCNOTE support installed. Note that the down level system can reject an IXCNOTE request with a variety of failures. This particular reason applies when the down level system determines that the parameter list version number is not one that it supports.

Action: As appropriate, verify that IXCNOTE support is properly installed and configured on the system, or retry the request on a system that does have IXCNOTE support.

8 xxxx0805 Equate Symbol: IXCNOTERSNTASKTOOHIGH

Meaning: Program error. IXCNOTE cannot be used by tasks higher in the task tree than the cross memory resource owning task (the top, or first, job step task in the address space).

Action: Verify that the work unit issuing the IXCNOTE request meets the environmental restrictions.

8 xxxx0806 Equate Symbol: IXCNOTERSNNOTTASKMODE

Meaning: Program error. The specified request is only valid when called from a work unit that is running in task mode.

This reason can also be issued if the program is running in SRB mode on a system that does not have IXCNOTE support installed.

Action: Ensure that macro usage meets environmental requirements.

8 xxxx0807 Equate Symbol: IXCNOTERSNNOTENABLED

Meaning: Program error. Caller is not running enabled.

Action: Ensure that macro usage meets environmental requirements.

8 xxxx0808 Equate Symbol: IXCNOTERSNMASTERAS

Meaning: Program error. This reason is issued only if the program issues an IXCNOTE request from the MASTER address space while running on a system that does not have IXCNOTE support installed.

Action: Ensure that macro usage meets environmental requirements.

8 xxxx0809 Equate Symbol: IXCNOTERSNPRIMARYNOTHOME

Meaning: Program error. The home address space of the caller is not the same as the primary address space.

Problem state programs with a PKM allowing key 8-15 must be running with home and primary being the same address space for all REQUEST=NOTEPAD requests, and for REQUEST=CONNECTION requests with REQTYPE=CREATE.

Authorized programs must be running with home and primary being the same address space when creating a connection with USAGE=SERVER or USAGE=CLIENT.

Action: Ensure that macro usage meets environmental requirements.

8 xxxx0812 Equate Symbol: IXCNOTERSNBADSUSPENDENV

Meaning: Program error. The IXCNOTE request was issued from a SUSPEND exit routine or from an SRB routine that the system abended with a 47B system completion code. The caller cannot be suspended while running in this environment. The request cannot be processed because XCF needs to suspend the caller.

Action: Ensure that macro usage meets environmental requirements.

8 xxxx084C Equate Symbol: IXCNOTERSNNOSAFAUTH

Meaning: The caller does not have the SAF authorization needed to perform the request.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSNOSAFAUTH.

Action: Ensure that appropriate SAF profiles are set up for the note pad resources, and that the unauthorized application has the proper SAF authorization needed to perform the request.

8 xxxx0857 Equate Symbol: IXCNOTERSNHASFRR

Meaning: Program error. Caller is running with an FRR established. This reason applies only to task mode callers.

Action: Ensure that macro usage meets environmental requirements.

8 xxxx0876 Equate Symbol: IXCNOTERSNLOCKED

Meaning: Program error. Caller holds locks.

Note that for some cases, an X'073' abend might be issued instead.

Action: Ensure that macro usage meets environmental requirements.

8 xxxx08B2 Equate Symbol: IXCNOTERSNBADSERVICENUM

Meaning: Program error. The parameter list service code value is not valid. Either the parameter list was corrupted or the program is running on a system that does not have IXCNOTE support installed.

Action: Check to see if your program inadvertently overlaid the parameter list storage, and that it was assembled with the correct macro library for the release of z/OS on which your program is running.

C xxxx0C01 Equate Symbol: IXCNOTERSNQUIESCED

Meaning: The note pad is quiesced. Requests to process notes in the note pad (REQUEST=NOTE or REQUEST=NOTES) are rejected when a note pad is quiesced.

A note pad could be quiesced for a variety of reasons. For example, a note pad will be quiesced if the CF structure containing the note pad is being rebuilt. It will also be quiesced when a system loses connectivity to the coupling facility that contains the note pad.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSQUIESCED.

Action: Either invoke IXCNOTE REQUEST=CONNECTION REQTYPE=PAUSE to pause until the note pad is no longer quiesced or retry the request after allowing time for the condition to clear.

C xxxx0C02 Equate Symbol: IXCNOTERSNCONSTRAINED

Meaning: XCF is unable to honor the request due to constraints on the available number of notes.

When processing a note, XCF is unable to satisfy the request because the CF structure is full. XCF is unable to provide the number of notes requested by the creator of the note pad.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSCONSTRAINED.

Action: Try the request again after allowing time for the condition to clear.

C xxxx0C40 Equate Symbol: IXCNOTERSNNOSECPROFILE

Meaning: No security decision could be made for an unauthorized caller since there is either no security product installed on the system, or there is no IXCNOTE.owner.application resource defined for the note pad in the FACILITY class. A request to create, delete, query, or connect to a note pad is rejected since the program is running in problem state with a PKM allowing key 8-15.

Note that this problem can occur if the installation defines the necessary profile but then fails to refresh the security profile. For example, if RACF® is being used as the security product, the installation might need to issue RACLIST(REFRESH) to get the system to recognize the update to the resource profile.

Action: As appropriate, ensure that proper security profiles are set up for the note pad resources.

C xxxx0CA3 Equate Symbol: IXCNOTERSNMAXNOTEPADS

Meaning: Unable to create a new note pad. Maximum number of note pads already defined.

The maximum number of note pads is determined by the size of the structure that XCF uses to manage note pads (SYSXCF_NPCATALOG).

Action: Instruct the system programmer to increase the size of the SYSXCF_NPCATALOG structure and try the request again.

C xxxx0CA4 Equate Symbol: IXCNOTERSNNOSYSRESOURCES

Meaning: Unable to obtain the system resources needed to process the request.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSNORESOURCES.

Action: Try the request again after allowing time for the condition to clear.

C xxxx0CA5 Equate Symbol: IXCNOTERSNNOSTRRESOURCES

Meaning: Unable to create a new note pad because there was no coupling facility structure suitable for it.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSNOSTRUCTURES.

Action: Try the request again after allowing time for the condition to clear. In some cases, manual intervention might be required to resolve the problem. For example, the installation might need to update the CFRM policy to define additional structures or change the sizes of existing structures, or it might be necessary to reestablish connectivity to a coupling facility. In other cases, the typical dynamics of the system could cause existing note pads to be deleted, which in turn would allow a new note pad to be created. Review the data returned in the answer area for additional information, if an answer area was provided.

C xxxx0CA6 Equate Symbol: IXCNOTERSNMAXCONNECTIONS

Meaning: Unable to create a new connection to the requested note pad. The maximum number of connections created for the home address space have already been defined.

Action: Try the request again after allowing time for the condition to clear. If you still receive this code, try any of the following alternate solutions:
  • Submit a requirement to increase the limit of max connections, which is an internal limit imposed by XCF.
  • Rework the application to use fewer connections.
  • Obtain another address space.
C xxxx0CB0 Equate Symbol: IXCNOTERSNTIMEOUT

Meaning: The request timed out. No recovery action is required. The request can be retried if so desired.

Note: XCF will instead return status unknown (IXCNOTERSNSTATUSUNKNOWN) if you might need to perform a recovery action before the request can be retried.

Action: Try the request again.

C xxxx0CBD Equate Symbol: IXCNOTERSNSTATUSUNKNOWN

Meaning: The request failed in a way that XCF cannot determine whether it actually worked or not. This result can occur, for example, when the local system loses connectivity to the coupling facility that contains the note pad. It can also occur if the request times out (see TIMEOUT keyword for REQUEST=NOTEPAD and TIMEOUT keyword for REQUEST=CONNECTION).

When processing a note, the note might or might not have been successfully created, written, replaced, or deleted from the note pad.

When deleting a note pad, the note pad might or might not have been marked for deletion.

Action: Take an appropriate recovery action.

When processing a note, for example, you might issue a read request to determine whether the note exists in the note pad. As appropriate, you might then create, replace, or delete the note to achieve the desired result. In some cases you might not be able to issue such requests until the note pad is once again accessible (seeIXCNOTE REQUEST=CONNECTION REQTYPE=PAUSE).

When deleting a note pad, for example, you might reissue the request to try deleting the note pad again. You might need to be sensitive to the particular instance of the note pad (see ETODCREATED keyword).

C xxxx0CFE Equate Symbol: IXCNOTERSNNOTCONFIGURED

Meaning: The system is not currently configured to support note pads. For example, the current active Coupling Facility Resource Manager (CFRM) policy does not have definitions for the necessary structures. The problem could be resolved if the installation performs the necessary actions.

If an answer area was provided, the field AA_DETAILS provides additional information. The data is mapped by IXCYNOTE_TDETAILSNORESOURCES.

Action: Verify that the system has the necessary resources properly defined and configured for the note pad. Review the data returned in the answer area, if one was provided, for additional details.

C xxxx0CFF Equate Symbol: IXCNOTERSNNOSERVICE

Meaning: IXCNOTE services are not available on this system. The situation will persist for the life of the IPL.

For example, the hardware needed to process coupling facility requests is not present.

Action: If possible, reissue the request on a different system that has the IXCNOTE support installed.

10 xxxxxxxx Meaning: XCF failure. Reason codes are provided for this return code, however they are not documented. In general, XCF will have produced diagnostic reports to document the failure (such as a LOGREC entry or a dump). Any such documentation should be forwarded to IBM for analysis.

The reason code should be included in any diagnostic reports that the IXCNOTE user might choose to produce to document the impact from the exploiter perspective.

Action: Retry the request one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM support personnel.

End of change

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014