CA MIA Statements and Commands

This chapter discusses CA MIA statements and commands.

This section contains the following topics:

(MIA) ANALYZE Command-Analyze and Display Delay Information

ATTACH Command-Request Tape Drive Attach

CANCEL Command-Purge Pending ATTACH Requests

DETACH Command-Request Tape Drive Detach

DIAGNOSE Command-Diagnose Allocation Delays

DISPLAY GTAF Command-Display GTAF Information

DISPLAY TPCF Command-Display TPCF Information

(MIA) DUMP GTAF/TPCF Command-Create DUMP

QUERY Command-Display Pending Device Information

(MIA) RESYNCH Command-Change Managed Devices

SETOPTION GTAF Command-Set Operating Values for GTAF

SETOPTION TPCF Command-Set Operating Values for TPCF

(MIA) USERDATA Command—Populate Device Data Field

VARY Command-Change Status of Devices

(MIA) ANALYZE Command-Analyze and Display Delay Information

The ANALYZE command provides a real-time global picture of tape device allocation delays. Use of the ANALYZE command requires SETOPTION DDN=ON to be set on at least one z/OS system in the MIAPLEX.

Use the ANALYZE TAPEDELAY SUMMARY subcommand to:

View the global impact of a task owning device allocation locks for an extended period of time.
View all systems where a WAIT/NOHOLD scenario is occurring.

Use the ANALYZE TAPEDELAY DETAIL subcommand to:

View diagnostic information for delays matching user specified parameters
Determine which tasks are waiting behind specific owners

This command has the following format:

ANALYZE TAPEDELAY [SUMMARY]
		    [DETAIL=(DISPLAYCOUNT={nn|ALL},
			JOBNAME=(jobname,TCB=tcb)|
			ASID=(asid,TCB=tcb)
			ROLE=OWNER|WAITER|ALL]),
			SYSTEM=system,
			TYPE={CONTENTION|WAITNOHOLD|ALL}
			)

SUMMARY

(Optional) Displays a summary of all global tape device allocation delays that CA MIA has detected.

DETAIL

(Optional) Displays detailed information about global tape device allocation delays that CA MIA has detected.

DISPLAYCOUNT

Controls the number of waiters and owners displayed.

For TYPE=CONTENTION events this controls the number of waiters displayed.
For TYPE=WAITNOHOLD events this controls the number of owners and waiters displayed.

Default: DISPLAYCOUNT=5

Range: 1-99

JOBNAME

Limits the display to only jobs with a specific jobname that are of TYPE=CONTENTION.

ASID

Limits the detailed display to only jobs with a specific ASID that are of TYPE=CONTENTION.

TCB

Limits the display to only tasks with a specific TCB that are of TYPE=CONTENTION. Specifying TCB requires ASID or JOBNAME to be specified.

ROLE

Limits the display to only ASIDs with a role of OWNER, WAITER or ALL.

Default: ROLE=OWNER

SYSTEM

Limits the display to jobs on a specific system. The system can be input as the CA MIA system name, system alias, or system index.

TYPE

Limits the display to CONTENTION delays, WAITNOHOLD delays, or ALL.

Default: TYPE=ALL

ATTACH Command-Request Tape Drive Attach

The ATTACH command requests that an available tape drive be attached to the issuing CMS user ID. Class G users can request a drive only on their own behalf, but class B users can specify the user ID that will receive the attached drive. Some customers may prefer to make tape ATTACH requests an operator function and suppress the class G use of this command entirely. This command is available only if you are running the CA MIA component.

This command has the following format:

For Class G ATTACH:

ATTACH [EXT xname1[|xname2[|xname3…]] [AS vaddr (options)]]
       [INT iname1[|iname2[|iname3…]] [AS vaddr (options)]]   
       [MODEL type [AS vaddr (options)]]
       [UNIT type [AS vaddr (options)]]

For Class B ATTACH:

