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.
|