Retries on an EXEC CICS LINK command
If the external CICS® interface receives a RETRYABLE response on an EXCI call that it makes on behalf of an EXEC CICS LINK command, it automatically retries the EXEC CICS LINK command up to five times, providing more serious errors do not occur.
If the RETRYABLE response is still received after the fifth retry, the RESP field is set to LINKERR, and the reason returned on the EXCI CALL request that causes the exception is returned in the RESP2 field.
The external CICS interface retries the EXEC CICS LINK command by first closing and deallocating the pipe, then reissuing the six EXCI CALL commands. During Allocate_Pipe processing, the EXCI CALL interface calls the user-replaceable module, DFHXCURM, to give you the opportunity to change the APPLID of the CICS system to which the request has been sent. See The EXCI user-replaceable module for details of DFHXCURM.
Table 1 lists all the exception conditions and RESP2 values that are specific to the EXEC CICS LINK command for the external CICS interface.
Condition (RESP) | RESP2 | Meaning |
---|---|---|
LENGERR (22) | 22 | COMMAREA length greater than 32763 bytes specified |
23 | COMMAREA specified but no LENGTH parameter specified | |
WARNING (4) | 401 | Invalid call_type parameter value specified on Close_Pipe or Deallocate_Pipe call |
402 | Invalid version_number parameter specified on Close_Pipe or Deallocate_Pipe call | |
404 | Invalid user_token specified on Close_Pipe or Deallocate_Pipe call | |
405 | A Deallocate_Pipe call has been issued against a pipe that is not yet closed | |
418 | An invalid pipe token has been issued on a Close_Pipe or Deallocate_Pipe call | |
421 | A Close_Pipe or Deallocate_Pipe command has been issued under an IRB | |
610 | There has been a CICS IRP logoff failure on a Deallocate_Pipe call | |
611 | There has been a CICS IRC disconnect failure on a Close_Pipe call | |
622 | There has been an MVS™ ESTAE setup failure on a Close_Pipe or Deallocate_Pipe call | |
623 | A program check on a Close_Pipe or Deallocate_Pipe call has caused the ESTAE to be invoked | |
LINKERR (88) | 201 | Command has been issued on an MVS image which has had no IRC activity since the previous IPL |
202 | There are no available sessions | |
203 | CICS has not yet been brought up, or (2) has not yet opened IRC, or (3) no generic connection is installed, or (4) no specific connection is installed with the required netname. | |
204 | An EXEC CICS LINK command without the SYNCONRETURN option has been issued specifying a CICS system on a different MVS image. | |
205 | An EXEC CICS LINK command without the SYNCONRETURN option has been issued when RRS is not available | |
401 | Invalid parameter | |
402 | Invalid version number | |
403 | User name is all blanks | |
404 | Invalid address in user token | |
405 | Command has been issued against a pipe that is not closed | |
406 | Command has been issued against a pipe that is not open | |
407 | Userid of all blanks has been passed | |
408 | Error in UOWID parameter | |
LINKERR (88) | 409 | Transid consisting of all blanks or zero has been passed |
410 | Load of message module, DFHMEBMX, failed | |
411 | Load of message module, DFHMET4E, failed | |
412 | Load of DFHXCURM failed | |
413 | Load of DFHXCTRA failed | |
414 | If run as a CICS-to-CICS linked-to program, this server program would have resulted in an error with an appropriate message sent to the terminal. Running the program as an EXCI server program returns the message addressed by the MSGPTR field of the RETCODE area. | |
415 | Target connection is an MRO connection, not an EXCI connection | |
416 | Command has been issued against a CICS region running under a release of CICS earlier than CICS for MVS/ESA 4.1 | |
417 | Command has been issued against a pipe in the MUST CLOSE state. Further EXCI EXEC CICS LINK commands will have unpredictable results and are, therefore, not permitted | |
418 | Pipe_token does not address an XCPIPE control block, or there is a mismatch between user_token and pipe_token | |
419 | CICS runs, or did run, under the TCB that this command is attempting to use. This is not permitted and the command fails | |
420 | Load of DFHXCOPT failed | |
421 | The command has been issued under an MVS IRB, which is not permitted | |
422 | The server has abended | |
423 | Surrogate user check failed | |
424 | An EXEC CICS LINK command without the SYNCONRETURN option has been issued on a system that does not support RRMS | |
425 | A DPL request omitted the SYNCONRETURN option, but specified a value of UOWID. |
|
601 | A GETMAIN of working storage failed. This error leads to user abend 408 | |
602 | A GETMAIN failed. This error leads to user abend 403. | |
603 | A GETMAIN failed. This error leads to user abend 410 | |
604 | A GETMAIN failed | |
605 | A GETMAIN for the VERIFY block failed. This error leads to user abend 409. | |
606 | An SSI verify request (to obtain CICS SVC instruction) failed. This error leads to user abend 405. | |
607 | An SVC call failed. This error leads to user abend 406. | |
608 | Logon to IRP failed | |
609 | Connect to IRP failed | |
610 | Disconnect from IRP failed | |
611 | Logoff from IRP failed | |
612 | Invalid data input to transformer_1 | |
613 | Invalid data input to transformer_4 | |
LINKERR (88) | 614 | CICS has responded but has not sent any data |
615 | CICS cannot satisfy the request | |
616 | IRP_SWITCH_PULL request (to read data sent from CICS into a larger input/output area) has failed | |
617 | A GETMAIN for a larger input/output area failed | |
619 | IRP has had a problem with the input/output area passed from the client program | |
620 | IRP has disconnected from EXCI | |
621 | A DISCONNECT command is issued in an error situation following an IRP CONNECT. The DISCONNECT has failed, indicating a serious error. | |
622 | XCPRH ESTAE setup command failed This error leads to user abend 402. | |
623 | XCPRH ESTAE invoked due to program check during the processing of this command. ESTAE attempts backout and takes a SYSMDUMP. Further requests are permitted although the pipe is now in a MUST CLOSE state. | |
624 | The DPL request has been passed to CICS but the time specified in DFHXCOPT has been exceeded. The request is canceled. | |
625 | An MVS STIMERM macro call failed | |
626 | An MVS STIMERM CANCEL request failed | |
627 | The CICS SVC is at the incorrect level. This error leads to user abend 407. | |
628 | DFHIRP is at the incorrect level. | |
629 | A response to a DPL request has been returned by CICS but the external CICS interface does not understand the response. | |
630 | An unexpected return code was received from RRMS when processing an EXEC CICS LINK command without the SYNCONRETURN option . | |
631 | An unexpected error was encountered when processing an EXEC CICS LINK command without the SYNCONRETURN option. | |
632 | A GETMAIN for DFHXCGUR's working storage failed while processing an EXEC CICS LINK command without the SYNCONRETURN option . | |
903 | AN XCEIP ESTAE setup command failed | |
904 | The server program abended with the abend code in the ABCODE field of the RETCODE area | |
905 | An XCEIP ESTAE invoked |
See Return codes for details of the various copybooks that contain full details of all response and reason codes, including equated values.