0 |
None. |
Meaning: If you specified a MODE value of ASYNCECB,
ASYNCEXIT, or ASYNCTOKEN, the request has been successfully initiated.
The answer area (ANSAREA) fields will not contain valid information
until the asynchronous processing has completed. For any other MODE
value, the request has successfully completed. Action: - If you specified MODE=ASYNCECB, wait on the ECB you specified
in REQECB.
- If you specified MODE=ASYNCEXIT, the connection's complete exit
will be given control when the request has completed.
- If you specified MODE=ASYNCTOKEN, use REQTOKEN when calling IXLFCOMP
to determine when the request has completed.
|
4 |
xxxx0402 |
Equate Symbol: IXLRSNCODEASYNCH Meaning: The
request could not be processed synchronously. It will be processed
asynchronously. The answer area (ANSAREA) fields will not contain
valid information until the asynchronous processing has completed.
- If you specified MODE=SYNCECB, the ECB specified in REQECB will
be posted when the request has finished.
- If you specified MODE=SYNCEXIT, the connection's complete exit
will be given control when the request has finished.
- If you specified MODE=SYNCTOKEN, the REQTOKEN contains an asynchronous
request token that may be used on the IXLFCOMP macro to determine
when the request has completed.
Action: - If you specified MODE=SYNCECB, wait on the ECB you specified in
REQECB.
- If you specified MODE=SYNCEXIT, the connection's completion exit
will be given control when the request has completed.
- If you specified MODE=SYNCTOKEN, use REQTOKEN when calling IXLFCOMP
to determine when the request has completed.
|
4 |
xxxx040A |
Equate Symbol: IXLRSNCODENOREADDATA Meaning: The
request registered interest in the named data item, but either there
is no entry data in the cache structure or the read function was suppressed
on the request. Therefore, no data is returned in BUFLIST or BUFFER.
For structures allocated in a coupling facility with CFLEVEL=4 or
higher, if the structure entry contained data and adjunct and ADJAREA
was specified, then the adjunct is returned. The CAAADJAREAVALID bit
in the answer area is set to B'1' if the adjunct is returned
or B'0' if adjunct does not exist for the entry.
The
following answer area fields are filled in: - CAAADJAREAVALID
- CAAINVLCVI
- CAAINVLCVINUM
For CFLEVEL=4 and higher coupling facilities, the following
additional answer area fields are returned: - CAACHANGED
- CAACOLOCKSTATE
- CAACOLOCKVAL
- CAADATACACHED
- CAAELEMNUM
- CAAPARITY
For CFLEVEL=5 and higher coupling facilities, the following
additional answer area field is returned:
Action: No action is necessary. If this return
code and reason code are unexpected, you may want to: - Verify the NAME of the data item.
- Verify that the CONTOKEN is for the correct structure.
|
4 |
xxxx040C |
Equate Symbol: IXLRSNCODENOADJUNCTDATA Meaning: The
request specified that adjunct data was to be read, but the structure
does not support adjunct areas. No adjunct data was retrieved; however,
entry data was returned in BUFLIST or BUFFER if requested.
The
following fields are returned in the answer area: - CAACHANGED
- CAACOLOCKSTATE
- CAACOLOCKVAL
- CAAELEMNUM
- CAAINVLCVI
- CAAINVLCVINUM
- CAAPARITY
For CFLEVEL=4 and higher coupling facilities, the following
additional answer area field is returned:
For CFLEVEL=5 and higher coupling facilities, the following
additional answer area field is returned:
Action: No action is necessary. However, if you
expected this structure to have adjunct data, you may want to: - Verify the CONTOKEN is from the correct invocation of IXLCONN.
- Check the IXLCONN macro that defined the structure to be sure
adjunct data was specified.
|
4 |
xxxx040D |
Equate Symbol: IXLRSNCODEBADREADADJDATA Meaning: Program
error. The request specified that adjunct data was to be read, but
the specified storage area for adjunct data (ADJAREA) is not addressable.
The adjunct data was not retrieved; however, the entry data was returned
in BUFLIST or BUFFER, if requested.
The following fields are
returned in the answer area: - CAACHANGED
- CAACOLOCKSTATE
- CAACOLOCKVAL
- CAAELEMNUM
- CAAINVLCVI
- CAAINVLCVINUM
- CAAPARITY
For CFLEVEL=4 and higher coupling facilities, the following
additional answer area field is returned:
For CFLEVEL=5 and higher coupling facilities, the following
additional answer area field is returned:
Action: - Verify the ADJAREA address.
- ADJAREA must be addressable in the caller's primary address space
or from the caller's PASN access list.
- If you are calling IXLCACHE while disabled, ADJAREA must reside
in either page-fixed or DREF storage.
- If you are calling IXLCACHE in AR-mode and you specified the ADJAREA
address using explicit register notation, the corresponding access
register must be updated appropriately.
- If you are calling IXLCACHE in AR-mode, SYSSTATE ASCENV=AR must
be issued before the IXLCACHE macro.
Correct the address specified by ADJAREA and rerun the request
asking for adjunct data only.
|
8 |
xxxx0801 |
Equate Symbol: IXLRSNCODEBADPARMLIST Meaning: The
parameter list (mfctrl) for this request is not addressable. The answer
area (ANSAREA) fields are not valid.
Action: - Verify the parameter list address.
- The parameter list must be addressable in the caller's primary
address space or from the caller's PASN access list.
- If you are issuing this macro while disabled, the parameter list
must reside in either page-fixed or DREF storage.
- If you are issuing this macro in AR-mode and you specified the
parameter list address using explicit register notation, the corresponding
access register must be updated appropriately.
- If you are issuing this macro in AR-mode, SYSSTATE ASCENV=AR must
be issued before this macro.
|
8 |
xxxx0804 |
Equate Symbol: IXLRSNCODEBADVERSION# Meaning: The
version number in the macro parameter list is not compatible with
the level of XES currently being used. The answer area (ANSAREA) fields
are not valid.
Action: - Verify that your program did not overlay the parameter list storage.
- Verify that your program was assembled with the correct macro
library for the release of MVS™ on
which your program is running.
- Verify that your program is running on an MVS system that supports the version of the macro
you are using.
|
8 |
xxxx080A |
Equate Symbol: IXLRSNCODEBADCONTOKEN Meaning: Program
error. The specified connect token (CONTOKEN) was not valid for one
of the following reasons: - The user with the connection identifier represented by the token
has disconnected from the structure.
- The connector's task (the task that issued IXLCONN) ended.
- The specified token is not the token that was returned from IXLCONN.
- The request was issued from an address space other than the address
space in which IXLCONN was issued.
- The connect token was invalidated during rebuild.
- The connect token was invalidated by XES.
Note: The answer area (ANSAREA) fields are not valid.
Action: Verify
that the CONTOKEN value specified was valid and for the correct structure.
The numbers on the following actions correspond to the numbers above.
- Discontinue use. Perform recovery and cleanup for the structure
and check protocol for use of structure to determine why you did not
know of the disconnection.
- Discontinue use. Perform recovery and cleanup for the structure
and check protocol for use of structure to determine why you did not
know that the task ended.
- Issue IXLCONN to connect to the structure. The contoken is returned
in the CONACONTOKEN field of the answer area specified on the IXLCONN
request.
- Issue your request from the same address space the IXLCONN was
issued.
- Participate in the rebuild. When it is complete, try again.
- Discontinue use. Perform recovery and cleanup for the structure
and check protocol for use of structure.
You may want to issue IXCQUERY to get more information
about the structure.
|
8 |
xxxx0819 |
Equate Symbol: IXLRSNCODEBADVECTOROP Meaning: The
VECTORINDEX specified is not valid. Request processing was suppressed.
Action: Specify
a vector index that is within the current range of the number of vector
entries for the local vector requested for this structure. The number
of vector entries is determined by the VECTORLEN parameter specified
on the IXLCONN macro and may be changed by issuing the IXLVECTR macro.
|
8 |
xxxx0824 |
Equate Symbol: IXLRSNCODEWRONGSTRTYPE Meaning: The
connect token specified by CONTOKEN is not to a cache structure.
Action: Verify
the connect token for this cache structure.
Note: The connect
token can be found in the IXLCONN answer area. Verify the value specified
on the TYPE= parameter of the IXLCONN request for this structure.
|
8 |
xxxx0825 |
Equate Symbol: IXLRSNCODENOENTRY Meaning: Program
error. The request with ASSIGN=NO specified failed because the entry
designated by NAME is not in the cache structure.
Action: No
action is necessary. However, if this return code and reason code
are unexpected, try the following: - Verify that NAME is uncorrupted.
- Verify that CONTOKEN is for the correct structure.
You might want to issue the request with ASSIGN=YES to allocate
a directory entry for this NAME.
|
8 |
xxxx082D |
Equate Symbol: IXLRSNCODEBADSTGCLASS Meaning: Program
error. The storage class specified by STGCLASS exceeds the maximum
number of storage classes defined for the cache structure.
Action: The
number of storage classes allowed for a structure are defined on the
IXLCONN macro by the NUMSTGCLASS parameter. Correct the STGCLASS parameter
to specify a valid storage class.
|
8 |
xxxx0833 |
Equate Symbol: IXLRSNCODEBADPGBLATTR Meaning: Program
error. The storage area specified by BUFFER, or one of the buffers
in the BUFLIST list is specified as being pageable (PAGEABLE=YES)
but is not.
Action: Change the buffer area(s) to pageable
storage, or specify PAGEABLE=NO. See the PAGEABLE parameter description
for specification instructions.
|
8 |
xxxx0834 |
Equate Symbol: IXLRSNCODEBADNONPGBLATTR Meaning: Program
error. The storage area specified by BUFFER, or one of the buffers
in the BUFLIST list is specified as being nonpageable (PAGEABLE=NO)
but is either pageable or not addressable.
Action: Ensure
that: - The type of storage in the buffer area corresponds to the value
you specified on the PAGEABLE parameter. See the PAGEABLE parameter
description for specification instructions.
- The correct buffer address was used.
- The buffer area(s) were not previously freed.
- If BUFLIST was specified and your program is running in AR mode,
ensure that:
- The BUFALET specification is correct.
- You specified SYSSTATE ASCENV=AR before issuing the macro.
- If the caller is running in AR-mode and the BUFFER or BUFLIST
parameter was specified using explicit register notation, the corresponding
access register was updated appropriately.
|
8 |
xxxx0835 |
Equate Symbol: IXLRSNCODEBADDATAADDR Meaning: Program
error. The storage area specified by BUFFER, or one of the buffers
in the BUFLIST list, is not addressable.
Action: Ensure
that: - The correct buffer address was used for BUFFER or for a buffer
within the BUFLIST.
- The buffer area(s) were not previously freed.
- The buffer area(s) were allocated in a storage key that matches
the key specified using the BUFSTGKEY parameter, or, if BUFSTGKEY
is omitted, the caller's PSW key.
- If the caller is running in AR-mode and the BUFFER or BUFLIST
parameter was specified using explicit register notation, the corresponding
access register was updated appropriately.
- If the caller is running in AR-mode, SYSSTATE ASCENV=AR must be
specified before issuing this macro.
- If BUFLIST was specified and your program is running in AR mode
the BUFALET specification is correct.
|
8 |
xxxx0836 |
Equate Symbol: IXLRSNCODEBADREALADDR Meaning: Program
error. Real storage addresses were provided in a BUFLIST list, but
one of the buffers is not addressable in central storage.
Action: - Verify that BUFADDRTYPE was specified as you intended.
- Ensure that the real buffer addresses specified by BUFLIST are
valid.
|
8 |
xxxx0838 |
Equate Symbol: IXLRSNCODEBADANSAREA Meaning: Program
error. The storage area specified by ANSAREA is not addressable.
Action: - Verify the ANSAREA address.
- ANSAREA must be addressable in the caller's primary address space
or from the caller's PASN access list.
- If you are calling IXLCACHE while disabled, ANSAREA must reside
in either page-fixed or DREF storage.
- If you are calling IXLCACHE in AR-mode and you specified the ANSAREA
address using explicit register notation, the corresponding access
register must be updated appropriately.
- If you are calling IXLCACHE in AR-mode, SYSSTATE ASCENV=AR must
be issued before the IXLCACHE macro.
|
8 |
xxxx0839 |
Equate Symbol: IXLRSNCODEBADREQTOKENAREA Meaning: Program
error. The storage area specified by REQTOKEN is not addressable.
Action: Ensure
that the request token area specified by REQTOKEN is valid: - Verify the REQTOKEN address.
- If you are calling IXLCACHE while disabled, REQTOKEN must reside
in either page-fixed or DREF storage.
- If you are calling IXLCACHE in AR-mode and you specified the REQTOKEN
address using explicit register notation, the corresponding access
register must be updated appropriately.
- If you are calling IXLCACHE in AR-mode, SYSSTATE ASCENV=AR must
be issued before the IXLCACHE macro.
|
8 |
xxxx083D |
Equate Symbol: IXLRSNCODEBADANSLEN Meaning: Program
error. The length of the answer area, as specified by ANSLEN, is not
sufficient to contain answer area information. The answer area (ANSAREA)
fields do not contain valid information.
Action: Increase
the size of the answer area provided for the request, and rerun your
program. Depending on the macro version number, specify the length
of the answer area as follows: - CAALEVEL0LEN indicates the level 0 mapping of the answer area.
- CAALEVEL1LEN indicates the level 1 mapping of the answer area.
IXLCACHE macro invocations at the version 4 and higher
level require an answer area length of CAALEVEL1LEN.
|
8 |
xxxx0851 |
Equate Symbol: IXLRSNCODENOSUSPENDISABLE Meaning: Program
error. The request failed because MODE=SYNCSUSPEND was specified,
but the caller is disabled and cannot be suspended.
Action: Either
specify another MODE value or become enabled (release the CPU lock);
then reissue the request.
|
8 |
xxxx0864 |
Equate Symbol: IXLRSNCODEBADBUFSIZE Meaning:Program
Error. The size of the BUFLIST areas or BUFFER area is not large enough
to contain the data being read. The number of elements in the retrieved
entry is returned in the answer area in the field CAAELEMNUM.
Action: If
more space is available, specify a larger buffer size and reissue
the request.
|
8 |
xxxx0865 |
Equate Symbol: IXLRSNCODEBADBUFSPEC Meaning: Program
error. There is an error in the buffer specification.
Action: Check
the following: - If BUFLIST was specified, check the requirements for BUFLIST,
BUFNUM, and BUFINCRNUM.
- If BUFFER was specified, check the requirements for BUFFER and
BUFSIZE.
- Buffer pointer(s) in BUFLIST.
- Buffer boundaries.
|
8 |
xxxx0866 |
Equate Symbol: IXLRSNCODEBADBUFKEY Meaning: Program
error. The buffer storage key specified by BUFSTGKEY is incorrect
or BUFSTGKEY was not specified and the PSW key does not match the
key of the buffers.
The data cannot be stored in the specified
buffer area.
Action: Check the following: - Determine if the key of the storage being used for the buffers
is different from the PSW key.
- If BUFSTGKEY was specified, verify that the key was put in the
correct bits (see the explanation of this parameter for more information).
- If you are calling IXLCACHE in AR-mode, SYSSTATE ASCENV=AR must
be issued before the IXLCACHE macro.
|
8 |
xxxx0867 |
Equate Symbol: IXLRSNCODEBADBUFLIST Meaning: Program
error. The 128-byte storage area specified by BUFLIST is not addressable.
Action: Ensure
that: - The correct BUFLIST address was used.
- The BUFLIST area was not previously freed.
- If the caller is running in AR-mode and the BUFLIST parameter
was specified using explicit register notation, the corresponding
access register was updated appropriately.
- If the caller is disabled, then the BUFLIST must reside in either
nonpageable or disabled reference storage.
- If your program is running in AR mode, ensure that you specified
SYSSTATE ASCENV=AR before issuing the macro.
|
C |
xxxx0C06 |
Equate Symbol: IXLRSNCODENOCONN Meaning: Environmental
error. No connectivity to the cache structure exists. This
may occur due to operator commands such as VARY PATH,OFFLINE or CONFIG
CHP,OFFLINE or hardware errors such as facility or path failures.
The CONTOKEN is invalidated. The request fails.
Action: Either
disconnect from the structure (using IXLDISC) or initiate a rebuild
of the structure, if allowed (using IXLREBLD).
|
C |
xxxx0C13 |
Equate Symbol: IXLRSNCODEREQPURGED Meaning: Environmental
error. The request was purged prior to completion of the request.
Possible reasons include: - The connector failed.
- The connector disconnected.
- The requestor failed.
- The request was purged by IXLPURGE.
- Requests were purged when the connector provided an IXLEERSP response
for the Rebuild Quiesce, Rebuild Stop, or Rebuild Cleanup event.
- The connector invoked IXLREBLD REQUEST=COMPLETE.
- The secondary address space was no longer valid.
Action: None if this is expected. Otherwise,
determine why the connector failed.
|
C |
xxxx0C14 |
Equate Symbol: IXLRSNCODESTATUSUNKNOWN Meaning: Environmental
error. The IXLCACHE request has completed, but the final disposition
of the request cannot be determined. The answer area (ANSAREA) fields
do not contain valid information.
Action: Verify the
validity of your data by comparing the expected results with what
is in the coupling facility.
|
C |
xxxx0C17 |
Equate Symbol: IXLRSNCODESTRFULL Meaning: Environmental
error. Allocation of a directory entry and/or data entry was necessary,
but was unavailable or could not be reclaimed. The answer area field,
CAASTGCLFULL, contains the storage class from which the reclaiming
operation failed.
Action: - Determine if any data items may be cast-out to make room for this
item.
- Check your usage of storage classes to see if some data items
can be moved to a different storage class (preferably with a lower
priority) so some entries in the structure can be freed.
- Determine if a rebuild of the structure is necessary to make room
for more data entries/items.
|
C |
xxxx0C25 |
Equate Symbol: IXLRSNCODESTRFAILURE Meaning: Environmental
error. The cache structure failed prior to completion of the request.
Action: Attempt
to rebuild the structure using IXLREBLD, or disconnect from the structure
using IXLDISC.
|
C |
xxxx0CA0 |
Equate Symbol: IXLRSNCODEQUIESCEDSUSPENDFAIL Meaning: Environmental
error. The request is failed because the structure is quiesced for
a system-managed process and SUSPEND=FAIL is specified on the IXLCONN.
Action: None,
if this is expected.
|
C |
xxxxFFFF |
Equate Symbol: IXLRSNCODENOTAVAILABLE Meaning: Environmental
error. XES functions are not available. The coupling facility hardware
might not be present.
Action: XES may not be used when
XCF is running local mode. XES requires that the coupling facility
be installed.
|
10 |
xxxx10xx |
Equate Symbol: IXLRSNCODECOMPERROR Meaning: System
error. XES processing failure. The state of the structure and the
disposition of the request are unpredictable. The answer area (ANSAREA)
fields do not contain valid information.
Action: Save
the reason code information, and contact the IBM® support center.
|