Command Processor subtask (CMDPROC)

You can use the Command Processor to communicate with the Real-Time SMF process.

The Command Processor is activated in the VFISTASK member by this specification:

START TASK=CMDPROC,PGM=CKKRC004                           < CMD PROCSR

A sample JCL stream that interfaces with the Command Processor is in hlq.CNTL(RTCMDB):

//RTCMD         EXEC PGM=CKKRC008,                                          
//                     PARM='DISPLAY SUBTASKS'                                
//*                    PARM='INVMSTRT INVMAINT'                               
//*                    PARM='INVMSTRT INVREMOV'                               
//*                    PARM='REFRESH EXCLDSN'                                 
//*                                                                   
//STEPLIB       DD DISP=SHR,DSN=hlq.SCKKLOAD                    
//*                                                                   
//CMDQUEUE      DD DISP=SHR,DSN=hlq.RTCMDQ                      
//*HOSTID       DD DISP=SHR,DSN=hlq.CNTL(HOSTID)               
//RTDPRINT      DD SYSOUT=*                                               
//SNAP          DD SYSOUT=*                                               
//ERRLOG        DD SYSOUT=*                                               
//SYSPRINT      DD SYSOUT=*                                               
//SYSABEND      DD SYSOUT=*

A sample REXX EXEC that interfaces with the Command Processor is in hlq.CNTL(RTCMD):

"ALLOC     F(CMDQUEUE) DA('HLQ.RTCMDQ') SHR REU"             
"CALL      'HLQ.SCKKLOAD(CKKRC006)'"                          
"FREE      F(CMDQUEUE)"

Submit the hlq.CNTL(RTCMDB) job to issue commands to the Command Processor.

The following commands can be supplied in the PARM field of the RTCMDB job.

Table 1. RTCMDB Job Parameters
Command	Description
DIAGNOSE xxxxxxxx	Activates diagnostics for subtask xxxxxxxx.
DIAGNOSE xxxxxxxx.RSC=yyy	Activates diagnostics for resource yyy within subtask xxxxxxxx.
DIAGNOSE xxxxxxxx,OFF	Deactivates diagnostics for subtask xxxxxxxx.
DISPLAY SUBTASK	Displays RT/SMF Dispatcher subtasks.
DISPLAY SUBTASK=xxxxxxxx	Displays subtask information for the specified subtask. You can specify either the program name or the subtask name, as shown in Table 1.
DISPLAY OATS	Displays the Open Application Table entries and status.
DISPLAY CPU	Displays CPU usage for Real-Time SMF.
DISPLAY STORAGE	Displays all storage in use by Real-Time SMF.
DISPLAY STORAGE=xxxxxxxx	Displays the storage in use by Real-Time SMF for subtask xxxxxxxx.
DISPLAY TABLES	Displays information regarding the system tables such as APPTABLE. The display lists the table, program loader, file type, status, load time, PDS member (if applicable), and file number.
DISPLAY SMF	Displays the status of processing of each SMF data set for each system defined including SMF$ data sets, if applicable. It also displays the last record date/time.
REFRESH EXCLDSN	Refreshes the EXCLDSN list of data sets to be excluded from IZBR processing.
REFRESH EXCLJOB	Refreshes the EXCLJOB list of jobs to be excluded from IZBR processing.
REFRESH INCLDSN	Refreshes the INCLDSN list of data sets to be included in IZBR processing.
REFRESH SCHDREQ	Refreshes the SCHDREQ scheduling criteria for dynamic data set scheduling.
REFRESH MEMPLATE	Refreshes the MEMPLATE list of grouped data sets for the Inventory file.
REFRESH REPLMETH	Refreshes the REPLMETH list of replacement backup methods for Backup Detection processing.
REFRESH REPLPGM	Refreshes the REPLPGM list of replacement programs for Backup Detection processing.
REFRESH EXCLDDNS	Refreshes the EXCLDDNS list of DD jobs to be excluded from Backup Detection processing.
RESTORE SMFDATAx	Restores activity to a removed SMF data set. The x suffix indicates the system you want to reinstate for processing, for example SMFDATA1 (system 1) or SMFDATA2 (system 2).
STARTVRS	Starts the Virtual Recovery Simulator subtask. The process begins at the next RT/SMF Dispatcher checkpoint and continues for 24 hours or until a STOPVRS request is issued. See Virtual Recovery Simulator.
STOP	Initiates the Real-Time SMF termination process. The facility can also be stopped via console 'P' command issued for the Real-Time SMF processor.
STOPVRS	Halts the Virtual Recovery Simulator subtask.

A sample DISPLAY SUBTASKS report follows. The report is directed to the RTDPRINT DD statement in the COLLECT or RTSMF JCL.

Figure 1. Sample Display Subtasks Report

RTSC00410I - DISPLAY  - COMMAND IN PROCESS     
DRVFI RT/SMF:SUBTASK  DISPLAY                  
                                               
EYECATCHER: RTSRTDSB                           
  SUB-POOL/LENGTH: 02002150   ADDRESS: 00035EB0
  MAX SUBTASKS:          33   ACT SUBTASKS:   8
                                               
  TASKNAME  PROGRAM   TCB ADDR CPU TIME        
  --------  --------  -------- ----------      
  SMFALLOC  CKKRC030  ******** 00:00:00.0      
  CMDPROC   CKKRC004  008CB118 00:00:00.0      
  IZBR/RTA  BRNVC001  008C8D90 00:00:00.0      
  SMFCOUNT  CKKRT999  008C8760 00:00:00.0      
  RT/HNDLR  CKKRC033  008C84F8 00:00:00.0      
  INVMAINT  BRNVC059  008C8198 00:00:00.0      
  RT/ICP    CKKRC036  008C6E88 00:00:00.0      
  JOBHIST   BRNJSUBT  008C6BB0 00:00:00.0      
                                               
DRVFI RT/SMF:SUBTASK  DISPLAY COMPLETE         
***