ATTACH [EXT xname1[|xname2[|xname3…]] [TO userid] [AS vaddr (options)]]
       [INT iname1[|iname2[|iname3…]] [TO userid] [AS vaddr (options)]]
       [MODEL type [TO userid] [AS vaddr (options)]]
       [UNIT type [TO userid] [AS vaddr (options)]]

xname

Requests a specific drive by its global name. If you specify a list of drives, CA MIM attaches the first available drive in the list. To specify a list, enter two or more global names separated by a vertical bar character, EBCDIC 4F, and no space or comma. Up to 400 global names can be specified.

type

Requests a drive by IBM model number (such as 3420 or 3480) or user-defined class. For more information, see the chapter “Configuration Options” in the CA MIA Tape Sharing for z/VM Programming Guide. When a drive is requested by type, the response to the user will indicate which real tape drive was attached. The keywords UNIT and MODEL have identical meanings.

iname

Requests a specific drive by its real address. If you specify a list of drives, the first available drive in the list is attached. To specify a list, enter two or more real addresses separated by a vertical bar character, EBCDIC 4F, and no space or comma. Up to 400 real addresses can be specified in the list.

userid

Indicates the CMS user ID to which a tape drive will be attached. If userid is omitted, the drive will be attached to the virtual machine of the user issuing the ATTACH command. Only class B users can specify this parameter.

vaddr

Specifies the virtual address to be used when the tape drive is attached to the user.

If you do not specify vaddr, the first available address is chosen. By default, the first virtual address chosen will be 181, but you can use SETOPTION GTAF VDEFAULT to specify another beginning virtual address. CA MIM searches upward from VDEFAULT until it finds a usable virtual address for the attach.

If you specify an invalid vaddr, the ATTACH command will fail with a non-zero return code. In this case, there will be no attempt to find a valid address. Vaddr will be considered invalid if there is already any device defined or attached to the virtual address vaddr, or if there is a conflicting device type defined on another address within the same virtual control unit. For example, you cannot attach a tape drive at 190 in a z/VM system when there is already DASD at 191.

options

Any of the following are valid options:

KEEP

This causes the TIMEOUT feature to be ignored for this device until the device is detached manually. This allows the tape drive to be left idle for long periods without being detached from the user ID by CA MIA.

Note: This option can be used, but is obsolete. The TIMEOUT option can perform the same function, and is much more flexible.

NOTERM

Suppresses all CA MIA messages that are normally generated during ATTACH processing. This option is used in the CA VM:Tape interface and may also be useful when the ATTACH command is issued from an EXEC file.

QUEUE

The ATTACH request is accepted even if the tape drive is currently unavailable, and the user can continue processing. The ATTACH request will be carried out when the tape drive becomes available, and the user will be notified by a message that the request is complete. The return code is 0 if no wait was required, and 1 if the request was queued.

When the QUEUE option is specified, the user can regain control before the tape drive has been attached. (The return code will inform the user when a request is queued.) The user may observe the subsequent message or issue the QUERY command to find out if the tape drive has been attached.

This option cannot be specified with WAIT.

R/O

Applies read-only protection to a user tape. To abbreviate this parameter, specify R.

REATTACH

An option designed for external program products such as CA VM:Tape. This option allows you to detach a tape drive from the current user ID and immediately reattach it to another user ID without losing custody of the drive and without repositioning the tape. To uniquely identify the tape drive, you must identify it by the iname or xname. Requests by model or class are not permitted. The userid value identifies the user ID to which the tape drive will be reattached.

STACK

Valid only for commands issued through the MI module. When STACK is specified in the options field, responses generated by CA MIA as a result of the command are placed in the CMS program stack rather than being displayed on the screen. EXEC and REXX programs can retrieve these response lines from the stack and parse them for information. The STACK option is valid on any command issued through the MI module.

SYSTEM

Indicates that the device will be attached to a guest z/OS, or z/VM operating system, on which MIA is also running. When this option is used, it is the responsibility of MIA in the guest operating system to establish the allocated or available status of the device.

You can attach drives using the SYSTEM option, even if these drives are allocated on an external system.

When you specify the SYSTEM option, the virtual address used for the attach defaults to the real address (rdev) of the drive, instead of VDEFAULT. You can still override the default value by specifying vaddr yourself.

