DSM/Tape Catalog Management Programming Manual

Commands and Responses
DSM/Tape Catalog Management Programming Manual—520481-003
5-17
ALTER TAPEMOUNT Command
ALTER TAPEMOUNT Command
ZMCS-CMD-ALTER (super-group only)
Sometimes a tape requested by a TAPECATALOG DEFINE is not available at the time
the mount message is issued. Perhaps the tape is misplaced, damaged, or on loan to
another group.
If the unavailable tape has an alternate copy, you can use ALTER TAPEMOUNT to
determine the proper tape to mount and to issue a new mount message for it. The
command applies when you want to:
•
Use a copy of an input tape for a TMF operation when the original tape requested
is unavailable.
•
Use the next scratch tape that can satisfy a request for an output tape when the
original scratch tape requested for BACKUP, BACKCOPY, TMF, or an application is
unavailable.
ALTER TAPEMOUNT cannot be used when:
•
A tape is requested by a TAPECATALOG DEFINE with the CATALOG attribute set
to OFF.
•
A tape is requested by a TAPE DEFINE.
ZMCS-MAP-ALTER-TAPEMOUNT
contains fields that correspond to the MEDIACOM ALTER TAPEMOUNT
command. For descriptions of these fields, see ZMCS Maps on page 4-18.
Command
ZMCS-CMD-ALTER
Object Type
ZMCS-OBJ-TAPEMOUNT
ALTER TAPEMOUNT Command Tokens
ZMCS-MAP-ALTER-TAPEMOUNT
ALTER TAPEMOUNT Response Tokens
ZMCS-TKN-COUNT token-type ZSPI-TYP-INT2