z/OS DFSMS Installation Exits
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Registers on Entry to the ADRUPSWD Exit

z/OS DFSMS Installation Exits
SC23-6850-01

Register
Contents
1
Address of the ADRUPSWD parameter list
13
Address of an 18-word save area
14
Return address
15
Address of the entry point to ADRUPSWD
Register 1 contains the address of the ADRUPSWD parameter list. You can use the ADRUPB mapping macro to map this parameter list (see Table 1). The four word parameter list includes:
First word
For a volume (fourth word, byte 2, bit 0 is on), this field is zero. For a VSAM data set not cataloged in the integrated catalog facility, or for a non-VSAM data set (fourth word, byte 2, bits 0 and 1 are off), this is a pointer to the Format 1 DSCB for the protected data set. (For the Format 1 DSCB description, see z/OS DFSMSdfp Advanced Services.) For a VSAM data set cataloged in the integrated catalog facility (fourth word, byte 2, bit 0 is off and bit 1 is on), this is a pointer to the 44-byte name of the protected VSAM cluster.
Second word
For a volume (fourth word, byte 2, bit 0 is on), or for a VSAM data set not cataloged in the integrated catalog facility, or for a non-VSAM data set (fourth word, byte 2, bits 0 and 1 are off), this field is zero. For a VSAM data set cataloged in the integrated catalog facility (fourth word, byte 2, bit 0 is off and bit 1 is on), this is a pointer to the 44-byte name of the integrated catalog facility catalog in which the protected VSAM cluster is cataloged.
Third word
Pointer to the volume serial number.
Fourth word
Flags are set as follows:
Byte 0  
Bit
Meaning
0
End of the parameter list. This is always set to 1.
1
Set to 1 if read access is required on the volume. Set to 0 if write access is required.
2
Set to 1 for a DUMP operation.
3
Set to 1 for a RESTORE operation.
4
Set to 1 for a COPY operation.
5
Set to 1 for a PRINT operation.
6
Set to 1 for a DEFRAG operation.
7
Set to 1 for a COMPRESS operation.
Byte 1  
Bit
Meaning
0
Set to 1 for DEFRAG, PRINT, DUMP, or RESTORE for a data set operation.
1
Set to 1 for a full-volume DUMP, RESTORE, or COPY operation.
2
Set to 1 for a tracks DUMP, RESTORE, COPY, or PRINT operation.
3
Set to 1 for a RELEASE operation.
4 to 7
Reserved.
Byte 2  
Bit
Meaning
0
Set to 1 for volume level entry. Set to 0 for data set-level entry.
1
Set to 1 for a VSAM data set cataloged in the integrated catalog facility. Set to 0 for all other data sets.
Byte 3
Reserved.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014