Explanation
A DEFINE command was issued to define a dump class. If MODIFIED is indicated, the dump class that existed before the DEFINE command was issued and the dump class attributes that were changed were successfully recorded in the DFSMShsm backup control data set (BCDS). If SUCCESSFUL is indicated, a new class was defined without an error or the definition did not change any attributes of an existing class. A value of 0 is returned for return-code for SUCCESSFUL and MODIFIED.
If DISABLED is indicated, the dump class existed before the DEFINE command was issued and before you specified the DISABLE parameter. The dump class record was marked disabled. You can neither do further dumps nor add dump volumes to this class.
When
DISABLED, the values for return-code are:
- Retcode
- Meaning
- 0
- No dump volumes in the dump class contained valid dump copies. Any empty volume assigned to this class is now unassigned.
- 1
- At least one dump volume assigned to the class contained part of a valid dump copy. Any volumes containing valid data in the class remain unchanged. Any volumes that did not contain part of a valid dump copy were unassigned.
If UNSUCCESSFUL is indicated, the dump class
definition failed. Possible return-code values
are:
- Retcode
- Meaning
- 2
- An error reading, writing, or updating the dump class record (DSR) occurred. See an accompanying ARC0184I message for further details.
- 4
- The RETENTIONPERIOD specified was less than 1 or greater than 9999, or it was not NOLIMIT.
- 6
- The FREQUENCY specified was less than 0 or greater than 999.
- 8
- The UNIT specified is invalid. Only the following tape units are valid: 3400-4, 3400-5, 3400-6, 3400-9, 3480, 3480X, 3490, or valid esoteric tape unit names.
- 10
- The DAY specified is invalid. It is either less than 1 or greater than the number of days in the dump cycle, or it is the number of an N day in the cycle.
- 12
- A DEFINE command was issued with the DISABLE parameter for a dump class that does not exist.
- 14
- A DEFINE command was issued with the VTOCCOPIES parameter. The value specified for this parameter was not a numeric value between 0 and 100.
- 16
- A DEFINE command was issued with the TAPEEXPIRATIONDATE parameter. The year value specified for this parameter was not a valid year from the current year (YY) to 99, or from the current year (YYYY) to 2155.
- 18
- A DEFINE command was issued with the TAPEEXPIRATIONDATE parameter. The value specified was not 5 or 7 numeric characters.
- 20
- A DEFINE command was issued with the TAPEEXPIRATIONDATE parameter. The year specified for this parameter was a valid year after 1999; however, the level of MVS™ or DFP installed does not support expiration dates past 1999. A year between 1900 and 1999 is required.
- 22
- A DEFINE command was issued with the TAPEEXPIRATIONDATE parameter. The days value specified for this parameter was not in the range between 001 to 366.
- 24
- A DEFINE command was issued with the TAPEEXPIRATIONDATE parameter. The date specified was in the past.
- 26
- A DEFINE command was issued with the TAPEEXPIRATIONDATE parameter. The date was specified using the form yyddd, but the current date is after 1999.
- 28
- A DEFINE command was issued with the STACK parameter. The stack value specified is out of the valid range of 1 - 255.
- 30
- A DEFINE command was issued with the ENCRYPT parameter. One of RSA, KEYPASSWORD, and NONE must be specified with ENCRYPT when a new dump class is being defined.
- 32
- A DEFINE command was issued with the ENCRYPT parameter. The NONE keyword was specified with conflicting encryption keywords.
- 34
- A DEFINE command was issued with the ENCRYPT parameter. The TYPE keyword was specified without its required parameter.
- 36
- A DEFINE command was issued with the ENCRYPT parameter. Both KEYPASSWORD and TYPE(ENCTDES) were specified on the command, or one was specified on the command while the other was previously set in the dump class. Encryption type ENCTDES and KEYPASSWORD cannot both be set in a dump class definition.
- 38
- A DEFINE command was issued with the ENCRYPT parameter. KEYPASSWORD was specified with an invalid password. The password must be 8 to 32 characters in length.
- 40
- A DEFINE command was issued with the ENCRYPT parameter. ICOUNT was specified without the KEYPASSWORD keyword.
- 42
- A DEFINE command was issued with the ENCRYPT parameter. The ICOUNT value specified was not in the range between 1 to 10000.
- 44
- A DEFINE command was issued with the HWCOMPRESS parameter. The required YES/NO parameter was not specified with the HWCOMPRESS keyword.
- 46
- A DEFINE DUMPCLASS command was issued with FASTREPLICATIONDUMP and the RESET parameter or the dump class specified on the FRBACKUP DUMP command was previously defined with RESET. FASTREPLICATIONDUMP and RESET cannot both be set in a dump class definition and a dump class defined with the RESET parameter cannot be used for a fast replication dump.
48
- A DEFINE command was issued with the ZCOMPRESS parameter. The
required YES/NO parameter was not specified with the ZCOMPRESS keyword.
System action
If UNSUCCESSFUL, the DEFINE command fails. DFSMShsm processing continues.
Programmer response
If UNSUCCESSFUL and the return code is not 2, determine the incorrect parameter, correct it, and issue the DEFINE command again. For return code 2, determine the cause of the control data set access error, correct it, and issue the DEFINE command again.
Source
DFSMShsm