(MIA) DUMP GTAF/TPCF Command-Create DUMP

CA MIA Statements and Commands › (MIA) DUMP GTAF/TPCF Command-Create DUMP

(MIA) DUMP GTAF/TPCF Command-Create DUMP

CA Technical Support uses the DUMP command for diagnostic purposes for problems that occur with the GTAF or TPCF facilities.

Important! This command is to be used only when you are directed by CA Technical Support to do so.

Scope: Local

This command has the following format:

DUMP {GTAF|TPCF} [{ACEJ |
                 DNE |
                 DLIST |
                 DTOKEL |
                 DVE |
                 FORMAT,dev [,devn ] |
                 GRP |
                 M0AREA |
                 M1AREA |
                 M2AREA}]

ACEJ: Displays the contents of the ACEJ control block.

DNE: Displays the contents of the DNE control block.

DLIST: Displays the contents of the DLIST control block.

DTOKEL: Displays the contents of the DTOKEL control block.

DVE: Displays the contents of the DVE control block.

FORMAT: Displays the contents of the DVE and DLIST control blocks, starting with device dev for the number of devices devn.

GRP: Displays the contents of the GRP control block.

M0AREA: Displays the contents of the M0AREA control block.

M1AREA: Displays the contents of the M1AREA control block.

M2AREA: Displays the contents of the M2AREA control block.

Usage Notes: DUMP GTAF/TPCF Command

This command is solely intended for use as a diagnostic tool under the direction of CA Technical Support.
The displays generated by this command are unformatted and not usable if you are unfamiliar with the CA MIA internal control blocks.
Some operands of this command may cause serious performance degradation of CA MIA and its facilities.

Example: DUMP Command

To dump the contents of the M1AREA control block, issue this command:

DUMP GTAF M1AREA

QUERY Command-Display Pending Device Information

The QUERY command displays pending ATTACH requests and status information for devices managed by CA MIA.

This command has the following format:

QUERY [{[{EXT xname | INT iname}] | 
         PENDING | 
         STATUS iname |
         SUMMARY |
         USER userid }]

EXT: Lists all pending ATTACH requests for the device with global name xname. Output format is the same as for QUERY PENDING.

INT: Lists all pending ATTACH requests for the device with the local name (real address) iname. Output format is the same as for QUERY PENDING.

PENDING: Lists all pending ATTACH requests in the local system. For the output format, see message MIM2511.

STATUS: Displays the status of locally known tape devices. Devices are specified by the local name (real address) iname. You can enter a single device name or a range of device names. If no device is specified, all managed devices will be displayed. For the output format, see message MIM2018.

SUMMARY: Displays a summary of local activity for CA MIA. The summary includes a count of ATTACH requests carried out by CA MIA, a count of unauthorized uses of the CP ATTACH command, and a count of VARY CPON commands. It also includes a count of ATTACH requests that were either cancelled or rejected because of unavailable tape drives.

USER: Lists all pending ATTACH requests for devices that will be attached to the indicated userid. Output format is the same as for QUERY PENDING.

Usage Notes: QUERY Command

All forms of the QUERY command are non-privileged. They can be issued by any user having USER authorization. The STATUS parameter produces a display of information similar to that produced by the DISPLAY LOCALUNITS command, but includes more data.
When specifying a range of devices with the STATUS parameter, use a hyphen as a delimiter between devices.

Examples: QUERY Command

To display the status of all locally known devices managed by CA MIA, enter the following command:
```
MI QUERY STATUS
```
To display the status of the managed devices with local names (real addresses) 580, 581, and 582, enter the following command:
```
MI QUERY STATUS 580-582
```
To display all pending ATTACH requests for the device with local name (real address) 581, enter the following command:
```
MI QUERY INT 581
```

Note: In these examples, the MI prefix is shown to distinguish the MI QUERY command from the CP QUERY command. You could also issue these example commands using the CP SMSG command. Other examples in this section do not show the MI prefix.