z/OS DFSMShsm Managing Your Own Data
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Return codes from the default set

z/OS DFSMShsm Managing Your Own Data
SC23-6870-00

Table 1 lists the return codes (retcode) that belong to the default set.
Table 1. Default Set Return Codes
Retcode Meaning
0 No errors are detected.
Note: It is not considered an error when an HRECALL command finds that the data set is not cataloged to volume MIGRAT. The informational message ARC1102I will be issued and zero will be returned in register 15.
12 DFSMShsm functional failure has occurred or more than one type of error was detected as a multiple data set request was processed. DFSMShsm received the request and tried to process it, but was unsuccessful. DFSMShsm issued an error message between messages: ARC1101I and ARC1900I.

To obtain this return code, the WAIT option must be specified on the command. Otherwise, only the success or failure of communication with DFSMShsm is reported.

14 Data set error has occurred and the request was not communicated to DFSMShsm. A data set error occurs when the data set is not cataloged for a command that requires a cataloged data set or if the data set name syntax is incorrect.
16 DFSMShsm SVC path error has occurred. An error has occurred in attempting to communicate with DFSMShsm. DFSMShsm has not received the request.
18 A command syntax error was detected.
The default set of return codes is returned in register 15. The following JCL is an example of using a DFSMShsm command and testing the return code while running in a batch job:
 //LISTDS   JOB...
 //*RECOVER DATA SET
 //RECOVER EXEC PGM=IKJEFT01
 //SYSIN    DD  DUMMY
 //SYSPRINT DD  SYSOUT=A
 //SYSTSPRT DD  SYSOUT=A
 //SYSTSIN  DD  *
   HRECOVER DATA.SET.NAME REPLACE WAIT
 /*
 //*PRINT DATA SET IF RECOVERY IS SUCCESSFUL
 //PRINT  EXEC PGM=IDCAMS,COND=(0,NE)
 //SYSPRINT DD  SYSOUT=A
 //SYSIN    DD  *
   PRINT INDATASET(DATA.SET.NAME)
 /*

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014