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 active 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 3270 results on screen.
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,CONNAME
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 TIBCO Enterprise Message Service™ 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, 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
This command initiates a snapshot and ends only when the preset value is reached. 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
This command has the following functions:
  • Initiates a snapshot and ends only when the preset value is reached. 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
This command initiates a snapshot and ends only when the preset value is reached. 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
16.924783    2008/03/29-15:59:07.846085  2008/03/29-15:59:24.770868

#:1000   Minimum   Maximum   Total         Average Recorded
UoW      0.020000  0.531226   203.060447   0.203060
BES      0.005930  0.521352   175.132541   0.175132
WRK-In   0.000016  0.008004     0.383973   0.000383
WRK-Out  0.003364  0.085766     8.129159   0.008129
ESB      0.002431  0.076503     5.214009   0.005214

Entry# UoW          Start                       End
#00000 1218811218   2008/03/29-15:59:07.846085  2008/03/29-15:59:08.030790
               TRG WRK 15:59:08.019095 15:59:08.019355 Dur:0.000260
                   BES 15:59:07.846086 15:59:08.019095 Dur:0.173009
           TRG-Out WRK 15:59:08.019419 15:59:08.027033 Dur:0.007614
                   ESB 15:59:08.021915 15:59:08.026729 Dur:0.004814
 00000   Complete  UoW:0.184705
#00001  663466177  2008/03/29-15:59:07.847841   2008/03/29-15:59:08.051230
              TRG  WRK 15:59:08.043346 15:59:08.043412 Dur:0.000066
                   BES 15:59:07.847841 15:59:08.043346 Dur:0.195505
           TRG-Out WRK 15:59:08.043542 15:59:08.051173 Dur:0.007631
                   ESB 15:59:08.047732 15:59:08.050923 Dur:0.003191
01       Complete  UoW:0.203389
SHOW, SSID
This command shows the Substation ID.
The command output is as follows: 
SXA2601I Console Command 'SHOW,SSID'
         Substation ES ID:SSES#4#IVP
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