gtpo1mftOperations

ZTDEV-Modify and Display Tape Device Status for Automatic Tape Mounting

Use this command to:

Requirements and Restrictions

Format




ENable
enables automatic tape mounting for each specified tape device.

DISAble
disables automatic tape mounting for each specified tape device.

RESume
resumes automatic tape mounting for each specified tape device.

DISPlay
displays the tape groups to which the specified tape device is assigned and the automatic tape mounting status for the tape device.

ASsign
assigns the specified tape devices to the specified tape group. Each tape device is allowed to automatically mount tapes assigned to the specified tape group in the current subsystem user. You can assign each tape device to a maximum of 31 tape groups.

UNAssign
unassigns the specified tape devices from the specified tape group.

cuu
is a 3- to 4-digit hexadecimal tape device address.

GROUP
specifies a tape group.

group
is a 1- to 8-character alphanumeric tape group name.

ALL
assigns the specified tape devices to all tape groups.

SSU ALL
assigns or unassigns the specified tape devices to or from the specified tape group for all the subsystem users.
Note:
You can unassign tape devices from all the subsystem users only if you used this parameter to assign the tape devices to all the subsystem users.

SSU ssun
unassigns the specified tape devices from an inactive subsystem user, where ssun is the name of an inactive subsystem user.
Note:
You can specify this parameter only from the basic subsystem (BSS).

MIGrate
migrates the DTDAT records from the ordinal-based, processor unique #TDATR fixed file record type to the file address compute (FACE) program table processor unique #TDTDR fixed file record type. If there is no #TDATR fixed file record or if the DTDAT records in the #TDATR fixed file record are not valid, the DTDAT records in the #TDTDR fixed file record type are cleared and initialized during tape restart.

Notes:

  1. The MIGRATE parameter works only on the DTDAT records for the current processor; the DTDAT records for other processors are not migrated.

  2. Use the MIGRATE parameter only if the current processor has valid #TDATR fixed file records. (The #TDATR records are valid if the processor was IPLed before tape record migration was applied.) Otherwise, enter the ZTDEV command with the CLEAR parameter specified.

CLear
clears the DTDAT records in the #TDTDR fixed file record type. These records are initialized during tape restart.
Note:
The CLEAR parameter works only on the DTDAT records for the current processor; the DTDAT records for other processors are not cleared.

Additional Information

None.

Examples

In the following example, automatic tape mounting is enabled on the specified tape devices.

+--------------------------------------------------------------------------------+
|User:   ZTDEV ENABLE 480 481                                                    |
|                                                                                |
|System: COT50001I 08.36.32 TDEV HPN - ENABLE STATUS AT COMPLETION               |
|        ENABLE 0480 - COMPLETE                                                  |
|        ENABLE 0481 - COMPLETE                                                  |
|        END OF STATUS                                                           |
+--------------------------------------------------------------------------------+

In the following example, automatic tape mounting is disabled on the specified tape devices.

+--------------------------------------------------------------------------------+
|User:   ZTDEV DISABLE 480 481                                                   |
|                                                                                |
|System: COT50002I 08.37.01 TDEV HPN - DISABLE STATUS AT COMPLETION              |
|        DISABLE 0480 - COMPLETE                                                 |
|        DISABLE 0481 - COMPLETE                                                 |
|        END OF STATUS                                                           |
+--------------------------------------------------------------------------------+

In the following example, the specified tape device is assigned to the GROUP1 tape group.

+--------------------------------------------------------------------------------+
|User:   ZTDEV ASSIGN 482 GROUP GROUP1                                           |
|                                                                                |
|System: COT50003I 09.40.50 TDEV HPN - ASSIGN STATUS AT COMPLETION               |
|        ASSIGN 0482 GROUP GROUP1 SSU HPN - COMPLETE                             |
|        END OF STATUS                                                           |
+--------------------------------------------------------------------------------+

In the following example, the specified tape device is unassigned from the GROUP1 tape group.

+--------------------------------------------------------------------------------+
|User:   ZTDEV UNASSIGN 482 GROUP GROUP1                                         |
|                                                                                |
|System: COT50004I 10.28.38 TDEV HPN - UNASSIGN STATUS AT COMPLETION             |
|        UNASSIGN 0482 GROUP GROUP1 SSU HPN - COMPLETE                           |
|        END OF STATUS                                                           |
+--------------------------------------------------------------------------------+

The automatic tape mounting status for the specified tape device is displayed in the following example along with the names of the tape groups to which the tape device is assigned.

+--------------------------------------------------------------------------------+
|User:   ZTDEV DISPLAY 483                                                       |
|                                                                                |
|System: COT50005I 08.41.12 TDEV HPN - DISPLAY STATUS AT COMPLETION              |
|        DISPLAY 0480 - START OF DISPLAY                                         |
|           AUTOMOUNT DISABLED                                                   |
|           GROUP      SSN    SSUN                                               |
|           TEST1      BSS    HPN                                                |
|        END OF STATUS                                                           |
+--------------------------------------------------------------------------------+

In the following example, the DTDAT records are migrated from the #TDATR fixed file record type to the #TDTDR fixed file record type.

+--------------------------------------------------------------------------------+
|User:   ZTDEV MIGRATE                                                           |
|                                                                                |
|System: COT50007I 08.36.32 TDEV HPN - MIGRATE STATUS AT COMPLETION              |
|        MIGRATE - COMPLETE                                                      |
|        END OF STATUS                                                           |
+--------------------------------------------------------------------------------+

In the following example, the DTDAT records in the #TDTDR fixed file record type are cleared.

+--------------------------------------------------------------------------------+
|User:   ZTDEV CLEAR                                                             |
|                                                                                |
|System: COT50008I 08.36.32 TDEV HPN - CLEAR STATUS AT COMPLETION                |
|        CLEAR - COMPLETE                                                        |
|        END OF STATUS                                                           |
+--------------------------------------------------------------------------------+

Related Information

None.