gtpo1mfwOperations

ZTGRP--Define, Delete, and Display Tape Groups

Use this command to:

Requirements and Restrictions

You can define and delete tape groups only from the basic subsystem (BSS).

Format




DEFine
defines a tape group for all subsystem users.

DELete
deletes a tape group from all subsystem users.
Note:
You cannot delete a tape group if any tape labels are assigned to that tape group. In addition, if any subsystem user is not currently active, you must specify the BP parameter to delete the tape group.

DISplay
displays information about a tape group.
Note:
If you specify only this parameter, information about all the tape groups that are currently defined is displayed.

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

BP
deletes a tape group when one or more subsystem users are not active.

ALL
displays the tape labels or tape devices that are assigned to the ALL tape group.

NONE
displays the tape labels or tape devices that are assigned to the NONE tape group.

LABELS
displays all the tape labels that are assigned to the specified tape group.

DEVICES
displays all the online and offline tape devices that are assigned to the specified tape group.

SSU ALL
displays all the tape labels or tape devices that are assigned to the specified tape group for all subsystem users. If you omit this parameter, the tape labels and tape devices are displayed for the current subsystem user.

Additional Information

You can define a maximum of 254 tape groups.

Examples

The GROUP1 and GROUP2 tape groups are defined in the following example.

+--------------------------------------------------------------------------------+
|User:   ZTGRP DEFINE GROUP1 GROUP2                                              |
|                                                                                |
|System: COT70001I 09.40.28 TGRP HPN DEFINE - STATUS AT COMPLETION               |
|        GROUP GROUP1   - DEFINED                                                |
|        GROUP GROUP2   - DEFINED                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The tape devices assigned to the GROUP1 tape group are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZTGRP DISPLAY GROUP1 DEVICES                                            |
|                                                                                |
|System: COT70005I 09.42.11 TGRP HPN DISPLAY - DEVICES ASSIGNED TO GROUP GROUP1  |
|        DEVICE ADDRESS   SS NAME    SSU NAME                                    |
|        0482             BSS        HPN                                         |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The GROUP2 tape group is deleted in the following example. Notice that the BP parameter is required because one or more subsystem users are not currently active.

+--------------------------------------------------------------------------------+
|User:   ZTGRP DELETE GROUP2                                                     |
|                                                                                |
|System: COS70018E 10.17.58 ALL SSUs ARE NOT ACTIVE, BYPASS REQUIRED             |
|                                                                                |
|User:   ZTGRP DELETE GROUP2 BP                                                  |
|                                                                                |
|System: COT70002I 10.18.23 TGRP HPN DELETE - STATUS AT COMPLETION               |
|        GROUP GROUP2   - DELETED                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information

None.