Return Codes

Following are the error return codes returned in register 15:

Type of Request Return Code in Hex Meaning
RESERVE 00 The request completed successfully.
  04 The request could not be satisfied because another JES3 function is using the checkpoint record access method. The ECF address is returned in register 0. The ECF mask needed is contained in the low-order byte of register 1, with the other three bytes containing zeros. The ECF mask and address may be used to wait for the access method to become available.
RELEASE 00 The request completed successfully.
  04 No previous RESERVE request was outstanding, therefore, a RELEASE could not be performed.
READ 00 The request completed successfully. Register 1 contains the address of the checkpoint record.
  04 The request could not be satisfied because another JES3 function is using the checkpoint record access method. The ECF address is returned in register 0. The ECF mask needed is contained in the low-order byte of register 1, with the other three bytes containing zeros. The ECF mask and address may be used to wait for the access method to become available.
  08 The checkpoint record name specified by the ID parameter is invalid. That is, the ID parameter specifies 0, blank, ‘CMAP’, or ‘I/OE’, or ‘ALL’ without TYPE=PURGE.
  0C No checkpoint record with the specified name could be found.
  10 The requested record could not be read in because there was not enough virtual storage.
  14 The specified checkpoint record is incorrect and cannot be read.
  18 The specified checkpoint record could not be read because of a permanent I/O error.
  1C A back-level copy of the requested record has been read because the current copy of the record is incorrect or contains a permanent I/O error. Register 1 contains the address of the back-level copy of the record.
WRITE 00 The record was written successfully to at least one checkpoint data set.
  04 The request could not be satisfied because another JES3 function is using the checkpoint record access method. The ECF address is returned in register 0. The ECF mask needed is contained in the low-order byte of register 1, with the other three bytes containing zeros. The ECF mask and address may be used to wait for the access method to become available.
  08 The checkpoint record name specified in the ID field of the record is incorrect or the record length or address is incorrect.
  0C The record could not be written to either checkpoint data set because of insufficient storage space. No previous level of the checkpoint record exists in one checkpoint data set or more.
  10 The record could not be written to either checkpoint data set because of insufficient storage space. A previous level of the record exists and was not altered.
  14 The record could not be written to either checkpoint data set because of insufficient storage space. A previous level of the record existed and has been partially destroyed.
  18 The record could not be written to either checkpoint data set because of a permanent I/O error.
  1C An error was detected when updating the track map(s) in the checkpoint data set(s). The status of the record is unpredictable.
PURGE 00 The record was successfully purged from at least one checkpoint data set.
  04 The request could not be satisfied because another JES3 function is using the checkpoint record access method. The ECF address is returned in register 0. The ECF mask needed is contained in the low-order byte of register 1, with the other three bytes containing zeros. The ECF mask and address may be used to wait for the access method to become available.
  08 The checkpoint record name specified by the ID parameter is invalid. That is, the ID parameter specifies 0, blank, ‘CMAP’, or ‘I/OE’, or ‘ALL’ without TYPE=PURGE.
  0C No checkpoint record with the specified name could be found.
  10 An error was detected when updating the track map(s) in the checkpoint data set(s). The record was purged from the in-storage track map, therefore, the record is no longer accessible. The status of the record in the checkpoint data set(s) is unpredictable.
FREE 00 The record was successfully freed.
  08 The specified checkpoint record ID, length or address is incorrect.