Displaying OSMC task status

The following command syntax displays OSMC task status:


>>-+-DISPLAY-+--SMS,OSMC,TASK-(taskname)-+----------------+----><
   '-D-------'                           '-,L=-+-a------+-'   
                                               +-name---+     
                                               '-name-a-'

To display the status of an OSMC task, enter the following command:

DISPLAY SMS,OSMC,TASK(taskname)

This results in F OAM,D,OSMC,taskname command being issued.

OSMC

Displays OSMC task status

TASK(taskname)

Specifies the name of the task for which a status display is requested

The value of the task name depends on the type of OSMC process which the task represents. The following list shows the type of OSMC process, and the value used for its name.

Library space management: The library name
Volume recovery: The volume serial of one of the volumes on the disk being recovered
DASD space management: The name of the storage group being processed by DASD space management
OSMC processing of one storage group: The name of the storage group being processed
Storage management cycle processing of a storage group: The name of the storage group being processed
Move volume: The volume serial of the source volume from which objects are being moved
Recycle: The name of the volser being processed as a result of the RECYCLE command. RECYCLE is an accepted value.

L={a | name | name-a}: Specifies the location where the results of the inquiry are to be displayed, where name is the console name, and a is the display area on the console screen.

NOT programming interface information

Detail status information is provided for the OAM storage management component task specified in the DISPLAY command. The number of internal work items queued on the work and wait queues and the number of internal work items completed for each of the OSMC services is displayed. The number of internal work items does not exactly equate to the number of objects processed; there might be multiple internal work items per object or there might be internal work items not associated with any object. This information is better used for problem determination and monitoring the progress of the storage management component than for tracking the number of objects processed.

End of NOT programming interface information

The fields displayed in each data line represent the services that OSMC performs during its processing. The following information is displayed:

CBR9370I OSMC Detail for taskname:     
           READ      READ     READ     READ
           DISK1    DISK2      OPT     TAPE
WORK Q: aaaaaaaa bbbbbbbb cccccccc dddddddd
WAIT Q:          eeeeeeee ffffffff gggggggg
DONE:   hhhhhhhh iiiiiiii jjjjjjjj kkkkkkkk
           WRITE    WRITE    WRITE    WRITE    WRITE
           DISK1    DISK2      OPT    TAPE1    TAPE2
WORK Q: llllllll mmmmmmmm nnnnnnnn oooooooo pppppppp
WAIT Q:          qqqqqqqq rrrrrrrr ssssssss tttttttt
DONE:   uuuuuuuu vvvvvvvv wwwwwwww xxxxxxxx yyyyyyyy
           WRITE    WRITE      DIR
         BACKUP1  BACKUP2    UPDTS
WORK Q: zzzzzzzz 11111111 22222222
WAIT Q: 33333333 44444444 55555555
DONE:   66666666 77777777 88888888
End of Display Detail

In the message text, taskname is the name associated with the OAM storage management component task and is the same as the task name specified on the DISPLAY SMS,OSMC command. In the case of the OAM storage management cycle, taskname is the name of an Object storage group being processed by OSMC. In the case of the OAM MOVEVOL utility, taskname is the volume serial number of the volume being operated on by the utility. For the OAM Volume Recovery utility, taskname is the volume serial number of the optical or tape cartridge being recovered by the utility.

The fields that are displayed in each row represent the number of internal work items (n) that are at that stage of processing for each service:

WORK Q: Work items queued for processing by this service
WAIT Q: Work items for which processing has started but not completed
DONE: Work items that have completed using this service

The values in the display for CBR9370I are defined as follows:

