NOTIFY.ALLOC command

Use the NOTIFY.ALLOC command to add information to the RECON data set about either a specific database allocation or a specific database deallocation of a DBDS or DEDB area.

This addition of information is required only when the RECON data set was not updated during a run of IMS that resulted in an allocation of the DBDS or DEDB area for updates. Under normal operating conditions, you will not need to use this command.

The NOTIFY.ALLOC command fails if the DBDS or DEDB area is nonrecoverable, user-recoverable, or in use.

Restriction for HALDB databases: This command is not allowed for ILDS or index DBDSs of HALDB partitions.

Subsections:

Syntax

Read syntax diagramSkip visual syntax diagramNOTIFY.ALLOCALLTIME( time_stamp)DBD( name)DDN( name)AREA( name)DEALTIME( time_stamp)QUIESCESTARTIME( time_stamp)DSSN( value)USID( value)

Keywords

ALLTIME(time_stamp)
Required keyword you use to specify the time stamp of the allocation of the database that contains the DBDS or DEDB area that is specified in this command. The time stamp must be in standard form.

When used with the STARTIME keyword, ALLTIME causes a new allocation record to be written in the RECON data set. When used with a DEALTIME keyword, it identifies the allocation record in the RECON data set for which a deallocation time is being added.

DBD(name)
Required keyword you use to specify the database name of the DBDS or DEDB area for which you are adding allocation information to the RECON data set.

Restriction for HALDB databases: When using the NOTIFY.ALLOC command for HALDB databases, name must specify the name of a HALDB partition.

DDN(name) | AREA(name)
Mutually exclusive, required keywords you use to specify the data set ddname of the DBDS or DEDB area for which you are adding allocation information to the RECON data set.
DEALTIME(time_stamp) | STARTIME(time_stamp)
Mutually exclusive, required keywords. The time stamp must be in standard form.
DEALTIME
Specifies the time stamp of the deallocation of the database for the specified DBDS or DEDB area. This addition to the RECON data set is required only if the database is allocated for updates and explicitly deallocated before the end of an IMS run.
STARTIME
Specifies the starting time stamp of the log data set that was active at the time of the allocation specified in the ALLTIME keyword.
DSSN(value)
Optional keyword you use to specify which data set sequence number is placed in the allocation record to be created. If you do not specify the DSSN keyword, the data set sequence number for the new allocation record is 0, indicating no data sharing. If you are using data sharing, you must specify the appropriate DSSN. You use this keyword for log-merge processing.
QUIESCE
Optional keyword you use to specify that the DEALLOC time stamp specified was caused by a database quiesce command. This keyword is valid only when DEALTIME is specified.
USID(value)
Optional keyword you use to specify the update set identifier of the database or area when the update occurred.

The database or area cannot be authorized if the specified USID value is greater than the current USID for the database or area. Also, this value cannot be more than one greater than the current USID.

Example of adding allocation information to the RECON data set

In this example, information about an allocation of a specified DBDS is to be added to the RECON data set. The ALLTIME keyword specifies the time stamp of the allocation of the DBDS or DEDB area; the STARTIME keyword specifies the time stamp of the start of the log data set that was active at the time of the allocation.

 //NFYALLOC JOB
 ⋮
 //SYSIN    DD   *
      NOTIFY.ALLOC   DBD(DB1)  DDN(DD1)  -
                     STARTIME(07067020101023456)  -
                     ALLTIME(070670308200)
 /*