OBJECT command
The OBJECT command limits action to a selected object.
Syntax
Object=(DSN=data-set-name
[,VOL=volume-serial])
Parameters
- DSN=data-set-name
- The name of the data set to which further commands apply.
- VOL=volume-serial
- For uncataloged data sets, the volume serial number of the volume on which the data set resides. Omit this parameter if the data set is cataloged.
Usage
This command can only be used in combination with other commands to limit the action of those commands to the specified data set. For example, if it is combined with REMOVECHECKOUT command, then only records for the specified data set are removed.
Can be used with the HALTOBJ and UNHALTOBJ to suspend and resume the tracking of a particular data set. This can be useful to allow for a temporary modification to a locked data set to take place without having to shut down or deactivate the started task.
The OBJECT command can only be used to specify a single data set. If multiple OBJECT commands are issued in one job, only the latest OBJECT command takes effect.
Example 1: Suspend the tracking of an object
OPTION=HALTOBJECT
OBJECT=(DSN=IBMUSER.TEST.PDS)Example 2: Generate a diagnostic report about an object (only if requested by IBM)
OPTION=DIAGNOSE
OBJECT=(DSN=SYS1.PARMLIB)