Commands › SETUP Command › Parameter Description

Parameter Description

The following provides a description of each parameter:

START

Starts the Setup facility.

STOP

Stops the Setup facility.

Query [ ALL | Pulled | Waiting ] [ BATCH name ]

Displays the status of setup requests, as follows:

• ALL

  Pulled or waiting status

• Pulled

  Pulled status

• Waiting

  Waiting status (that is, tapes that have not been pulled or released)

  You can use the BATCH name option to limit the query to a specified group of tapes.

[ DISK | TYPE | LIFO | FIFO ]

Specifies the destinations for the query output, as follows:

• DISK

  SETUP VMTAPE A1 file

• TYPE

  Your terminal

• LIFO

  Program stack in last in, first out order

• FIFO

  Program stack in first in, first out order

  The format of the output placed in the program stack is * volser status, where status is PULLED or WAITING.

Note: You cannot use DISK, LIFO, or FIFO from the CA VM:Tape console or with the CP SMSG command.

CANcel [ volser₁ volser₂ ... volsern ] [ BATCH name ]

Cancels the setup request for the specified tapes. You can specify an asterisk for volser to specify all tapes. If the request was for a saved tape, CA VM:Tape cancels the mount request. If the request was for a scratch tape, CA VM:Tape continues to select new scratch tapes until you cancel the mount request.

You can use the BATCH name option to identify a group of tapes whose setup requests you want to cancel. When you use the BATCH option you cannot list individual volsers.

PULled volser₁ [ volser₂ ... volsern ] [ BATCH name ]

Indicates that the specified tapes are available. The mount does not proceed until the requests are freed by the SETUP RELEASE command. You can specify an asterisk for volser to specify all tapes.

You can use the BATCH name option to group the specified tapes into a batch you can later query, cancel, or release.

RELease [ volser₁ volser₂ ... volsern ] [ BATCH name ]

Indicates that the specified tapes are available and tells CA VM:Tape to convert the setup requests back into a normal mount request. You can specify an asterisk for volser to specify all tapes.

You can use the BATCH name option to identify a group of tapes whose setup requests you want to release. When you use the BATCH option you cannot list individual volsers.