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


ARCBDEXT—Input Data Structure

z/OS DFSMS Installation Exits
SC23-6850-01

The third word of ARCBDEXT Parameter List points to the address of the area described in Table 1 and Table 2.

Table 1. ARCBDEXT Input Data Structure -- Input Data Structure for Volume Backup Requests
Offset Length or Bit Pattern Description
00 (X'00') 4 Approximate size of the data set, in units of 1024 bytes.
04 (X'04') 8 Identifies the level of parameter list and data structure. If there is a value other than '*EXPAND1' at this offset, then this and subsequent fields are not part of the structure.
12 (X'0C') 1 Data set status:
1... ....
Data set is a backup-while-open (BWO) candidate.
.1.. ....
Reserved.
..1. ....
RETAINDAYS value set by exit.
..0. ....
RETAINDAYS value not set by exit.
0... ....
Data set is not a BWO candidate.
13 (X'0D') 1 Directions for backing up a data set in use (decimal value):

0 = Try to serialize and back up, but fail if data set is in use. This value is established by the command:

SETSYS BACKUP - (INUSE(RETRY(N))).

1 (output only) = Try to serialize, but back up even if data set is in use.

2 (output only) = Back up without trying to serialize first.

10 = Try to serialize, but if data set is in use, schedule a retry for which serialization is REQUIRED. This value is established by the command:

SETSYS BACKUP(INUSE(RETRY(Y) SERIALIZATION(REQUIRED))).

11 = Try to serialize, but if data set is in use, schedule a retry for which serialization is PREFERRED. This value is established by the command:

SETSYS BACKUP(INUSE(RETRY(Y) SERIALIZATION(PREFERRED))).

Note: Field INUSE serves both as input to and output from ARCBDEXT. The input is derived from SETSYS parameters, but the exit can change the field contents to other valid values. On return from the exit:
  • If the return code indicates "do not back up," field INUSE is ignored.
  • If INUSE does not contain one of the defined values, it is treated as 0.
  • For a BWO candidate, any value other than 0 or 10 is treated as 0.
14 (X'0E') 2 Length of management-class name in the following field. If this field is zero, there is no associated management class.
16 (X'10') 30 Management-class name associated with the data set.
46 (X'2E') 2 Reserved.
48 (X'30') 4 RETAINDAYS value.
Table 2. ARCBDEXT Input Data Structure (continued) -- Input Data Structure for Individual Data Set Backup Command Requests
Offset Length or Bit Pattern Description
04 (X'04') 8 Identifies the level of parameter list and data structure. If there is a value other than '*EXPAND2' at this offset, then this and subsequent fields are not part of the structure.
12 (X'0C') 2 Data set status:
1... ....
Data set is a backup-while-open (BWO) candidate.
..1. ....
RETAINDAYS value set by exit.
..0. ....
RETAINDAYS value not set by exit.
0... ....
Data set is not a BWO candidate.
.1.. ....
Backup is the result of data set backup command.
.0.. ....
Backup is not the result of data set backup command. Backup is the result of retry from volume request due to an INUSE failure.
14 (X'0E') 2 Reserved.
16 (X'10') 4 RETAINDAYS value.
Start of change
Table 3. ARCBDEXT Input Data Structure (continued) -- Input Data Structure for Autobackup Stage 3
Offset Length or Bit Pattern Description
04 (X'04') 8 Identifies the level of parameter list and data structure. If there is a value other than '*EXPAND3' at this offset, then this and subsequent fields are not part of the structure.
12 (X'0C') 2 Data set status:
1... ....
Reserved.
.1.. ....
Reserved.
..1. ....
RETAINDAYS value set by exit.
..0. ....
RETAINDAYS value not set by exit.
14 (X'0E') 2 Reserved.
16 (X'10') 4 RETAINDAYS value.
End of change

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014