ALTER BCS-VOLSER

Use the ALTER BCS-VOLSER command to change all occurrences of a particular volser value within a BCS.

This command assumes that the volume's volser is already what you want it to be, and that the VTOC, VTOCIX, and VVDS have been updated (if necessary) to match that volser. This command will update the BCS only, cataloging the data sets on the volume to show the data sets to be physically allocated on that volume.

Syntax

Read syntax diagramSkip visual syntax diagram ALTER Bcs-Volser INClude-Bcs(,bcsbcsmask)New-VOLser(volser&volser)Old-VOLser( volser)SIMulateEXClude-Bcs(,bcsbcsmask)INClude-Dsn(,dsndsnmask)EXClude-Dsn(,dsndsnmask)Master-CATalog( mcat)New-DEViceType(,devtypeX’00000000’)PRinT(NONE)PRinT(NONEDATAKEY)

ALTER BCS-VOLSER Command Syntax

Keywords

INCLUDE-BCS
specifies one or more specific or masked BCS names to process. Only BCS names that are connected to the master catalog on the system running the ALTER command are selected. If MASTER-CATALOG is specified, all BCSs that match the BCSs specified in INCLUDE-BCS are included in the selection analysis.
NEW-VOLSER
indicates the new value to insert for the volume serial number in the selected catalog records. The volser must be a maximum of 6 alphanumeric characters. Indirect volume serial numbers of &volser (for example, &SYSR1) or ****** are permitted.
Typically, the NEW-DEVICETYPE keyword is not used when changing the volser to an indirect or an extended indirect value. After running the command, the device type is changed to X'00000000'. At allocation time, allocation services will determine the device type. If a specific volser is specified, an automatic attempt is made to determine the device type and, without user intervention, make the device type change.
If it is not possible to determine the device type, you must specify NEW-DEVICETYPE. Only the volser in the volume cells of BCS records are changed, not any volser that may be part of a data set name, for example.
If one or more of the BCS being updated are physically resident on the volume, at execution time the master catalog is checked to determine if the volser for the user catalog record pointing to the BCS requires updating, if so, the record will be updated. If the MASTER-CATALOG keyword is also specified, that catalog is also checked and updated as required.
OLD-VOLSER
specifies the existing (old) volume serial number to replace within the selected catalog records. Indirect volume serial numbers, of the form ******, as well as extended indirect volume serial numbers, of the form &SYSR1, are permitted. Otherwise, the volser must be valid - a maximum of 6 alphanumeric characters.
Only the volser in the volume cells of BCS records are matched, not any volser that may be part of a data set name, for example. If one or more of the BCS being updated are physically resident on the volume, the master catalog, at execution time, is checked to determine if the volser for the user catalog record pointing to the BCS requires updating, if so, the record will be updated. If the MASTER-CATALOG keyword is also specified, that catalog will also be checked and updated as required.
SIMULATE
specifies that you want to test the command without actually performing it.
EXCLUDE-BCS
indicates one or more specific or masked BCS names to exclude from processing.
INCLUDE-DSN
indicates one or more specific or masked data set names to process.
EXCLUDE-DSN
indicates one or more specific or masked data set names to exclude from processing.
MASTER-CATALOG
specifies a fully qualified master catalog name. This command searches that specified master catalog for user catalogs that match the specification in the INCLUDE-BCS keyword. All user catalogs in that master catalog are included in the processing of this command.

If MASTER-CATALOG is not specified, only the master catalog on the system on which the command is run is used. The master catalog that you specify must be connected to the current system's master catalog.

NEW-DEVICETYPE
specifies the new value to insert into the existing device type field in the selected catalog records. The value entered may be a character value, denoted by the "C" flag, or a hexadecimal value, denoted by the "X" flag. If a hexadecimal value is entered, it must consist of the characters 0 through F, and must be 8 hexadecimal characters in length. Specify a generic name, esoteric name, or a hexadecimal value.
The device type will be validated. The value entered will be checked against the available system values (as defined via HCD) as well as an internal generic table. See Usage notes for the values allowed by the internal generic table.
PRINT
specifies the level of printing to SYSPRINT that takes place during processing.
  • NONE—do not print anything. This is the default.
  • KEY—print only the key from the BCS record being altered.
  • DATA—print the complete record, including key and data, from the BCS being altered.

Usage notes

For the NEW-DEVICETYPE keyword, the internal generic table allows the following values:
Generic Device Type Class
3380 X'3010200E' DASD
3390 X'3010200F' DASD
3400-2 X'30C08003' Tape
3400-3 X'34008003' Tape
3400-5 X'32008003' Tape
3400-6 X'32108003' Tape
3400-9 X'33008003' Tape
3480 X'78008080' Tape
3480X X'78048080' Tape
3490 X'78048081' Tape
3590-1 X'78048083' Tape
9345 X'30102004' DASD