Display Commands
Display commands include HELP and SHOW commands.
HELP Command
The HELP command lists all the available commands. If an appropriate value in Substation ES SIP is set for CONSOLE-MSG, the command and the result are echoed on the Master Console display.
The HELP command is also available for an individual command, such as SHOW, SET, and so on. If you specify a command with HELP, a list of the keywords associated with the command is displayed as follows:
HELP
HELP,SET
SHOW Command
The SHOW command inquires into Substation ES statistics, usage, and other useful information.
The typical usage of the SHOW command is listed as follows:
- SHOW,ACTIVE|ACT,LISTENERS|LSNS[,INTF|IID=intf-id]
- This command shows all active listeners in Substation ES. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,ACTIVE|ACT,RECIPE|RID[,INTF|IID=intf-id]
- This command shows all the loaded recipes in Substation ES. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,ACTIVE|ACT,TRIGGER|TID[,INTF|IID=intf-id]
- This command shows all the active triggers in Substation ES. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,CICS,“CEMT Sub-command”[,INTF|IID=intf-id]
- This command issues the equivalent of CEMT on the CICS backend systems. The command submits a CICS 3270 task to be executed in the interface CICS regions. Only INQUIRE sub-commands are supported. The keyword INTF|IID=intf-id specifies the interface that must be the identifier used in the Substation ES CICS SIP member.
- SHOW,CICS,SXTH[,Sub-command][,INTF|IID=intf-id]
- This command issues the equivalent of SXTH on the CICS backend systems which communicate with Substation ES. The command submits a CICS 3270 task to be executed in the interface CICS regions. The keyword INTF|IID=intf-id specifies the interface that must be the identifier used in the Substation ES CICS SIP member.
- SHOW,COUNTERS
- In Substation ES, counters are synonymous with running totals. Substation ES gathers information from all Substation ES interfaces that support counters. Counters differ by interface types because of their disparate processing requirements.
- SHOW,DISABLED|DISA[,INTF|IID=intf-id]
- This command shows all disabled recipes and triggers. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,DISABLED|DISA,LISTENERS|LSNS[,INTF|IID=intf-id]
- This command shows all disabled listeners. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,DISABLED|DISA,RECIPE|RID[,INTF|IID=intf-id]
- This command shows all disabled recipes. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,DISABLED|DISA,TRIGGER|TID[,INTF|IID=intf-id]
- This command shows all disabled triggers. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,EMS,STATS,RECIPE|RID=name[,INTF|IID=intf-id]
- This command shows the statistics of this recipe. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,ESB|TPORT[,INTF|IID=intf-id]
- This command shows the status information of all transports (ESB) within the current Substation ES instance. The optional keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,IMS,BUFFER
- The Information Management System (IMS) commands show the information on one or more IMS interfaces that are active within the current Substation ES instance. This command shows the information on the Open Transaction Manager Access (OTMA) buffers currently in use.
- SHOW,IMS,STATS
- The IMS commands show the information on one or more IMS interfaces that are active within the current Substation ES instance. This command shows the information on the OTMA interface.
- SHOW,IMS,CONNECT
- The IMS commands show the information on one or more IMS interfaces that are active within the current Substation ES instance. This command shows the IMS connection status.
- SHOW,IMS,XCF
- The IMS commands show the information on one or more IMS interfaces that are active within the current Substation ES instance. This command shows the information on the IMS XCF connection.
- SHOW,INTF|IID
- This command shows the information on all interfaces and their states.
- SHOW,INTF|IID=name
- This command shows the information on the specified interface and its state.
- SHOW,INTF|IID[,CONNECT|CONN]
- This command shows the information on all the connection states of all interfaces.
- SHOW,INTF|IID=name[,CONNECT|CONN]
- This command shows the information on the connection state of the specified interface.
- SHOW,LOGSTATS
- This command shows the information on the current active log disk file.
- SHOW,LOGSTATS,ALL
- This command shows the information on all currently active log disk files.
- SHOW,LOGSTATS,DETAIL
- This command shows the statistical information on each active log disk file.
- SHOW,LTAVERS
- This command shows the version number of the Logging, Tracing, and Auditing (LTA) agents.
- SHOW,QUE
- This command shows the internal queue values of each interface.
- SHOW,QUE,LOCK
- This command freezes the system and performs the SHOW,QUE command. See SHOW,SYS,LOCK for an explanation of the LOCK keyword.
- SHOW,RED,BUFFER
- This command shows information on the RED interface messages pool buffers currently in use within Substation ES.
- SHOW,RED,LIMIT
- This command shows RED parameters set up on the RED interface.
- SHOW,RED,SENDER=*| XCF Sender name
-
This command shows the statistics information on the RED interface Sender threads currently in use within Substation ES. If the * is present will show all Sender threads. Or with a specific XCF Sender name present will only show the statistics information for that one Sender thread.
You may use the console command /D XCF,GRP,[CICS APPLID] to get the Sender names in this CICS system. In the example below the CICS system C512WW3G was the source of the RED data.
The sample command SHOW,RED,SENDER=* output is as follows:SXA2601I Console Command 'SHOW,RED,SENDER=*' SXG2690I Operations Request executed successfully SXG2077I Operational Request Feedback for IId:REDEA1 Statistics for Member:C512WW3G.REDEA1$47#00.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#01.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#02.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#03.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#04.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#05.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#06.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#07.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#08.Active Sent-C:200 Recv:200 R/R:200 Statistics for Member:C512WW3G.REDEA1$47#09.Active Sent-C:200 Recv:200 R/R:200 * End-of-Data * SXA2666I End-of-Command
The sample command SHOW,RED,SENDER=REDEA1$47#01 output is as follows:SXA2601I Console Command 'SHOW,RED,SENDER=REDEA1$47#01' SXG2690I Operations Request executed successfully SXG2077I Operational Request Feedback for IId:REDEA1 Statistics for Member:C512WW3G.REDEA1$47#01 System:LION Job:QASS11RE RED:NONE(0) XCF:Active(3) Sent-C:200 Recv:200 R/R:200 * End-of-Data * SXA2666I End-of-Command
- SHOW,RED,“CEMT Sub-command”[,INTF|IID=intf-id]
- This command issues the equivalent of CEMT on the CICS backend systems. The command submits a CICS 3270 task to be executed in the RED interface CICS regions. Only INQUIRE sub-commands are supported. The keyword INTF|IID=intf-id specifies the interface that must be the identifier used in the Substation ES CICS SIP member. If the INTF|IID=intf-id is not specified, the command will send to all RED interfaces BES. For example:
- SHOW,RED,"XTUV[,Sub-command"][,INTF|IID=intf-id]
- This command issues the equivalent of XTUV on the CICS backend systems which communicate with Substation ES. The command submits a CICS 3270 task to be executed in the RED interface CICS regions. The keyword INTF|IID=intf-id specifies the interface that must be the identifier used in the Substation ES CICS SIP member. If the INTF|IID=intf-id is not specified, the command will send to all RED interfaces BES. For example:
- SHOW,RECIPE|RID|TRIGGER|TID=name,INTF|IID=intf-id
- This command shows the active recipe or trigger configuration information that is currently loaded in Substation ES. The keyword INTF|IID=intf-id specifies an ESB interface identifier.
- SHOW,RV,DISPQ
- This command shows the current number of messages in a Rendezvous worker dispatcher queue.
- SHOW,RV,DQ-DISPQ
- This command shows the current number of messages that are in a Rendezvous scheduler dispatcher queue waiting to be assigned to a Rendezvous dispatcher worker.
- SHOW,SSHOT[,num]
- This command initiates a snapshot and ends only when the num is reached. If the num is not present or the num is greater than the system default value, the system default value will be used. The output is directed to SYSPRINT of the Substation ES task. This command summarizes the statistics of the key interactions within the Substation ES instance for the specified number of Units of Work (UOWs).
- SHOW,SSHOT,DETAIL|DET[,num]
- This command has the following functions:
- Initiates a snapshot and ends only when the num is reached. If the num is not present or the num is greater than the system default value, the system default value will be used. The output is directed to SYSPRINT of the Substation ES task.
- Provides a summary of statistics of the key interactions within the Substation ES instance for the specified number of UOWs and the statistics for each UOW.
- Measures the duration of a UOW, the duration of a transaction call in CICS within the UOW, the duration of an EMS call for that UOW, and the time in which to allocate a UOW when a request is received.
- SHOW,SSHOT,ENTRY|ENT[,num]
- This command initiates a snapshot and ends only when the num is reached. If number num is not present or num is greater than the system default value, the system default value will be used. The output is directed to SYSPRINT of the Substation ES task. This command summarizes the statistics of the key interactions within the Substation ES instance for the specified number of UOWs and the detailed statistics for each UOW.
- SHOW,SSID
- This command shows the Substation ID.
- SHOW,SUSPENDED
- This command shows all suspended recipe services.
- SHOW,SYS[,DEBUG]
- This command is a combination of the SHOW,QUE and SHOW,UOW commands. The DEBUG option shows values specific to internal queues, current usage, and views of these queues.
- SHOW,SYS,LOCK
- This command freezes the system and performs the combination of the SHOW,QUE and SHOW,UOW commands.
- SHOW,TRCSTATS
- This command shows the information on the current active trace disk file.
- SHOW,TRCSTATS,ALL
- This command shows the information on all active trace disk files.
- SHOW,TRCSTATS,DETAIL
- This command shows the statistical information on each active trace disk file.
- SHOW,UOW
- This command shows the information on Substation ES Unit of Work (UOW) processing statistics.
- SHOW,XCF,GRP[=Group name][,Member name]
- The XCF commands show all XCF groups in this SYSPLEX, or show all connected members for one specified group, or show a member statistics information for Substation groups. For example: