FABJDRSN control statement

The FABJDRSN data set contains the user-specified control statements that define the error reason codes and SMS reason codes of dynamic allocation.

The FABJDRSN data set specifies the error reason code (S99ERROR) and SMS reason code (S99ERSN) of the dynamic allocation. IMS HP Image Copy retries dynamic allocation, when the specified return code and reason code are returned for dynamic allocation of a tape unit.

If you specify the data set name for the DRSNDSN keyword, which is a keyword for the GLOBAL statement, IMS HP Image Copy allocates FABJDRSN DD dynamically and uses it. For more information about the DRSNDSN keyword, see DRSNDSN keyword.

Subtopics:

Format

This control data set usually resides in the input stream. However, it can also be defined as a sequential data set or as a member of a partitioned data set. It must contain 80-byte, fixed-length records. BLKSIZE, if coded, must be a multiple of 80. This data set must contain statements.

The following is a sample control statement format in the FABJDRSN data set. The specification in this sample shows that the DYNALLOC reason codes (S99ERROR) are 4714 and 039C. Retry for DYNALLOC is specified for specific error reason codes of 9704, which are 012C, 012D, and 012F specified within parenthesis.

  //FABJDRSN  DD  *  
  4714,                   4714: enough volume space was not found
  039C,                   039C: Device and volume were incompatible  
  *  
  9704(012C,              
       012D,  
       012F)
Note: On the control statement, you can code 4-digit hexadecimal numbers and the following special characters:
  • Asterisk (*)
  • Comma (,)
  • Parenthesis ( )

Control statement syntax

The following list describes the coding conventions that you must follow in writing control statements in the FABJDRSN data set:

  • The return code must be coded within column 1 and column 72.
  • If you specify the reason code, specify return code and set associated reason code in parentheses.
  • When there are more than one return code or reason code, they must be separated by commas. No blanks are allowed between the control statements and the commas, or within the control statements.
  • Comments can follow the last option parameter on each control statement record separated by at least one blank.
  • A comment line must begin with an asterisk in column 1.