TIMEOUT nnn

Specifies the number of minutes the drive can be left idle before CA MIM detaches from a user. The valid range for nnn is 0 and 2-999 minutes. Use 0 to indicate that idle drive timeout is not to be enforced.

If you do not specify the TIMEOUT option on the ATTACH command, the system default value of TIMEOUT will be used. The system default timeout is set on the SETOPTION TPCF TIMEOUT command.

VOLSER vvvvvv

Specifies the volume serial number (volser) of the tape volume that the user intends to mount on the requested drive. The token, vvvvvv, following the VOLSER parameter is treated as a volume serial number, even if it is the name of some other parameter (such as STACK or SYSTEM).

WAIT nnn

Specifies that the user will suspend processing until either the ATTACH request succeeds, or the WAIT time (nnn minutes) expires. If you do not specify a value for nnn, the wait time will not expire, and a wait forever condition occurs.

A WAIT time value of 0 is not valid, and is ignored (is equivalent to WAIT without a value). If the WAIT option is not specified and if the requested drive was unavailable, processing will resume immediately, and the request will fail with a return code of 40.

WITH ASSIGN

Specifies to override the default NOASSIGN processing. This option assigns the specified tape device to the user system.

Usage Notes: ATTACH Command

The ATTACH command contains positional parameters. Therefore, you must specify parameters in the order shown in the syntax diagram.
If a class B user wants to specify a virtual address, the user must first specify a user ID. (An asterisk can be specified if the tape drive will be attached to the virtual machine of a user.)
CA MIA issues all CP ATTACH commands with the NOASSIGN option so that no ASSIGN channel commands are ever issued on behalf of the CMS user. Use the ‘WITH ASSIGN’ option to override this option.
When CA MIA attaches a tape device and the VOLSER parameter was not specified on the ATTACH command, a dummy volser is generated. This six-character volser is propagated to other systems and shows up in displays on the local system and on external systems.
The dummy volser is composed of six characters. The first four characters are equal to the global name of the drive if the global name is four digits long, or the global name followed by an equal sign (=) if the global name is three digits long. The last two characters contain the alias of the system on which the tape drive has been attached.

For example, if the device with external name 480 is attached on the system with alias 01, the dummy volser would be 480=01.
To cancel a pending ATTACH request before it is carried out to completion, use the CANCEL command.
Use the CA MIA QUERY command to display information about current pending attaches as well as summary information about authorized and unauthorized attaches since CA MIA was last started.
If an ATTACH request is pending when CA MIA terminates, the ATTACH request will be cancelled, and the requesting user will be notified.
The syntax of the MI ATTACH command does not allow specifying a range of devices. Users who want to do this can use an exec called MI EXEC, which is provided on the distribution tape. The exec intercepts MI ATTACH commands, and if a range is specified, issues a separate MI ATTACH command for each device in the range.
If the ATTACH operation does not complete within 30 seconds, CA MIA assumes it has failed and issues RC=11 and message MIM2508.

Examples: ATTACH Command

To request that the device with global name 281 be attached to the MIMGR user ID, and provide the option that the user ID may regain control before the device has been attached, enter the following:
```
MI ATTACH 281 TO MIMGR (QUEUE
```
To request that a 3420 device be attached to user ID DSIVB11, and set the permissible idle time to 30 minutes, enter the following:
```
MI ATTACH MODEL 3420 TO DSIVB11 (TIMEOUT 30
```
To request that a 3480 device be attached to your own virtual machine (if one is available), enter the following:
```
MI ATTACH MODEL 3480
```
The following examples show how to invoke the STACK option on the MI ATTACH command:
```
MI ATTACH UNIT 3480 TO * AS 181 (STACK VOLSER ABC
```
```
MI ATTACH UNIT 3480 TO * AS 181 (VOLSER ABC STACK
```
In these two examples, if you had specified the word STACK immediately following the word VOLSER, the command would not invoke the STACK option. The first token following the word VOLSER in the option field is always considered the value of the volser you are specifying. If STACK immediately follows VOLSER, it is treated as a volser name, not as an option.
This example shows how to specify a list of drives in the attach command. When you specify a list, CA MIM selects the first available drive in the list. The following example attaches the first available drive in the list. That is, global name 281, if it is available, or 282, or 283, or 284.
```
MI ATTACH 281|282|283|284 TO CMSUSER1 AS 181
```
This example works the same as the preceding one, except that the addresses are interpreted as real addresses, rather than global names.
```
MI ATTACH INT 381|382|383|384 TO CMSUSER AS 181
```
In all of these examples, the MI prefix is shown to distinguish the MI ATTACH command from the CP ATTACH command. These example commands could also be issued using the CP SMSG command. Other examples in this chapter do not show the MI prefix.

CANCEL Command-Purge Pending ATTACH Requests

The CANCEL command purges pending ATTACH requests. It has no effect on completed ATTACH requests. This command is available only if you are running CA MIA.

This command has the following format:

CANCEL {ALL | INT iname | EXT xname | USER userid}

ALL: Cancels all pending ATTACH requests.
INT: Cancels all pending ATTACH requests for the device with local name iname.
EXT: Cancels all pending ATTACH requests for the device with the global name xname.
USER: Cancels all pending requests for devices that will be attached to the indicated userid. Only by class B users can issue this.

Usage Notes: CANCEL Command

CANCEL is useful for ATTACH requests where either the QUEUE or WAIT options have been specified. If you terminate an ATTACH command with the WAIT option by specifying the CMS command HX or by pressing the PA1 key, you should use the CANCEL command.
In general, if a QUERY PENDING command shows a request to be pending, CANCEL can remove that request.

Note: Users can cancel only those ATTACH requests they have initiated themselves, unless they have z/VM privilege class B.

Examples: CANCEL Command

To cancel all pending ATTACH requests for your CMS ID, issue the following command:
```
CANCEL ALL
```
To cancel all pending requests for devices that will be attached to the MAINT user ID, a class B user can issue the following command:
```
CANCEL USER MAINT
```

DETACH Command-Request Tape Drive Detach

The DETACH command requests that a tape drive be detached from a CMS user ID. Class G users may only detach a drive that is attached to their own virtual machine, but class B users must specify the user ID from which the tape drive will be detached.

This command has the following format:

For Class G DETACH:

DETACH vaddr [LEAVE]

For Class B DETACH:

DETACH [{EXT xname | INT iname }] [FROM userid] [LEAVE]

EXT: Specifies the tape drive to be detached by global name xname. EXT is the default for class B users.
INT: Specifies the tape drive to be detached by local name iname.
LEAVE: Suppresses the REWIND/UNLOAD procedure that occurs normally when a tape drive is detached.
FROM: Indicates the CMS userid from which the tape drive will be detached.
vaddr: Specifies the virtual address of the tape drive to be detached. A class G user must specify the tape drive by virtual address.

Usage Notes: DETACH Command

The MI DETACH command is generally not needed unless you want to use the LEAVE option. The CP DETACH LEAVE command is only available for class B. It is available in some versions of z/VM, and is incompatible with CA MIA operations in some configurations.
The MI DETACH LEAVE command can be used by any class user in any release of z/VM for any type of tape drive. Class B users can issue the command MI DETACH xname FROM userid LEAVE to detach a drive from any user. Other class users are limited to detaching drives from their own virtual machine
When you do not wish to specify the LEAVE parameter, it is never necessary to use the MI DETACH command; the CP DETACH command is always appropriate.
In some cases, using the REATTACH option on the MI ATTACH command may be preferable to using MI DETACH LEAVE.
The DETACH command contains positional parameters. Therefore, you must specify parameters in the order shown in the Format box.
The syntax of the MI DETACH command does not allow specification of a range of devices. Users who want to do this can use an exec called MI EXEC, which is on the distribution tape. The exec intercepts MI DETACH commands and, if a range is specified, issues a separate MI DETACH command for each device in the range.
If the DETACH operation does not complete within 30 seconds, CA MIA assumes it has failed and issues RC=11 and message MIM2508.
If the device specified on the DETACH command is detached and then immediately attaches to another user before CA MIA detects the detach, message MIM2569 is issued even though the detach did occur.

