NOTIFY.BKOUT command

Use the NOTIFY.BKOUT command to create a backout record for a specified subsystem and to add a single unit of recovery (UOR) entry to the record that is created. Additional UOR entries can be added to the backout record by using the CHANGE.BKOUT command.

Subsections:

Syntax
Keywords
Example of adding a backout record to the RECON data set

Syntax

Keywords

SSID(name): Required keyword you use to specify the subsystem for which the backout record is to be created. The name is an eight-character, alphanumeric string that represents any valid subsystem name.
UOR(uor): Required keyword you use in conjunction with the UORTIME keyword to identify a unit of recovery in the backout record. The recovery token (uor) is a 16-byte field that describes a specific UOR that is to be included with the backout record. uor must be 32 hexadecimal digits expressed as a character string; for example, UOR(E2E8E2F3404040400000000600000003).
The recovery token is intended to be a unique identifier, but it can be duplicated across restarts. When you include UORTIME, you eliminate the problem of possible duplication.
UORTIME(time_stamp): Required keyword you use to specify the time of the UOR to be added to the backout record. The value is the time stamp of the beginning of the UOR (found in the X'5607' log record). The time stamp must be in standard form.
PSB(name): Required keyword you use to identify the PSB associated with the UOR.
DBD(name): Optional keyword you use to identify up to eight databases having changes associated with the unit of recovery that require backout.
Restriction for HALDB databases: When using the NOTIFY.BKOUT command for HALDB databases, name must specify the name of a HALDB partition.
BKO(name): Optional keyword you use to identify up to eight databases having changes associated with the unit of recovery that have already been backed out.
Use BKO to identify databases that have already been backed out from this UOR-UORTIME combination. You can specify either the BKO keyword, the DBD keyword, or both. A database name can appear in either BKO or DBD, but not both. (A database cannot both be backed out and require a backout at the same time.)

Example of adding a backout record to the RECON data set

In this example, a backout record for subsystem SYS3 is added to the RECON data set.

 //NFYBKOUT JOB
 ⋮
 //SYSIN    DD  *
      NOTIFY.BKOUT  SSID(SYS3)
                    UOR(E2E8E2F3404040400000000600000003)
                    UORTIME(070931345027) PSB(APPL34)
                    DBD(DATA1,DATA2,DATA3C)
                    BKO(DATA4,DATA5,DATA3A)
 /*

See Standard time stamp format.