DSM/Tape Catalog Management Programming Manual

Commands and Responses

DSM/Tape Catalog Management Programming Manual—520481-003

5-10

ALTER CONSOLE Command

ZMCS-CMD-ALTER (super-group only)

Messages from $ZSVR are displayed at the device designated as the tape console.

Only one device at a time, usually a terminal, can be the tape console for a node. Use

ALTER CONSOLE to designate a console when there is none or to change the current

console to a different device.

The console device remains in effect until another ALTER CONSOLE changes it,

whether in the current session or a subsequent one.

ALTER DISKFILE Command

ZMCS-CMD-ALTER (super-group only)

Occasionally, a disk file written to tape by BACKUP or BACKCOPY should not be

written back to disk. Something might be wrong with the disk file’s data, or the tape

might be unreadable where the file was written on the tape. If the disk files for a

backup tape are cataloged, you can track unsuitable disk files by marking their entries

invalid with ALTER DISKFILE. To list valid and invalid disk file entries, use INFO

DISKFILE with the STATUS ALL option.

ALTER DISKFILE changes only the disk file entries specified by the command. It does

not affect the other disk files cataloged for a backup tape. Once a disk file entry is

invalid, it remains in the catalog until the tape file entry it belongs to expires or is

deleted. If you accidentally invalidate the wrong disk file entry, you can change its

Command

ZMCS-CMD-ALTER

Object Type

ZMCS-OBJ-CONSOLE

ALTER CONSOLE Command Token

ZMCS-TKN-OUTFILE token-type ZSPI-TYP-STRING

ALTER CONSOLE Response Tokens

ZMCS-TKN-COUNT token-type ZSPI-TYP-INT2