aaaaaa: The number of internal work items that are queued on the work queue by the read disk sublevel 1 service.
bbbbbb: The number of internal work items that are queued on the work queue by the read file system service
cccccc: The number of internal work items that are queued on the work queue by the read optical service.
dddddd: The number of internal work items that are queued on the work queue by the read tape service. This read service reads from both tape sublevel 1 and tape sublevel 2.
eeeeee: The number of internal work items that are queued on the wait queue by the read file system service
ffffff: The number of internal work items that are queued on the wait queue by the read optical service.
gggggg: The number of internal work items that are queued on the wait queue by the read tape service. This read service reads from both tape sublevel 1 and tape sublevel 2.
hhhhhh: The number of internal work items that are completed by the read disk sublevel 1 service.
iiiiii: The number of internal work items that are completed by the read file system service.
jjjjjj: The number of internal work items that are completed by the read optical service.
kkkkkk: The number of internal work items that are completed by the read tape service. This read service reads from both tape sublevel 1 and tape sublevel 2.
llllll: The number of internal work items that are queued on the work queue by the write disk sublevel 1 service.
mmmmmm: The number of internal work items that are queued on the work queue by the write file system service.
nnnnnn: The number of internal work items that are queued on the work queue by the write optical service.
oooooo: The number of internal work items that are queued on the work queue by the write tape sublevel 1 service.
pppppp: The number of internal work items that are queued on the work queue by the write tape sublevel 2 service.
qqqqqq: The number of internal work items that are queued on the wait queue by the write file system service.
rrrrrr: The number of internal work items that are queued on the wait queue by the write optical service.
ssssss: The number of internal work items that are queued on the wait queue by the write tape sublevel 1 service.
tttttt: The number of internal work items that are queued on the wait queue by the write tape sublevel 2 service.
uuuuuu: The number of internal work items that are completed by the write disk sublevel 1 service.
vvvvvv: The number of internal work items that are completed by the write file system service.
wwwwww: The number of internal work items that are completed by the write optical service.
xxxxxx: The number of internal work items that are completed by the write tape sublevel 1 service.
yyyyyy: The number of internal work items that are completed by the write tape sublevel 2 service.
zzzzzz: The number of internal work items that are queued on the work queue by the write first backup service.
111111: The number of internal work items that are queued on the work queue by the write second backup service.
222222: The number of internal work items that are queued on the work queue by the directory update service.
333333: The number of internal work items that are queued on the wait queue by the write first backup service.
444444: The number of internal work items that are queued on the wait queue by the write second backup service.
555555: The number of internal work items that are queued on the wait queue by the directory update service.
666666: The number of internal work items that are completed by the write first backup service.
777777: The number of internal work items that are completed by the write second backup service.
888888: The number of internal work items that are completed by the directory update service.

Figure 1 is a sample of DISPLAY SMS,OSMC,TASK(WG360A):

Figure 1. Sample of DISPLAY SMS,OSMC,TASK(WG360A)

            READ     READ     READ     READ
           DISK1    DISK2      OPT     TAPE
WORK Q:        0        0        1        0
WAIT Q:                 0        3        0
DONE:          0        0        1        1
           WRITE    WRITE    WRITE    WRITE    WRITE
           DISK1    DISK2      OPT    TAPE1    TAPE2
WORK Q:        0        0        0        0        0
WAIT Q:                 0        0        0        0
DONE:          0        0        0        0        0
           WRITE    WRITE      DIR
         BACKUP1  BACKUP2    UPDTS
WORK Q:        0        0        0
WAIT Q:        0        0        0
DONE:          0        0        0
End of Display Detail

If execution of the D SMS,OSMC,TASK(RECYCLE) command is successful, the system issues the following message to hardcopy log:

CBR9875I Recycle Candidates:  
The following volumes are candidates for OAM RECYCLE command processing using 
pv=nnn, lim=nn, scope=scope, maxrecycletasks=nn, TSL=1|2|-
   VOLSER %VAL SGNAME   STAT    VOLSER %VAL SGNAME   STAT      
   Volser nnn  grpname  xxxx    volser nnn  grpname  xxxx 
   Volser nnn  grpname  xxxx    volser nnn  grpname  xxxx
OAM Recycle: End of OAM Recycle candidate volumes. Total volumes=nnnn.

Related reading: For an example of output for message CBR9370I, see Figure 1. For descriptions of the column headings for CBR9370I, see z/OS MVS System Messages, Vol 4 (CBD-DMO).