Examples: DETACH Command

To detach a tape device at virtual address 181, a class G user can issue the following command:
```
MI DETACH 181
```
To request that the device with global name 581 be detached from user ID DSIAZ11 without rewinding and unloading the mounted volume, a class B user can issue the following command:
```
MI DET 581 FROM DSIAZ11 LEAVE
```
Note: In theses examples, the MI prefix is shown to distinguish the MI DETACH command from the CP DETACH command. These example commands could also be issued using the CP SMSG command. Other examples in this guide do not show the MI prefix.

DIAGNOSE Command-Diagnose Allocation Delays

This command allows you to diagnose the causes of allocation delays.

This command has the following format:

DIAGNOSE SYSTEMS

SYSTEMS: Displays the devices locked by each system in the complex.

Usage Notes: DIAGNOSE Command

In CA MIA, the DIAGNOSE SYSTEMS command is useful for diagnosing the inability to ATTACH drives on z/VM when the devices are being locked by z/OS systems. The DIAGNOSE SYSTEMS command shows which z/OS systems are holding locks for devices and which devices the locks are held for on each system.

Examples: DIAGNOSE Command

mi diagnose
Ready;
10:34:56 MIM0067I COMMAND DIAGNOSE
10:34:56 MIM2150I DIAGNOSE ALLOCATION DISPLAY
10:34:56   BILLS SYSTEMS DISPLAY =========>
10:34:56     ALLOCATION LOCKS ARE NOT HELD ON ANY SYSTEM 
10:34:56   END OF SYSTEMS DISPLAY

10:34:56 END OF DIAGNOSE COMMAND

DISPLAY GTAF Command-Display GTAF Information

The DISPLAY GTAF command lets you display information about the options and initialization values for the Global Tape Allocation Facility (GTAF).

This command has the following format:

