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.
The command output is as follows:
SXA2601I Console Command Entered 'SHOW,ACT,LISTENERS'
SXT5586I The following listeners are active:
SXT5585I Intf:IIXFR, Dest:tibss.ivp.20.request
SXT5585I Intf:IIXFR, Dest:tibss.ivp.20.reply
SXT5585I Intf:IIXFR, Dest:tibss.admin.sxs
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.
The command output is as follows:
SXA2601I Console Command Entered 'SHOW,ACT,RECIPE'
SXT5588I The following recipes are active:
SXT5587I Intf:IIXFR, Since Date:2004/11/09 Time:10:35:42.3321
         RID:SXC-RR-REPLY
SXT5587I Intf:IIXFR, Since Date:2004/11/09 Time:10:35:42.3335
         RID:SXC-RR-ANSWER
SXT5587I Intf:IIXFR, Since Date:2004/11/09 Time:10:35:42.3340
         RID:Substation-Admin
Note: In the preceding example, the Since Date and Time values show when a recipe was last loaded.
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.
The command output is as follows:
SXA2601I Console Command Entered 'SHOW,ACT,TRIGGER'
SXT5590I The following triggers are active:
SXT5589I Intf:IIXFR, Since Date:2004/11/09 Time:10:35:42.3909
         TID:CICS-RR-REQUEST
SXT5589I Intf:IIXFR, Since Date:2004/11/09 Time:10:35:42.3912
         TID:SXC-IVP-TRIGGER
SXT5589I Intf:IIXFR, Since Date:2004/11/09 Time:10:35:42.4173
         TID:SXI-IVP-TRIGGER
Note: In the preceding example, the Since Date and Time values show when a trigger was last loaded.
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.
For example:
SHOW,CICS,“CEMT I TAS”,IID=CICS01
SHOW,CICS,“CEMT I PROG(SXCCI001)”
SHOW,CICS,“CEMT INQUIRE PROG(SXCCI001)”,INTF=CICS02
The response output for the CEMT command displays only the first screen's results.
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.
For example:
SHOW,CICS,SXTH,HVT
SHOW,CICS,SXTH,TSQ,INTF=CICS01
SHOW,CICS,”SXTH,HVT",INTF=CICS01
For the supported list of SXTH optional sub-commands, see SXTH Command-Line Parameters.
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.
The command output is as follows:
SXA2601I Console Command Entered 'SHOW,COUNTERS'
SXS0950I Substation (ES) Interface Information
SXS0960I # Intf Id:IIXFR Type:XFR Vers:2.3.0
SXS0965I - RID:Substation-Admin - Used:1 Errors:0
SXS0965I - RID:SXC-IVP-C-DPL - Used:1 Errors:0
SXS0965I - RID:SXC-IVP-COB-DPL - Used:1 Errors:0
SXS0965I - RID:SXC-IVP-COB-DPL-START-PGM - Used:1 Errors:0
SXS0965I - RID:SXC-IVP-COB-DPL-START-TRAN - Used:1 Errors:0
SXS0965I - RID:SXC-IVP-DPL-WRITE-TDQ - Used:1 Errors:0
SXS0965I - RID:SXC-IVP-DPL-WRITE-TSQ - Used:1 Errors:0
SXS0965I - RID:SXC-IVP-COB-DPL-COMPLEX - Used:1 Errors:0
SXS0965I - TID:SXC-IVP-TRIGGER - Used:3 Errors:0
SXS0962I No counter information recorded for Intf:SSMASTER
SXS0960I # Intf Id:IADMIN Type:ADMIN Vers:2.3.0
SXS0961I - Operational Commands :1
SXS0960I # Intf Id:IICICS Type:CICS Vers:2.3.0
SXS0961I - Trigger Entries Received :3
SXS0961I - Requests processed, DPL :3
SXS0961I - Requests processed, DPL/XCTL :1
SXS0961I - Requests processed, DPL/Tran :1
SXS0961I - Requests processed, DPL/TDQ :1
SXS0961I - Requests processed, DPL/TSQ :1
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.
The command output is as follows:
SXA2601I Console Command Entered 'SHOW,DISABLED'
SXT5593I The following recipes/triggers are disabled
SXT5594I Intf:IIXFR,Disabled Date:2004/11/09 Time:10:42:00.8670
         RID:SXC-RR-REPLY, Rsn: by Request
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.
The command output is as follows:
SXA2602I Console Command 'SHOW,DISABLED,LSNS'
SXT5586I The following listeners are disabled:
SXT5585I Dest:tibss.CICS.C.Request
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.
The command output is as follows:
SXA2602I Console Command 'SHOW,DISABLED,RID'
SXT5593I The following recipes/triggers are disabled
SXT5594I Disabled Date:2012/07/02 Time:17:22:35.559709
         RID:SXC-DPL-C, Rsn: by Request
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.
The command output is as follows:
SXA2602I Console Command 'SHOW,DISA,TID'
SXT5593I The following recipes/triggers are disabled
SXT5594I Disabled Date:2012/07/02 Time:17:27:19.240171
         TID:TRIGGER-TEXT, Rsn: by Request
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.
The command output is as follows:
SXA2601IConsoleCommand 'SHOW,EMS,STATS,RID=SXC-DPL-C,INTF=ESB01'
         IId:ESB01 Recipe SXC-DPL-C Queue Statistics
           Receiver Count      :1
           UnAcknowledged Msgs :0
           Pending Msgs        :0
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.
The command output is as follows:
SXA2601I Console Command Entered 'SHOW,TPORT'
SXT5669I Transport EMS-Server-FT used 0, state=Unused,
         process-err=
