gtpo1mg5Operations

ZTOFF-Dismount, Rewind, and Unload Tape

Use this command to:

Requirements and Restrictions

Format




tape
is a 3-character tape name. The first 2 characters are alphabetic and the 3rd character is alphanumeric.

A
dismounts an active tape.

S
dismounts a standby tape.

BP
dismounts a tape that is currently being used by an application (that is, an open active general tape), or dismounts a tape when a real-time tape switch is in progress.

Attention: Use this parameter with caution because it causes the ECB that is using the specified tape to exit with a system error.

ALT
dismounts the ALT tape on the specified tape device.

cuu
is a 3-character hexadecimal tape device address. If you do not specify a tape device address for the ALT parameter, the first ALT tape that is located in the tape status table (TSTB) is dismounted.

YYY
rewinds and unloads the tape on the specified tape device.

ALL
dismounts all the tapes in the TPF system, except the system error dump tape.
Note:
You can specify this parameter only from the basic subsystem (BSS).

Additional Information

Volume statistics are not logged automatically to the system log tape when you cycle down the TPF system in preparation for a machine switchover or other initial program load (IPL). To ensure that these statistics are not lost, enter ZTOFF ALL to dismount all the tapes and log the volume statistics before you perform a machine switchover or IPL.

Examples

The RTB tape is dismounted in the following example.

+--------------------------------------------------------------------------------+
|User:   ZTOFF RTB                                                               |
|                                                                                |
|System: COTG0300A 12.12.47 TOFF BSS    REMOVE RTB FROM DEVICE 484               |
|                           VSN A00095 G0002 S0001 F38K   SL  NOBLK  NOCOMP      |
+--------------------------------------------------------------------------------+

All the tapes in the TPF system except the system error dump tape are dismounted in the following example.

+--------------------------------------------------------------------------------+
|User:   ZTOFF ALL                                                               |
|                                                                                |
|System: COTG0087A 12.55.36 TOFF HPN    REMOVE KMP FROM DEVICE 481               |
|                           VSN A00050  NOBLK  COMP                              |
|        COTF0114I 12.55.36 TOFF BSS    ALL TAPES DISMOUNTED EXCEPT DUMP TAPE    |
+--------------------------------------------------------------------------------+

Related Information

None.