Control returns to the instruction following the last instruction generated by the PARTREL macro. Register 15 contains the applicable DADSM return code, as shown in Table 1.
DADSM PARTREL returns 4 bytes of diagnostic information in register 0. See Table 2 for a description of this information.
| Return |
Description |
|---|---|
| 0 (X'00') | Function successful. |
| 2 (X'02') | Unable to find extent in format-1 or format-8 DSCB. |
| 3 (X'03') | Exceeded maximum number format-3 pointers in format-9 DSCB. |
| 4 (X'04') | Unable to find extent in format-3 DSCB. |
| 8 (X'08') | Either the required SYSZTIOT or SYSDSN ENQ failed, or an unrelated DEB indicates that another DCB is open to the data set. |
| 12 (X'0C') | Invalid parameter list. |
| 16 (X'10') | One of the following conditions occurred:
|
| 20 (X'14') | DSN, or DSN pointer is invalid. |
| 24 (X'18') | Invalid UCB pointer. |
| 28 (X'1C') | Specified DSORG is not supported. |
| 32 (X'20') | No room in the VTOC. |
| 36 (X'24') | Invalid TIOT=NOENQ request; caller does not have exclusive use of SYSDSN. |
| 40 (X'28') | An error occurred while SMS was processing the request. |
| 44 (X'2C') | 'CLOSE' was the caller of partial release. The customer rejected the partial release request by passing a nonzero return code back to partial release from an exit routine, such as IGGPRE00, associated with the IGGPRE00_EXIT preprocessing dynamic exit. |
| 52 (X'34') | RTA to CCHH conversion error. |
| 60 (X'3C') | SORT EDT ERROR |
| 64 (X'40') | An error occurred during conversion from format-7 to extent descriptor table. |
| 68 (X'44') | An error occurred during conversion from format-5 to extent descriptor table. |
| 72 (X'48') | Input DSCB is not a format-5 or a format-7 DSCB. |
| 76 (X'4C') | An error occurred during conversion from extent descriptor table to format-7. |
| 80 (X'50') | An error occurred during conversion from extent descriptor table to format-5. |
| 84 (X'54') | VSAM standard format data set incorrectly specified. If the data set is VSAM, it must be extended format. |
| 88 (X'58') | VSAMTRKS address parameter must be specified when VSAMTYPE is specified. |
| 92 (X'5C') | The name of the specified VSAM data set is not a VSAM cluster data component. |
| 96 (X'60') | Catalog call to partial release failed. |
| 100 (X'64') | Request was directed to a VSAM data set defined with guaranteed space. |
| 104 (X'68') | Unexpected reason code received back from a call to catalog services. |
| 108 (X'6C') | Unable to find enough F0's to complete the PARTREL request. |
| 112 (X'70') | DAPCCHH passed is in cylinder-managed space but is not on a multi-cylinder unit boundary. |
| 116 (X'74') | The first extent of a compressed data set is not large enough for space to be released. |
| 178 (X'B2') | Refer to message IDC3009I, return code 178 for possible causes. See z/OS MVS System Messages, Vol 6 (GOS-IEA) for more information. |
Table 2 describes the conditions that are indicated by the diagnostic information that is returned in register 0. The abbreviations that are used in Table 2 are defined in Table 3.
| Byte 0 | Byte 1 | Byte 2 | Byte 3 | Description |
|---|---|---|---|---|
| DADSM Return Code | Subfunction Identifier | Subfunction Return Code | Subfunction Reason Code | |
| X'00' | X'16' | SYSCDE1 | SYSCDE2 | PARTREL ESTAE received control after function completed. |
| X'00' | X'1A' | SYSCDE1 | SYSCDE2 | PARTREL ESTAE received control after function completed. |
| X'04' | X'04' | X'00' | X'01' | Close/checkpoint called PARTREL for a PDSE. |
| X'04' | X'08' | ENQRET | X'0C' | ENQ SYSZTIOT RET=USE failed. |
| X'04' | X'09' | ENQRET | X'0E' | ENQ SYSDSN RET=USE failed. |
| X'04' | X'09' | ENQRET | X'0F' | ENQ SYSDSN RET=CHNG failed. |
| X'04' | X'1B' | CNVTRET | X'17' | DS1LSTAR not in DEB. |
| X'04' | X'27' | X'00' | X'0B' | VTOC full. |
| X'04' | X'28' | X'00' | X'14' | DSN invalid; VTOC index data set. |
| X'04' | X'29' | ENQRET | X'0C' | ENQ SYSZTIOT RET=USE failed. |
| X'04' | X'2A' | ENQRET | X'0D' | ENQ SYSZTIOT RET=CHNG failed. |
| X'04' | X'2B' | ENQRET | X'0E' | ENQ SYSDSN RET=USE failed. |
| X'04' | X'2C' | ENQRET | X'0F' | ENQ SYSDSN RET=CHNG failed. |
| X'04' | X'2E' | X'00' | X'13' | DSORG not supported. |
| X'04' | X'2E' | X'00' | X'15' | DSN invalid; data set not found. |
| X'04' | X'2E' | X'00' | X'16' | DSN invalid; not format-1 DSCB. |
| X'04' | X'30' | X'00' | X'11' | DS1LSTAR not found in format-1 extents. |
| X'04' | X'30' | X'00' | X'12' | DS1LSTAR not found in format-1/format-3 extents. |
| X'04' | X'32' | X'00' | X'11' | DS1LSTAR not found in format-1 extents. |
| X'04' | X'32' | X'00' | X'12' | DS1LSTAR not found in format-1/format-3 extents. |
| X'04' | X'33' | X'00' | X'10' | Duplicate DEB found. |
| X'04' | X'34' | CNVTRET | X'17' | DS1LSTAR not in DEB. |
| X'04' | X'36' | X'00' | X'11' | DS1LSTAR not found in format-1 extents. |
| X'04' | X'37' | X'00' | X'11' | DS1LSTAR not found in format-1 extents. |
| X'04' | X'37' | X'00' | X'1D' | No space released for compressed data set. |
| X'04' | X'3F' | X'00' | X'12' | DS1LSTAR not found in format-1/format-3 extents. |
| X'04' | X'41' | PRERET | X'1A' | Preprocessing installation exit reject. |
| X'04' | X'43' | PRERET | X'1A' | Preprocessing installation exit reject. |
| X'04' | X'4D' | ERASRET | X'1B' | Error occurred while erasing released extents. |
| X'04' | X'53' | X'00' | X'0B' | VTOC full. |
| X'08' | X'02' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while reading format-1 DSCB (key and data). |
| X'08' | X'03' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while reading format-1 DSCB (using key). |
| X'08' | X'0A' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while reading format-3 DSCB. |
| X'08' | X'0C' | CDMRET | CDMREAS | SMS error occurred during connect directory to PDSE. |
| X'08' | X'0D' | CDMRET | CDMRSN | SMS error occurred during connect directory to an HFS data set. |
| X'08' | X'0E' | CDMRET | CDMREAS | SMS error occurred during disconnect directory from PDSE. |
| X'08' | X'16' | SYSCDE1 | SYSCDE2 | PARTREL ESTAE received control before function completed. |
| X'08' | X'1A' | SYSCDE1 | SYSCDE2 | PARTREL ESTAE received control before function completed. |
| X'08' | X'1C' | SNS0, |
SNS1, |
I/O error occurred while reading first format-1 DSCB (key and data). |
| X'08' | X'21' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while reading format-4 DSCB with space maps. |
| X'08' | X'22' | CVRET | CVSTAT | Invoke CVAFVRF; error occurred while reading VRF data. |
| X'08' | X'23' | X'00' | X'0A' | Error occurred while attempting VTOC recovery. |
| X'08' | X'25' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while reading format-4 DSCB without space maps. |
| X'08' | X'27' | SNS0, |
SNS1, |
I/O error occurred while reading format-4 DSCB. |
| X'08' | X'28' | SNS0, |
SNS1, |
I/O error occurred while writing format-4 DSCB with DIRF bit set. |
| X'08' | X'2E' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while reading format-1 DSCB (using key). |
| X'08' | X'30' | SNS0, |
SNS1, |
I/O error occurred while reading format-3 DSCB. |
| X'08' | X'30' | X'03' | X'04' | CCHH to RTA conversion routine encountered a zero (0) input value, this is invalid. |
| X'08' | X'30' | X'03' | X'18' | CCHH to RTA conversion routine encountered an END CCHH value that was less than the START CCHH value. |
| X'08' | X'30' | X'03' | X'1C' | CCHH to RTA conversion routine encountered a START 'CC' value that was not less than the maximum number of cylinders on the volume. |
| X'08' | X'30' | X'03' | X'20' | CCHH to RTA conversion routine encountered a END 'CC' value that was not less than the maximum number of cylinders on the volume. |
| X'08' | X'30' | X'03' | X'24' | CCHH to RTA conversion routine encountered a START 'HH' value that was not less than the maximum number of tracks per cylinder. |
| X'08' | X'30' | X'03' | X'28' | CCHH to RTA conversion routine encountered an END 'HH' value that was not less than the maximum number of tracks per cylinder. |
| X'08' | X'30' | X'04' | X'04' | RTA to CCHH conversion routine encountered a zero (0) input value, this is invalid. |
| X'08' | X'30' | X'04' | X'14' | RTA to CCHH conversion routine encountered an input RTA that could not be converted into a 2-byte field. (RTA is too large). |
| X'08' | X'30' | X'04' | X'10' | RTA to CCHH conversion routine encountered an end RTA value that was to higher than the start RTA value. |
| X'08' | X'30' | X'04' | X'1C' | RTA to CCHH conversion routine converted a start 'CC' that was not smaller than the maximum number of cylinders on the volume. |
| X'08' | X'30' | X'04' | X'20' | RTA to CCHH conversion routine converted an end 'CC' that was not smaller than the maximum number of cylinders on the volume. |
| X'08' | X'31' | X'03' | X'04' | CCHH to RTA conversion routine encountered a zero (0) input value, this is invalid. |
| X'08' | X'31' | X'03' | X'18' | CCHH to RTA conversion routine encountered an END CCHH that was less than the START CCHH value. |
| X'08' | X'31' | X'03' | X'1C' | CCHH to RTA conversion routine encountered a START 'CC' value that was not less than the maximum number of cylinders on the volume. |
| X'08' | X'31' | X'03' | X'20' | CCHH to RTA conversion routine encountered a END 'CC' value that was not less than the maximum number of cylinders on the volume. |
| X'08' | X'31' | X'03' | X'24' | CCHH to RTA conversion routine encountered a START 'HH' value that was not less than the maximum number of tracks per cylinder. |
| X'08' | X'31' | X'03' | X'28' | CCHH to RTA conversion routine encountered an END 'HH' value that was not less than the maximum number of tracks per cylinder. |
| X'08' | X'31' | X'04' | X'04' | RTA to CCHH conversion routine encountered a zero (0) input value, this is invalid. |
| X'08' | X'31' | X'04' | X'14' | RTA to CCHH conversion routine encountered an input RTA that could not be converted into a 2-byte field. (RTA is too large). |
| X'08' | X'31' | X'04' | X'10' | RTA to CCHH conversion routine encountered an end RTA value that was higher than the start RTA value. |
| X'08' | X'31' | X'04' | X'1C' | RTA to CCHH conversion routine converted a start 'CC' that was not smaller than the maximum number of cylinders on the volume. |
| X'08' | X'31' | X'04' | X'20' | RTA to CCHH conversion routine converted an end 'CC' that was not smaller than the maximum number of cylinders on the volume. |
| X'08' | X'3B' | SNS0, |
SNS1, |
I/O error occurred while reading first format-3 DSCB. |
| X'08' | X'3D' | SNS0, |
SNS1, |
I/O error occurred while reading second through tenth format-3 DSCB. |
| X'08' | X'3F' | X'03' | X'04' | CCHH to RTA conversion routine encountered a zero (0) input value, this is invalid. |
| X'08' | X'3F' | X'03' | X'18' | CCHH to RTA conversion routine encountered an END CCHH value that was less than the START CCHH value. |
| X'08' | X'3F' | X'03' | X'1C' | CCHH to RTA conversion routine encountered a START 'CC' value that was not less than the maximum number of cylinders on the volume. |
| X'08' | X'3F' | X'03' | X'20' | CCHH to RTA conversion routine encountered an END 'CC' value that was not less than the maximum number of cylinders on the volume. |
| X'08' | X'3F' | X'03' | X'24' | CCHH to RTA conversion routine encountered a START 'HH' value that was not less than the maximum number of tracks per cylinder. |
| X'08' | X'3F' | X'03' | X'28' | CCHH to RTA conversion routine encountered an END 'HH' value that was not less than the maximum number of tracks per cylinder. |
| X'08' | X'41' | X'06' | X'01' | Converting from 4-byte EDT table to a 2-byte EDT table. Invalid eye-catcher detected. |
| X'08' | X'41' | X'06' | X'02' | Converting from 4-byte EDT table to a 2-byte EDT table. Invalid control block 'level.' |
| X'08' | X'41' | X'06' | X'03' | Converting from 4-byte EDT table to a 2-byte EDT table. 2-byte EDT is not large enough to contain all entries indicated in the 4-byte EDT. |
| X'08' | X'41' | X'06' | X'04' | Converting from 4-byte EDT table to a 2-byte EDT table. Input RTA is too large to fit into a 2-byte field. |
| X'08' | X'42' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while reading a format-3 DSCB before releasing its space. |
| X'08' | X'43' | X'06' | X'01' | Converting from 4-byte EDT table to a 2-byte EDT table. Invalid eye-catcher detected. |
| X'08' | X'43' | X'06' | X'02' | Converting from 4-byte EDT table to a 2-byte EDT table. Invalid control block 'level.' |
| X'08' | X'43' | X'06' | X'03' | Converting from 4-byte EDT table to a 2-byte EDT table. 2-byte EDT is not large enough to contain all entries indicated in the 4-byte EDT. |
| X'08' | X'43' | X'06' | X'04' | Converting from 4-byte EDT table to a 2-byte EDT table. Input RTA is too large to fit into a 2-byte field. |
| X'08' | X'44' | CVRET | CVSTAT | Invoke CVAFVRF; error occurred while recording VRF space used. |
| X'08' | X'45' | CVRET | CVSTAT | Invoke CVAFDSM; error occurred while updating VMDS with released format-3 DSCB. |
| X'08' | X'46' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while writing updated format-3 DSCB. |
| X'08' | X'47' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while zeroing released format-3 DSCB. |
| X'08' | X'49' | CVRET | CVSTAT | Invoke CVAFVRF; error occurred while recording VRF space used. |
| X'08' | X'4A' | CVRET | CVSTAT | Invoke CVAFDSM; error occurred while releasing volume space from VPSM. |
| X'08' | X'4A' | CVRET | CVSTAT | Invoke CVAFDSM; error occurred while writing VPSM to release space. |
| X'08' | X'4B' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while writing updated format-1 DSCB. |
| X'08' | X'4E' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while reading format-4 DSCB and space maps. |
| X'08' | X'50' | X'00' | X'19' | Error occurred while attempting VTOC recovery. |
| X'08' | X'53' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while reading format-4 DSCB. |
| X'08' | X'54' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while writing format-4 DSCB to set DIRF bit. |
| X'08' | X'55' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while writing VIXM. |
| X'08' | X'57' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while writing format-1 DSCB. |
| X'08' | X'58' | X'07' | X'01' | Sorting Extent Descriptor table. Eye-catcher is invalid. |
| X'08' | X'58' | X'07' | X'02' | Sorting Extent Descriptor table. Invalid control block level number. |
| X'08' | X'59' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while reading format-5 DSCB. |
| X'08' | X'5B' | X'00' | X'32' | Attempting to convert an F5/F7 DSCB into an EDT. Input DSCB is NOT an F5 or F7. |
| X'08' | X'5B' | X'0A' | X'01' | Attempting to convert an F7 DSCB into an EDT. Space allocated for the EDT is too small. |
| X'08' | X'5B' | X'08' | X'01' | Attempting to convert an F5 DSCB into an EDT. Space allocated for the EDT is too small. |
| X'08' | X'5D' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while reading format-5 DSCB. |
| X'08' | X'5D' | X'00' | X'32' | Attempting to convert an F5/F7 DSCB into an EDT. Input DSCB is not an F5 or F7. |
| X'08' | X'5D' | X'0A' | X'01' | Attempting to convert an F7 DSCB into an EDT. Space allocated for the EDT is too small. |
| X'08' | X'5D' | X'08' | X'01' | Attempting to convert an F5 DSCB into an EDT. Space allocated for the EDT is too small. |
| X'08' | X'5E' | X'00' | X'3C' | Attempting to convert an F5/F7 DSCB into an EDT. Input DSCB is not an F5 or F7. |
| X'08' | X'5E' | X'0B' | X'01' | Attempting to convert an EDT into a F7 DSCB. EDT eye-catcher is invalid. |
| X'08' | X'5E' | X'0B' | X'02' | Attempting to convert an EDT into a F7 DSCB. EDT control block 'level' is invalid. |
| X'08' | X'5E' | X'09' | X'01' | Attempting to convert an EDT into a F5 DSCB. EDT eye-catcher is invalid. |
| X'08' | X'5E' | X'09' | X'02' | Attempting to convert an EDT into a F5 DSCB. EDT control block 'level' is invalid. |
| X'08' | X'5E' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while writing format-5 DSCB. |
| X'08' | X'60' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while reading format-0 DSCB. |
| X'08' | X'62' | SNS0, ECBSTAT | SNS1, ECBSTAT | I/O error occurred while writing format-4 DSCB to clear the DIRF bit. |
| X'08' | X'63' | CVRET | CVSTAT | Invoke CVAFVRF; error occurred while clearing VRF data. |
| X'08' | X'64' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while releasing VTOC space maps. |
| X'08' | X'65' | CVRET | CVSTAT | Invoke CVAFDIR; error occurred while writing format-4 DSCB to disable index. |
| X'08' | X'6B' | MSSRET | X'00' | Error occurred while relinquishing MSS extents. |
| X'0C' | X'17' | X'00' | X'05' | PARTREL back-end parameter list contains no caller flag. |
| X'0C' | X'17' | X'00' | X'06' | PARTREL back-end parameter list contains more than one caller flag. |
| X'0C' | X'17' | X'00' | X'07' | PARTREL back-end parameter list contains invalid UCB pointer. |
| X'0C' | X'17' | X'00' | X'08' | PARTREL back-end parameter list contains invalid close work area pointer. |
| X'0C' | X'17' | X'00' | X'09' | PARTREL back-end parameter list contains invalid PARTREL work area pointer. |
| X'0C' | X'72' | UCBCAPTRC | UCBCAPTRS | IOSCAPU failed when attempting to capture the UCB passed by the caller. |
| X'0C' | X'73' | UCBCAPTRC | UCBCAPTRS | IOSCAPU failed when attempting to capture the UCB returned from CATALOG. |
| X'10' | X'17' | X'00' | X'02' | PARTREL back-end parameter list contains invalid eye-catcher. |
| X'10' | X'17' | X'00' | X'03' | PARTREL back-end parameter list contains invalid version. |
| X'10' | X'17' | X'00' | X'04' | PARTREL back-end parameter list contains invalid length. |
| Abbreviation | Description |
|---|---|
| CDMRET | Return code from CDM. |
| CDMRSN | Return code from CDM. |
| CDMREAS | Return code from CDM. |
| CNVTRET | Return code from the CVTPCNVT conversion routine (TTR to CCHHR). For a description of the return code, see z/OS DFSMSdfp Advanced Services. |
| CVRET | Return code from the CVAF function. For a description of the return code, see z/OS DFSMSdfp Advanced Services. |
| CVSTAT | CVSTAT field of the CVAF parameter list. For a description of the fields, see CVSTAT field codes. |
| ECBCC | ECB completion code. For a description of the code, see z/OS DFSMS Using Data Sets. |
| ENQRET | Return code from ENQ. For a description of the return code, see z/OS MVS Programming: Assembler Services Reference ABE-HSP. |
| ERASRET | Return code from the erase function. For a description of the return code, see z/OS DFSMS Macro Instructions for Data Sets. |
| PRERET | Return code from the an exit routine, such as IGGPRE00, associated with the IGGPRE00_EXIT preprocessing dynamic exit. For a description of the return code, see z/OS DFSMS Installation Exits. |
| SNS0 | First sense byte from the IOB. For a description of the sense byte, see z/OS DFSMSdfp Advanced Services. |
| SNS1 | Second sense byte from the IOB. For a description of the sense byte, see z/OS DFSMSdfp Advanced Services. |
| SYSCDE1,2 | System completion code (low order 2 bytes). For a description of the completion code, see z/OS DFSMS Macro Instructions for Data Sets. |
| UCBCAPTRC | Return code from IOSCAPU service. |
| UCBCAPTRS | Reason code from IOSCAPU service. |