SXT5669I Transport EMS-Server used 22, state=Active, process-err=
SXT5670I Transports active 1, in-error 0, unused 1, disabled 0
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.
The command output is as follows:
SXA2601I Console Command 'SHOW,IMS,STATS'
SXG2077I Operational Request Feedback for IId:IMSE
SXI4967I Count      0 - Transactions received
SXI4967I Count      0 - Transactions to IMS
SXI4967I Count      0 - Nack transactions
SXI4967I Count      0 - Transactions timed out
SXI4967I Count      0 - Ack requests for sync=conf
SXI4967I Count      0 - Msg notify exit calls
SXI4967I Count      3 - SRBs to Message Exit
SXI4967I Count      3 - SRB Buffers used
SXI4967I Count      0 - SRB Response handled locally
SXI4967I Count      0 - Trigger SRBs received
SXI4967I Count      0 - Trigger SRBs routed normally
SXI4967I Count      0 - Lost SRB messages
SXI4967I Count      1 - SRBs to Group Exit
SXI4967I Count      0 - Group Buffers used
SXI4967I Count      0 - Lost Group messages
SXI4967I Count      0 - Synchronous callouts received
SXI4967I Count      0 - Synchronous callouts replied
SXI4967I Count      0 - Trigger NAKs received
SXI4967I Count      0 - Trigger NAKs reprocessed
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.
The command output is as follows:
SXA2601I Console Command Entered 'SHOW,QUE'
SXS0850I -  Intf: TIBSS01 UoW Que statistics request
SXS0851I -  Currently in use Entries - 0
SXS0851I -  Max Entries in Wait HiWM - 0
SXS0851I -  Internal Next Stored Idx - 1
SXS0851I -  Internal Next Strip Idx  - 1
SXS0850I -  Intf: IADMIN UoW Que statistics request
SXS0851I -  Currently in use Entries - 0
SXS0851I -  Max Entries in Wait HiWM - 0
SXS0851I -  Internal Next Stored Idx - 0
SXS0851I -  Internal Next Strip Idx  - 0
SXS0850I -  Intf: IIXFR UoW Que statistics request
SXS0851I -  Currently in use Entries - 0
SXS0851I -  Max Entries in Wait HiWM - 0
SXS0851I -  Internal Next Stored Idx - 0
SXS0851I -  Internal Next Strip Idx  - 0
SXS0850I -  Intf: IICICS UoW Que statistics request
SXS0851I -  Currently in use Entries - 0
SXS0851I -  Max Entries in Wait HiWM - 0
SXS0851I -  Internal Next Stored Idx - 0
SXS0851I -  Internal Next Strip Idx  - 0
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,“CEMT I TAS”,IID=RED01
SHOW,RED,“CEMT I PROG(SXCCI001)”
SHOW,RED,“CEMT INQUIRE PROG(SXCCI001)”,INTF=RED02
The response output for the CEMT command displays only the first screen's results.
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,RED,"XTUV,STATS"
SHOW,RED,"XTUV,TRG",INTF=RED01
SHOW,RED,"XTUV,REC",INTF=RED02
For the supported list of XTUV optional sub-commands, see XTUV Command-Line Parameters.
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).
The command output is as follows:
Elapsed    Start Time                 End Time
4.997445   2008/03/26-11:54:17.742439 2008/03/26-11:54:22.739884

