CA MIA Statements and Commands › (MIA) DIAGNOSE Command-Diagnose Allocation Delays

(MIA) DIAGNOSE Command-Diagnose Allocation Delays

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

Scope: Local

This command has the following format:

DIAGNOSE [ALL]
         [EDT]
         [GROUP]
         [JOBSTATUS={ALL|DELAYED|DEVICES|GIVEN|RELEASED|WAITING}]
         [SYSTEMS]
         [VARY]

ALL

(Optional) Displays the information for JOBSTATUS, SYSTEMS, and VARY. This is the default for the DIAGNOSE command.

EDT

(Optional) Displays the current device generics/esoterics, referenced by each tape UNITNAME. It lists the devices contained in each generic/esoteric.

GROUP

(Optional) Displays the tape device groups currently being managed by CA MIA.

JOBSTATUS

(Optional) Lists jobs currently in allocation and their lock status. You can specify one of the following:

ALL

(Optional) Shows jobs for all of the JOBSTATUS options.

DELAYED

(Optional) Shows jobs that have requested device locks and are being delayed by CA MIA.

DEVICES

(Optional) Shows jobs that have been released by GTAF that are being delayed by z/OS because of another job that is currently using the specific device.

GIVEN

(Optional) Shows jobs that have been released by GTAF and have been given control of device locks by z/OS.

RELEASED

(Optional) Shows jobs that have requested device locks and are not being delayed by CA MIA (but may be delayed by z/OS).

WAITING

(Optional) Shows jobs that have been released by GTAF that are being delayed by z/OS because of another job that already owns the locks.

Default: JOBSTATUS=ALL

SYSTEMS

(Optional) Displays devices locked on each system in the complex.

VARY

(Optional) Displays the status of any VARY device request that is:

• Actively being processed
• Queued for processing

Also displays:

• The number of duplicate VARY commands discarded since CA MIA startup.
• The number of VARY commands purged since CA MIA startup.

Example: DIAGNOSE Command

In the following example of the DIAGNOSE ALL command, system XE13 is identified in the SYSTEMS DISPLAY portion of the MIM2150I as holding both the 'A' and 'B' device group locks for devices 740 through 747. No other task running on any system in the MIAplex will be able to enter allocation if any of these devices appear on its EDL.

In the JOBSTATUS DISPLAY, GTAF is delaying the request of TAPE3 for 'A' locks. This is because the locks requested by TAPE3 are held by a task on system XE13. Job TAPE3 would be displayed as waiting for a shared ENQ on resource GTALOCAL/Waiting_For_Device_Group_Locks in a display of ENQ contention for Resource GTALOCAL.

Job TAPE2 has gone into allocation recovery, where a reply of WAIT/NOHOLD was entered for it. This job waits on the z/OS Waiting-For-Devices chain, and will be redriven through allocation when one of the listed devices deallocates or a CA MIA Vary Available is issued for a listed device.

MIM2150I DIAGNOSE ALLOCATION DISPLAY
  BEGIN SYSTEMS DISPLAY =========> 
    System XE13 has 'AB' locks for devices 
       740  741  742  743  744  745  746  747 
  END OF SYSTEMS DISPLAY
  BEGIN JOBSTATUS DISPLAY =======> 
  JOBSTATUS: DELAYED
    GTAF is delaying TAPE3's request for 'A' group locks for devices
       740  741  742  743  744  745  746  747 
  JOBSTATUS: RELEASED
    NO ENTRIES FOR JOBSTATUS.RELEASED
  JOBSTATUS: WAITING
    NO ENTRIES FOR JOBSTATUS.WAITING
  JOBSTATUS: GIVEN
    NO ENTRIES FOR JOBSTATUS.GIVEN
  JOBSTATUS: WAITING FOR DEVICES
    MVS has TAPE2 waiting for devices, REPLY WAS NOHOLD
       A60   A61   A62   A63
  END OF JOBSTATUS DISPLAY
  BEGIN managed VARY display =>
	No managed VARY in progress
  END managed VARY display
END OF DIAGNOSE COMMAND