DISPLAY GTAF [ALL ]
             [EXCLUDED]
             [GLOBALUNITS
               [{ALLOCATED|AVAILABLE|OVERGENNED|ONLYOVERGENNED|[MOUNTPENDING]
                    [=sysid]
                    [dddd][,number]
                    [,SYSLIST={INDEX|sysid|(sysid1,sysid2,...)}]
                    [,SYSNUM={ALL|MAX|nn}]
                    [,SYSTEM={FIRST|sysid}]
             [INIT ]
             [LOCALUNITS
               [{ALLOCATED|AVAILABLE|MOUNTPENDING|OVERGENNED|ONLYOVERGENNED}]
                    [dddd[,number]]
             [OPTIONS ]

ALL: (Optional) Displays the same information as the INIT and OPTIONS operands; that is, it displays the GTAF initialization values in message MIM2031 and the GTAF operating values in message MIM2030.

EXCLUDED: (Optional) Display the list of tape devices excluded from CA MIA management. The list is built from the contents of the EXCL MIM file.

GTAF

(Optional) Tells CA MIM to display information about GTAF rather than about any other facility. Specify this operand before the ALL, INIT, or OPTIONS operands. You also should specify the GTAF operand before any other operand that is truncated in such a way that it may be ambiguous with operands for other facilities.

Because GTAF is a positional operand, you must specify it before any other operand on the DISPLAY command.

Default: OPTIONS

GLOBALUNITS

(Optional) Displays global information about managed devices. The format of the display and the amount of information provided depend on what global display values you specified on the SETOPTION command.

The standard display is shown in message MIM2064, and the inverse display is shown in message MIM2053. GTAF displays global status information only for devices that are managed by GTAF and only for the systems on which those devices are being managed.

You can limit the display to allocated devices, available devices, or devices that have a pending mount by specifying the following operands:

ALLOCATED

Tells GTAF to include only allocated devices in the device status display.

You can use the abbreviation ALC for this operand.

To limit the display to devices allocated on a particular system, specify a system name, alias, or index number in place of sysid.

AVAILABLE

Tells GTAF to include only available devices in the device status display.

You can use the abbreviation AVL for this operand.

To limit the display to devices available on a particular system, specify a system name, alias, or index number in place of sysid.

MOUNTPENDING

Tells GTAF to include only devices with a pending mount in the status display.

You can use the abbreviation MTP for this operand.

To limit the display to devices mount-pending on a particular system, specify a system name, alias, or index number in place of sysid.

OVERGENNED

Tells GTAF to include OVERGENNED devices in the device status display.

You can use the abbreviation OVG for this operand.

ONLYOVERGENNED

Tells GTAF to include only ONLYOVERGENNED devices in the device status display.

You can use the abbreviation OOVG for this operand.

dddd (device)

Determines which is the first device shown in the display. If you are displaying local status information, then enter the local name of the device. If you are displaying global status information, then enter the global name of the device. You can enter only a single device name.

Default: For the global status display, GTAF uses the current value of the command SETOPTION GLOBALDISPLAY(DEVICE). The initial value is FIRST, which starts the display with the device that has the lowest alphanumerical global name.

For the local status display, GTAF uses the current value of the command SETOPTION LOCALDISPLAY(DEVICE). The initial value is FIRST, which starts the display with the device that has the lowest alphanumerical local name.

If a device is overgenned on all systems, then the device information is omitted from the display of global status information. If the device is overgenned on some (but not all) systems, then the device information is displayed only for the systems on which the device is not overgenned. For example, if a device is overgenned on system A and not on system B, then GTAF displays the device information only for system B.

number

Specifies the number of devices that should be included in the display. The maximum value is 999.

Default: For the display of global status information, GTAF uses the current value of the SETOPTION GLOBALDISPLAY(NUMBER=nn) command. The initial value is 8.

For the display of local status information, GTAF uses the current value of the SETOPTION LOCALDISPLAY(NUMBER=nn) command. The initial value is 8.

INIT: (Optional) Displays the GTAF initialization values that are set by the GTAINIT statement. This information is shown in message MIM2031.

LOCALUNITS

(Optional) Displays information about the local status of managed devices. GTAF shows you all managed devices unless you specifically limit the display to allocated devices, available devices, or devices that have a pending mount. This information is shown in message MIM2018.

You can limit the display to allocated devices, available devices, or devices that have a pending mount by specifying the following operands:

ALLOCATED

Tells GTAF to include only allocated devices in the device status display.

You can use the abbreviation ALC for this operand.

AVAILABLE

Tells GTAF to include only available devices in the device status display.

You can use the abbreviation AVL for this operand.

MOUNTPENDING

Tells GTAF to include only devices with a pending mount in the status display.

You can use the abbreviation MTP for this operand.

z/VM systems are never in mount pending status, but from a z/VM system, you can display mount pending in z/OS systems.

dddd (device)

number

Specifies the number of devices that should be included in the display. The maximum value is 999.

Default: For the display of global status information, GTAF uses the current value of the SETOPTION GLOBALDISPLAY(NUMBER=nn) command. The initial value is 8.

For the display of local status information, GTAF uses the current value of the SETOPTION LOCALDISPLAY(NUMBER=nn) command. The initial value is 8.

OPTIONS: (Optional) Displays the GTAF operating values that can be set using the SETOPTION command. This information is shown in message MIM2030.

SYSLIST

(Optional) Determines the order of the systems in the DISPLAY GLOBALUNITS display for the current display only.

Specify full system name, two-character system alias, or two-digit system index number for the sysid variables. A system you identify for sysid must be defined to CA MIM using the DEFSYS statement. Specifying a value of INDEX causes systems to be displayed in order of system index number.

Note: INDEX must be fully qualified, so as to distinguish it from a possible valid system ID.

Default: Value specified by the SETOPT GTAF GLOBALDISPLAY=SYSLIST command.

SYSNUM

(Optional) Determines the number of the systems in the DISPLAY GLOBALUNITS display for the current display only. The following are valid values:

ALL

This value causes all systems to be displayed, and is the equivalent of specifying SYSNUM=32.

MAX

Causes the maximum number of systems possible for the format of the display (STANDARD or INVERSE) to be displayed, without wrapping of the STANDARD display. For INVERSE format, the maximum number of systems displayed is unlimited (meaning MAX value is the same as ALL value). For STANDARD format, the maximum number of systems displayed is limited by the width of the console display.

Note: This value generates the same displays as in previous versions of CA MIM without the SYSNUM option.

nn

Specifies the number of systems to be displayed. For INVERSE format, the number of systems displayed may be reduced if nn is less than the maximum number of systems. For STANDARD format, a wrapped display is generated if nn exceeds the maximum number of systems that can be displayed on one line.

Default: Value specified by the SETOPT GTAF GLOBALDISPLAY=SYSNUM command.

SYSTEM

(Optional) Determines which is the first system shown in the display. Enter a full system name, two-character system alias, or two-digit system index number for the sysid variable. The system you identify for sysid may be defined to CA MIM using the DEFSYS statement.

Specifying the value of FIRST causes the first system in the current display to be the system with the lowest index number. In addition, FIRST must be fully qualified so as to distinguish it from a possible valid system id.

Default: GTAF uses the current value set with the SETOPTION GTAF GLOBALDISPLAY SYSTEM command.

Usage Notes: DISPLAY GTAF

The DISPLAY command can be specified in the CMNDS MIM or SYNCH MIM files. When you specify this command in the CMNDS MIM file and the TRACE feature is active, the output is sent to the TRACE file. When you specify this command in the SYNCH MIM file, the output is sent to the console log.
You also can issue the DISPLAY GTAF command from the service virtual machine console or from any CMS user ID.
You cannot specify the GLOBALUNITS or LOCALUNITS parameter with any other parameters on the DISPLAY command. Do not specify GTAF parameters with parameters associated with other facilities.
The DISPLAY command contains positional parameters. For information on what order to specify these positional parameters, see the DISPLAY GTAF Command in this chapter. If you skip the ddd (device) parameter, you must specify an additional comma before the number parameter, as in DISPLAY GLOBAL,,32.
You can control the format and the amount of information shown in the display of global status information and local status information by setting values for the GLOBALDISPLAY and LOCALDISPLAY parameters on the SETOPTION command.
To provide compatibility with CA MIA for z/OS, commas can also be used as delimiters. In that case, the command syntax will be identical to the syntax shown in the CA MIM for Resource Sharing for z/OS Statement and Command Reference.

Example: DISPLAY GTAF Command

To display the current initialization and operation values for only GTAF, issue this command:

DISPLAY GTAF ALL

DISPLAY TPCF Command-Display TPCF Information

The DISPLAY TPCF command lets you display information about the options and initialization values for the Tape Preferencing and Control Facility (TPCF).

This command has the following format:

DISPLAY TPCF [CLASS [{=* | =class | =(class1,class2…)}] 
             [DEVICEGROUPS] 
             [JOBRESERVE ,[dddd]
                                     ,[number]] 
             [LOCALUNITS  
                        [{ALLOCATED]|
                                     AVAILABLE|
                                    MOUNTPENDING|
                                    OVERGENNED|
                                    ONLYOVERGENNED}]
                                        ,[dddd]
                                        ,[number]
             [OPTIONS]

CLASS

Displays information about user-defined tape classes and the predefined tape classes (IBM model numbers).

If no value is specified with the CLASS parameter, a list of all tape classes is displayed.

If a class name or list of class names is specified, the display shows the devices that are members of each class.

If an asterisk (*) is specified, the display includes a list of all tape classes and the devices that are members of each class.

class: Indicates which user-defined or predefined tape class should be displayed (for example: 3480).

DEVICEGROUPS: Displays a list of user-defined and predefined tape classes (IBM model numbers). This parameter is similar to the CLASS parameter and is supported for compatibility with CA MIM for z/OS.

JOBRESERVE

(Optional) Displays global information about devices that have been reserved for certain jobs. This information is displayed in message MIM2019.

If you specify RESERVE=YES on a SETOPTION command, you can then display this information by issuing the DISPLAY TPCF GLOBALUNITS command.

LOCALUNITS

(Optional) Displays information about the local status of managed devices. TPCF shows you all managed devices unless you limit the display through the ALLOCATED, AVAILABLE, or MOUNTPENDING operands. This information is displayed in message MIM2018.

ALLOCATED

Tells TPCF to include only allocated devices in the device status display.

You can use the abbreviation ALC for this operand.

AVAILABLE

Tells TPCF to include only available devices in the device status display. You can use the abbreviation AVL for this operand.

MOUNTPENDING

Tells TPCF to include only devices with a pending mount when displaying device status information. You can use the abbreviation MTP for this operand.

OVERGENNED

Tells TPCF to include OVERGENNED devices in the device status display.

You can use the abbreviation OVG for this operand.

ONLYOVERGENNED

Tells TPCF to include only ONLYOVERGENNED devices in the device status display.

You can use the abbreviation OOVG for this operand.

dddd (device)

Determines which is the first device shown in the display. Enter the local name of the device. You can enter only a single device name.

Default: TPCF uses the current value of the command SETOPTION LOCALDISPLAY(DEVICE=dddd). The initial value is FIRST, which starts the display with the device that has the lowest alphanumerical local name.

number

Indicates how many devices are to be included in the display.

Default: TPCF uses the value set for the SETOPTION LOCALDISPLAY(NUMBER=n) command. The initial value is 8.

Notes:

TPCF omits devices with overgenned status from this display.
The D TPCF LOCALUNITS and D GTAF LOCALUNITS commands are equivalent.

ALLOCATED

Tells TPCF to include only allocated devices in the device status display.

You can use the abbreviation ALC for this operand.

AVAILABLE: Tells TPCF to include only available devices in the device status display. You can use the abbreviation AVL for this operand.

MOUNTPENDING: Tells TPCF to include only devices with a pending mount when displaying device status information. You can use the abbreviation MTP for this operand.

number

Indicates how many devices are to be included in the display.

Default: TPCF uses the value set for the SETOPTION LOCALDISPLAY(NUMBER=n) command. The initial value is 8.

Notes:

TPCF omits devices with overgenned status from this display.
The D TPCF LOCALUNITS and D GTAF LOCALUNITS commands are equivalent.

OPTIONS: (Optional) Displays the TPCF operating values that can be set using the SETOPTION command. This information is displayed in message MIM2034.

Usage Notes: DISPLAY TPCF Command

You cannot specify the JOBRESERVE or LOCALUNITS operands with the OPTIONS operand. Do not specify TPCF operands with operands associated with other facilities.
If you skip the dddd operand, then specify an extra comma in its place.
Use the LOCALDISPLAY operand on the SETOPTION command to control the amount of information shown in the local status display.

The DISPLAY command can be specified in the CMNDS MIM or SYNCH MIM files. When you specify this command in the CMNDS MIM file and the TRACE feature is active, the output is sent to the TRACE file. When you specify this command in the SYNCH MIM file, the output is sent to the console log.
You also can issue the DISPLAY command from the service virtual machine console or from any CMS user ID.
You cannot specify the JOBRESERVE or LOCALUNITS parameter with the OPTIONS parameter. Do not specify TPCF operands with operands associated with other facilities.
If you skip the device parameter, specify an extra comma in its place.
You can control the format and the amount of information shown in the display of global status information and local status information by setting values for the GLOBALDISPLAY and LOCALDISPLAY parameters on the SETOPTION command.
To provide compatibility with CA MIA on z/OS operating systems, commas can also be used as delimiters. In that case, the command syntax will be identical to the syntax shown in the CA MIM Resource Sharing for z/OS Statement and Command Reference.

Example: DISPLAY TPCF Command

To display only devices with a pending mount, issue this command:

DISPLAY LOCALUNITS MOUNTPENDING

To display only allocated devices, issue the following command:

DISPLAY TPCF LOCALUNITS ALLOCATED