#:1000  Minimum   Maximum    Total     Average    Recorded
UoW     0.002990  0.036007  4.637820   0.004637
BES     0.001441  0.027182  2.278445   0.002278
WRK-In  0.000023  0.001935  0.101735   0.000101
WRK-Out 0.000808  0.022377  1.290829   0.001290
ESB     0.000000  0.000000  0.000000   0.000000
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.
The command output is as follows:
Elapsed      Start Time                  End Time
16.166103    2008/03/29-15:44:28.191172 2008/03/29-15:44:44.357275

#:1000    Minimum    Maximum    Total        Average Recorded
UoW       0.023369   0.503595    194.623214  0.194623
BES       0.007174   0.450786    164.750438  0.164750
WRK-In    0.000013   0.034431      0.497021  0.000497
WRK-Out   0.003321   0.077685      9.077637  0.009077
ESB       0.002446   0.075679      5.707911  0.005707

Entry# UoW         Start                       End
#00000 1998987041   2008/03/29-15:44:28.191172 2008/03/29-15:44:28.402554
 00000   UoW:0.211382 BES:0.205756 ReqB:0.005378 ESB:0.004002
#00001 418627837    2008/03/29-15:44:28.207054 2008/03/29-15:44:28.413057
 00001   UoW:0.206003 BES:0.192627 ReqB:0.012935 ESB:0.009628
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.
The command output is as follows:
Elapsed      Start Time                 End Time                       
0.034772     2017/12/21-14:03:06.369853 2017/12/21-14:03:06.404625     
                                                                       
#:002    Minimum   Maximum     Total      Average Recorded             
UoW      0.034592  0.038062     0.072654  0.036327                     
BES      0.009572  0.019561     0.029133  0.014566                     
WRK-In   0.000901  0.000000     0.001883  0.000941                     
WRK-Out  0.004641  0.000000     0.011451  0.005725                     
                                                                       
Entry# UoW:1058210416     Start                      End               
#00000 470581944 2017/12/21-14:03:06.369853 2017/12/21-14:03:06.404445 
Ix:434  Complete UoW  Dur:0.034592                                     
         Service Name SXC-DPL-BYTEM                     
          DPL-In WRK  Dur:0.000982   14:03:06.372370 14:03:06.373352   
                 BES  Dur:0.009572   14:03:06.382463 14:03:06.392035   
         DPL-Out WRK  Dur:0.006810   14:03:06.392903 14:03:06.399713   
                                                                       
#00001 783307686 2017/12/21-14:03:06.366563 2017/12/21-14:03:06.404625 
Ix:432  Complete UoW  Dur:0.038062                                     
         Service Name SXC-DPL-BYTEM                     
          DPL-In WRK  Dur:0.000901   14:03:06.366796 14:03:06.367697   
                 BES  Dur:0.019561   14:03:06.370276 14:03:06.389837   
         DPL-Out WRK  Dur:0.004641   14:03:06.390145 14:03:06.394786
SHOW,SSID
This command shows the Substation ID.
The command output is as follows:
SXA2601I Console Command 'SHOW,SSID'
         Substation ES ID:SSES4IVP
SHOW,SUSPENDED
This command shows all suspended recipe services.
The command output is as follows:
SXA2601I Console Command 'SHOW,SUSPENDED'
SXT5594I SUSPENDED Date:2013/11/21 Time:19:29:12.928219
         RID:Substation-Admin-IMS
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.
Note: Specifying the LOCK keyword provides an absolute and accurate view of the request.

Use this keyword with discretion, however, because all internal queues and statistical tables are locked. This keyword causes the Substation ES region to suspend operations until the request is complete.

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.
The command output is as follows:
SXA2601I Console Command Entered 'SHOW,UOW'
SXS0800I -  UoW List Statistics request
SXS0800I -  UoW Total Allocations     - 0
SXS0800I -  UoW List Hi Water Mark    - 0
SXS0800I -  UoW Currently Active      - 0
SXS0800I -  UoW List Size (entries)   - 200
SXS0800I -  UoW List Size (bytes)     - 3256
SXS0800I -  Max Allocated Entries     - 80
SXS0800I -  Uow Incremental Amount    - 20
SXS0800I -  UoW Lock Status           - 0
SXS0800I -  UoW Stress Status         - 0
SXS0800I -  UoW Stress Restart Level  - 150
SXS0800I -  UoW Stress Slow Level     - 160
SXS0800I -  UoW Stress Stop Level     - 179
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:
SHOW,XCF,GRP
SHOW,XCF,GRP=CICSTS1G
SHOW,XCF,GRP=CICSTS1G,MSGS#YODA