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 |
xxxx0409 |
Equate Symbol: IXLRSNCODETIMEOUT Meaning: The
request has completed prematurely because the model-dependent time-out
criteria of the coupling facility has been exceeded. The following
information has been returned in the answer area: - The number of elements returned in the BUFFER or BUFLIST area
(field CAADIRCOUNT)
- A token for restarting the request (field CAARESTOKEN or CAAEXTRESTOKEN).
Action: Reissue the request using the restart
token (RESTOKEN or CAAEXTRESTOKEN).
Be sure
to process the information returned from this request before reissuing
the request. The data returned from this request will be overwritten
if you specify the same buffer address. Continue to reissue the request
until the return code indicates that all processing has completed.
For
more information about premature request completion, see z/OS MVS Programming: Sysplex Services Guide.
|
4 |
xxxx040F |
Equate Symbol: IXLRSNCODEBUFFERFULL Meaning: The
request completed prematurely because the buffer specified by BUFFER,
or the buffers specified by BUFLIST, is full. The following information
has been returned in the answer area: - The number of elements returned in the BUFFER or BUFLIST area
(field CAADIRCOUNT)
- A token for restarting the request (field CAARESTOKEN or CAAEXTRESTOKEN)
Action: Reissue the request, or increase the
size of the buffer(s) and rerun your program. You can reissue the
request using the restart token (RESTOKEN or EXTRESTOKEN).
Be sure to process the information returned from this
request before reissuing the request. The data returned from this
request will be overwritten if you specify the same buffer address.
Continue to reissue the request until the return code indicates that
all processing has completed.
For more information about premature
request completion, see z/OS MVS Programming: Sysplex Services Guide.
|
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 |
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 |
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 |
xxxx0849 |
Equate Symbol: IXLRSNCODEBADRESTOKEN Meaning: Program
error. The restart token specified by RESTOKEN is not valid.
Action: Determine
why the restart token cannot be used to resume the request. Possible
causes are: - The specified token does not correspond to the restart token returned
in the answer area of the previous request.
- The user specified RESTOKEN when EXTRESTOKEN was required.
- The user specified EXTRESTOKEN when RESTOKEN was required.
For more information about premature request completion,
see z/OS MVS Programming: Sysplex Services Guide.
|
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. No data is returned.
Action: If
more space is available, specify a larger buffer size and reissue
the request. Consider using the BUFLIST parameter if BUFFER was specified.
|
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 and
BUFNUM.
- 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.
|
8 |
xxxx0887 |
Equate Symbol: IXLRSNCODEBADEXTRESTOKEN Meaning: Program
error. The extended restart token specified by EXTRESTOKEN is not
valid. The specified token refers to an older instance of the target
structure. A system-managed process occurred between the time a request
returned the extended restart token and the time the connector tried
to continue the request using that token.
Action:Discard
the results of the initial request and reissue the request with an
EXTRESTOKEN value of zero. For more information about restarting requests,
see z/OS MVS Programming: Sysplex Services Guide.
|
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 |
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.
|