Use this command to:
- Enable, disable, or resume automatic tape mounting for a tape
device.
- Assign or unassign a tape device to or from a tape group.
- Display the tape groups to which a tape device is assigned and the
automatic tape mounting status of the tape device.
- Migrate or clear the defined tape device assignment table (DTDAT).
Requirements and Restrictions
- Use the MIGRATE and CLEAR parameters only when prompted by the TPF system
during tape restart. The TPF system prompts you to enter the ZTDEV
command with the MIGRATE or CLEAR parameter specified if the DTDAT control
record is not valid and the ordinal number of the current processor is from 1
to 7. If the ordinal number of the current processor is 0, the TPF
system tries to migrate the DTDAT records. If the ordinal number of the
current processor is greater than 7, the TPF system automatically initializes
the DTDAT records.
- Use the MIGRATE and CLEAR parameters only for the basic subsystem
(BSS).
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:
- The MIGRATE parameter works only on the DTDAT records for the current
processor; the DTDAT records for other processors are not
migrated.
- 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.