DSDELL

Delete L-type key for a volume. Two fields are mandatory for this function:

• DSVOLSER – Data set volume serial number
• DSLABEL – Data set label number

DSNADD

Add data set record. Three fields are mandatory for this function:

• DSVOLSER – Data set volume serial number
• DSLABEL – Data set label number
• DSNAME – Data set name

Note: When adding a new dataset record to a scratch volume, all data sets of the volume are automatically deleted and the volume becomes active.

DSNDEL

Delete data set record. The record to be deleted must be identified by specifying both

• DSVOLSER – Data set first volume

and

• DSLABEL – Data set label number

or

• DDSRBA – Internal database record identifier

One of these two sets of fields is mandatory

If DDSRBA is used to identify the record, DSVOLSER and DSLABEL can also be specified for verification

If DSNAME is specified, it is used for verification only

DSNEXT

Extend the retention of a data set by a specific number of days. Three fields are mandatory for this function:

• DSVOLSER – Data set volume serial number
• DSLABEL – Data set label number
• DAYS – Number of days by which to extend the data set

DSNUPD

Update data set record. The record to be updated must be identified either by specifying both

• DSVOLSER– Data set volume serial number

and

• DSLABEL–Data set label number (file sequence),

or by specifying

• DDSRBA– Internal database record identifier

One of these two sets of fields is mandatory.

If DSNAME is specified, it is used for verification only. The data set name cannot be modified.

DSNUPDN

Update data set name (the DSNAME field in the data set record). Only the following parameters are valid for this control statement:

• NEWNAME – New data set name. Mandatory.
• DSNAME – The current data set name (before update). This parameter is used for verification only. The data set cannot be modified.

The record to be updated must be identified either by specifying both

• DSVOLSER – Data set volume serial number

and

• DSLABEL – Data set label number (file sequence)

or by specifying

• DDSRBA – Internal database record identifier

One of these two sets of fields is mandatory.

GRPBIX

Rebuild the indexes of all the volumes and of all the data sets in the group. One of the volumes in the group must be identified by one of two fields (either field is mandatory):

• VOLSER – Volume serial number of a volume in the group.

or

• DVLRBA – Internal database record identifier of a volume in the group.

If DVLRBA is used to identify the volume, VOLSER can also be specified for verification.

GRPSCR

Expire all data sets of all the volumes in the group and change the status of those volumes to scratch.

• VOLSER – Volume serial number of one of the volumes in the group.
• DEFERRED – Choose deferred (or immediate) scratch. Optional. Valid values are:

  - Yes – Perform deferred scratch.

  - No – Perform immediate scratch. Default.

RECDEL

Delete Media database record (any type). One field is mandatory for this function: The field is RBA, the internal database record identifier.

RECUPD

Modify records of any type in the Media database (for example, Restart Control records, Slot Definition records).

This function includes the following control statements:

RECUPD RBA=rba

VER    offset data

REP    offset data

ENDUPD

Statement RECUPD selects a records from the Media database for update. It must be the first statement specified. This statement includes the following parameters:

• RBA – Update internal database record identifier.
• VER – Verify existing data before updating the record.
• REP – Replace existing data with new data.

• ENDUPD – Identifies the end of the RECUPD function. It must be the last statement in this function.

An unlimited number of paired VER and REP statements can follow the RECUPD statement. These statements are formatted like the VER and REP statements of MVS utility AMASPZAP:

Data is provided in both the VER and REP statements, as follows:

• offset – Offset of the data from the beginning of the record (four digits in hexadecimal format, from 0000 through 01CC).
• data – Record data for verification or replacement (in hexadecimal ZAP format).

Example

This example updates the volume record with the statement RBA=00000104. Two status bytes are verified on offset 0005 and status IN-USE then set.

RECUPD    RBA=00000104

VER       0005 8000

REP       0005 8002

ENDUPD

VOLADD

Add volume. One field is mandatory for this function, :VOLSER, the volume serial number.

VOLBIX

Rebuild the indexes of a volume and of all its data sets. The volume must be identified by one of two fields (either field is mandatory):

• VOLSER – Volume serial number

or

• DVLRBA – Internal database record identifier

If DVLRBA is specified to identify the volume, VOLSER can also be specified for verification.

VOLDEL

Delete volume. The volume to be deleted must be identified by one of two fields (either field is mandatory):

• VOLSER – Volume serial number

or

• DVLRBA – Internal database record identifier

If DVLRBA is used to identify the volume, VOLSER can also be specified for verification.

VOLSCR

Expire all the data sets in the volume and change the status of the volume to scratch.

• VOLSER – Volume serial number. Mandatory.
• DEFERRED – Choose deferred (or immediate) scratch. Optional. Possible values are:

  - Yes – Perform deferred scratch.

  - No – Perform immediate scratch. Default.

VOLSCRF

Scratch a volume in the Media database regardless of integrity errors. BMC recommends that you use this function only if an error occurred while trying to scratch a volume using the VOLSCR or GRPSCR functions. In addition to scratching the volume, all datasets of the volume are deleted from the Media database, and others volumes of that multi-volume group may not be cleared.

Note: This function affects the current volume only. To scratch a multi-volume group, use this function separately for each volume that belongs to the multi-volume group.

VOLUPD

Update volume. The VOLSER field (volume serial number) is mandatory for this function: