Reliable Transaction Router
System Manager's Manual

SHOW PROCESS

Display information about processes which are using RTR.

Format

SHOW PROCESS

Command Qualifiers	Defaults
/CLUSTER	/NOCLUSTER
/COUNTER[=counter-name]	/NOCOUNTER
/FULL	/NOFULL
/IDENTIFICATION=process-id	/NOIDENTIFICATION
/NODE[=node-list]	/NODE=default-node-list
/OUTPUT[=file-spec]	/OUTPUT=stdout

Description

The SHOW PROCESS command displays information about the processes using RTR.

Qualifiers

/CLUSTER

/NOCLUSTER (D)
Specifies that the command is executed on all the nodes in the cluster.
If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified by the latest SET ENVIRONMENT command. If no SET ENVIRONMENT command has been entered then the command is executed only on the node where the command was issued.
Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only.
/COUNTER[=counter-name]

/NOCOUNTER (D)
Specifies that the process counters are also to be displayed. counter-name is the name of the counter to be displayed. If counter-name is omitted then all counters will be displayed. counter-name may contain wild card characters.
/IDENTIFICATION=process-id

/NOIDENTIFICATION (D)
Specifies the process about which information is required. The default (/NOIDENTIFICATION) displays all processes using RTR.
/FULL

/NOFULL (D)
Equivalent to specifying /COUNTER.
/NODE[=node-list]

/NODE=default-node-list (D)
Specifies that the command is executed on all nodes specified in node-list. If node-list is omitted then the command is executed only on the node where the command was issued.
/OUTPUT[=file-spec]

/OUTPUT=stdout (D)
Specifies that the resulting information is written to the file file-spec. If /OUTPUT or file-spec is omitted then the standard or default output is used.

Examples

RTR> SHOW PROCESS Processes: Process-id Process Name 326

SHOW REQUESTER

See SHOW CLIENT. The SHOW REQUESTER command has been replaced by SHOW CLIENT and is retained for compatibility reasons only.

SHOW RESOURCE MANAGER (SHOW RM)

Displays resource manager instance (RM) information.
This command is available only on UNIX and Windows NT systems.

Format

SHOW RESOURCE MANAGER [resource_name]
SHOW RM [resource_name]

Command Qualifiers	Defaults
/CLUSTER	/NOCLUSTER
/FULL	/NOFULL
/NODE[=node-list]	/NODE=default-node-list
/OUTPUT[=file-spec]	/OUTPUT=stdout

Description

The SHOW RESOURCE MANAGER command displays information for registered RMs. This command shows information for one or more RMs registered with the current TM.

Note
This command is available only on UNIX and Windows NT systems.

Refer to Appendix C, XA Support for support information about XA.

Parameters

resource_name
Specifies the name of the resource manager instance you want to display. resource_name may contain wild cards ("*" and "%"), in which case all matching resources will be displayed. If resource_name is omitted all configured resources are displayed.

Qualifiers

/CLUSTER

/NOCLUSTER (D)
Specifies that the command is executed on all the nodes in the cluster.
If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified by the latest SET ENVIRONMENT command. If no SET ENVIRONMENT command has been entered then the command is executed only on the node where the command was issued.
Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only.
/FULL

/NOFULL (D)
Displays additional information for facilities that reference a particular RM. If no rmi_name is included, displays information for all RMs.
/NODE[=node-list]

/NODE=default-node-list (D)
Specifies that the command is executed on all nodes specified in node-list. If node-list is omitted then the command is executed only on the node where the command was issued.
/OUTPUT[=file-spec]

/OUTPUT=stdout (D)
Specifies that the resulting information is written to the file file-spec. If /OUTPUT or file-spec is omitted then the standard or default output is used.

Related Commands

REGISTER RESOURCE MANAGER
UNREGISTER RESOURCE MANAGER

Examples

 RTR> SHOW RM rmi_1 /full
      Resource Manager:
      RMI Name                : Nashua
      RMID                    : yyy         
      XA Switch               : xaosw
      Library path            : zzz
      Facilities associated with this RM: Nashua

SHOW RTR

Display the configuration and status of RTR.

Format

SHOW RTR

Command Qualifiers	Defaults
/CLUSTER	/NOCLUSTER
/COUNTER[=counter-name]	/NOCOUNTER
/FULL	/NOFULL
/NODE[=node-list]	/NODE=default-node-list
/OUTPUT[=file-spec]	/OUTPUT=stdout
/STATUS	/NOSTATUS
/VERSION	/NOVERSION

Description

The SHOW RTR command displays the configuration and status of RTR.

Qualifiers

/CLUSTER

/NOCLUSTER (D)
Specifies that the command is executed on all the nodes in the cluster.
If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified by the latest SET ENVIRONMENT command. If no SET ENVIRONMENT command has been entered then the command is executed only on the node where the command was issued.
Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only.
/COUNTER[=counter-name]

/NOCOUNTER (D)
Specifies that the per node counters are also to be displayed. Counter-name is the name of the counter to be displayed. If counter-name is omitted then all counters will be displayed. Counter-name may contain wild card characters.
/FULL

/NOFULL (D)
Equivalent to specifying /COUNTER/STATUS.
/NODE[=node-list]

/NODE=default-node-list (D)
Specifies that the command is executed on all nodes specified in node-list. If node-list is omitted then the command is executed only on the node where the command was issued.
/OUTPUT[=file-spec]

/OUTPUT=stdout (D)
Specifies that the resulting information is written to the file file-spec. If /OUTPUT or file-spec is omitted then the standard or default output is used.
/STATUS (D)

/NOSTATUS
Displays the current status of RTR (started, stopped and so on).
/VERSION

/NOVERSION (D)
Displays the RTR version.

Related Commands

STOP RTR
START RTR

Example

 RTR> SHOW RTR  (1)
  
 RTR running on node baby.home.dec.com in group: develpr  (2)

Show the state and configuration of RTR.
RTR has been started in group mode for group "develpr".

SHOW SEGMENT

Display the type and size of routing key segments.

Format

SHOW SEGMENT

Command Qualifiers	Defaults
/CLUSTER	/NOCLUSTER
/FACILITY	/FACILITY="*"
/FULL	/NOFULL
/NODE[=node-list]	/NODE=default-node-list
/OUTPUT[=file-spec]	/OUTPUT=stdout

Description

The SHOW SEGMENT command displays the routing key segment definitions.
The routing key definition is common to all servers in a facility.
The routing key specifies the data within a message sent from clients used to route the message to a particular key range server.
The position, length and data type of each key segment is displayed.

Qualifiers

/CLUSTER

/NOCLUSTER (D)
Specifies that the command is executed on all the nodes in the cluster.
If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified by the latest SET ENVIRONMENT command. If no SET ENVIRONMENT command has been entered then the command is executed only on the node where the command was issued.
Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only.
/FACILITY

/FACILITY="*" (D)
Specifies the facility name for which information should be displayed.
By default, information is displayed for all Facilities.
/NODE[=node-list]

/NODE=default-node-list (D)
Specifies that the command is executed on all nodes specified in node-list. If node-list is omitted then the command is executed only on the node where the command was issued.
/OUTPUT[=file-spec]

/OUTPUT=stdout (D)
Specifies that the resulting information is written to the file file-spec. If /OUTPUT or file-spec is omitted then the standard or default output is used.

Examples

 RTR> SHOW SEGMENT  (1)
  
 Facility               Data Type           Length      Offset  
 RTR$DEFAULT_FACILITY   UNSIGNED            1           0       (2)
 TEST_FAC               SIGNED              4           10

Show the routing key segments for all facilities.
The facility name, the routing key data type, key length and offset are shown for each facility.

SHOW SERVER

Display information about server channels.

Format

SHOW SERVER

Command Qualifiers	Defaults
/CLUSTER	/NOCLUSTER
/FACILITY	/FACILITY="*"
/FULL	/NOFULL
/IDENTIFICATION=process-id	/NOIDENTIFICATION
/NODE[=node-list]	/NODE=default-node-list
/OUTPUT[=file-spec]	/OUTPUT=stdout

Description

The SHOW SERVER command displays information about server channels.
Information such as PID, key range, state, event mask, event name and partition ID can be displayed.
The "State:" field of the SHOW SERVER command can display the following values:

Table 6-22 Key-range States
State Meaning

wt_tr_ok Server is waiting for routers to accept it

wt_quorum Server is waiting for backend to be quorate

lcl_rec Local recovery

lcl_rec_fail Primary server waiting for access to a restart journal

lcl_rec_icpl Getting next journal to recover from

lcl_rec_cpl Processed all journals for local recovery

shd_rec Shadow recovery

shd_rec_fail Shadow server waiting for access to a restart journal

shd_rec_icpl Shadow getting next journal to recover from

shd_rec_cpl Processed all journals for shadow recovery

catchup Secondary is catching up with primary

standby Server is declared as standby

active Server is active

pri_act Server is active as primary shadow

sec_act Server is active as secondary shadow

remember Primary is running without shadow secondary

The "Flags:" field of the SHOW SERVER command can display the following values:

Table 6-23 Server Flags
FLAG Meaning

BEC Backend Call-out

EXA Explicit Accept

EXP Explicit Prepare

NCC No Concurrent

NSB No Standby

SHD Shadow

SRV Server

TRC Router Call-out

**Table 6-22 Key-range States**
State	Meaning
wt_tr_ok	Server is waiting for routers to accept it
wt_quorum	Server is waiting for backend to be quorate
lcl_rec	Local recovery
lcl_rec_fail	Primary server waiting for access to a restart journal
lcl_rec_icpl	Getting next journal to recover from
lcl_rec_cpl	Processed all journals for local recovery
shd_rec	Shadow recovery
shd_rec_fail	Shadow server waiting for access to a restart journal
shd_rec_icpl	Shadow getting next journal to recover from
shd_rec_cpl	Processed all journals for shadow recovery
catchup	Secondary is catching up with primary
standby	Server is declared as standby
active	Server is active
pri_act	Server is active as primary shadow
sec_act	Server is active as secondary shadow
remember	Primary is running without shadow secondary

**Table 6-23 Server Flags**
FLAG	Meaning
BEC	Backend Call-out
EXA	Explicit Accept
EXP	Explicit Prepare
NCC	No Concurrent
NSB	No Standby
SHD	Shadow
SRV	Server
TRC	Router Call-out

Qualifiers

/CLUSTER

/NOCLUSTER (D)
Specifies that the command is executed on all the nodes in the cluster.
If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified by the latest SET ENVIRONMENT command. If no SET ENVIRONMENT command has been entered then the command is executed only on the node where the command was issued.
Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only.
/IDENTIFICATION=process-id

/NOIDENTIFICATION (D)
Specifies the PID of the process for which information should be displayed. The default (/NOIDENTIFICATION) displays information for all servers.
/FACILITY

/FACILITY="*" (D)
Specifies the facility name for which information should be displayed.
By default, information is displayed for all Facilities.
/FULL

/NOFULL (D)
Specifies a detailed listing of server information.
/NODE[=node-list]

/NODE=default-node-list (D)
Specifies that the command is executed on all nodes specified in node-list. If node-list is omitted then the command is executed only on the node where the command was issued.
/OUTPUT[=file-spec]

/OUTPUT=stdout (D)
Specifies that the resulting information is written to the file file-spec. If /OUTPUT or file-spec is omitted then the standard or default output is used.

Examples

RTR> SHOW SERVER 
Servers: 
 
Process-id   Facility                     Channel   Flags     State 
20828        RTR$DEFAULT_FACILITY         589825    SRV       active 
20828        RTR$DEFAULT_FACILITY         655362    SRV       active 
 
RTR> SHOW SERVER/FULL 
Servers: 
 
Process-id:            20828     Facility:       RTR$DEFAULT_FACILITY 
Channel:              589825     Flags:                           SRV 
State:                active     Low Bound:                      aaaa 
High Bo                 mmmm     rcpnam:                 "LOWER_SERV" 
Uents:                     0     RTR Events:                        0 
Partition-Id:       16973824 
 
 
Process-id:            20828     Facility:       RTR$DEFAULT_FACILITY 
Channel:              655362     Flags:                           SRV 
State:                active     Low Bound:                      nnnn 
High Bo                 zzzz     rcpnam:                 "UPPER_SERV" 
User Events:               0     RTR Events:                        0 
Partition-Id:       16842753

SHOW TRANSACTION

Displays information about currently active transactions.

Format

SHOW TRANSACTION

Command Qualifiers	Defaults
/BACKEND	/NOBACKEND (D)
/CLUSTER	/NOCLUSTER
/FACILITY	/FACILITY="*"
/FRONTEND	/NOFRONTEND (D)
/FULL	/NOFULL
/IDENTIFICATION=process-id	/NOIDENTIFICATION
/NODE[=node-lisft]	/NODE=default-node-list
/OUTPUT[=file-spec]	/OUTPUT=stdout
/ROUTER	/NOROUTER (D)

Description

The SHOW TRANSACTION command displays transaction information, such the transaction ID, facility, transaction state, frontend user, start time and router node.

Qualifiers

/BACKEND

/NOBACKEND (D)
Specifies that information should be listed for transactions in a backend node. If none of /BACKEND, /FRONTEND or /ROUTER are specified, then information for all of them are displayed. If either /FRONTEND or /ROUTER are specified, then the default (/NOBACKEND) inhibits display of backend transaction information.
The "Invocation" field of SHOW TRANSACTION /BACKEND /FULL shows the following information:

Table 6-24 Transaction Invocation Types
Type Meaning

ORIGINAL Original transaction

REPLAY Replayed transaction

RECOVERY Shadow recovery transaction

/CLUSTER

/NOCLUSTER (D)
Specifies that the command is executed on all the nodes in the cluster.
If neither /NODE nor /CLUSTER is specified then the command is executed on the nodes specified by the latest SET ENVIRONMENT command. If no SET ENVIRONMENT command has been entered then the command is executed only on the node where the command was issued.
Note: In environments that do not support clustering, use of the /CLUSTER qualifier will cause the relevant command to be executed on the local node only.
/FRONTEND

/NOFRONTEND (D)
Specifies that information should be listed for transactions in a frontend node. If none of /BACKEND, /FRONTEND or /ROUTER are specified, then information for all of them are displayed. If either /BACKEND or /ROUTER are specified, then the default (/NOFRONTEND) inhibits display of frontend transaction information.
/IDENTIFICATION=process-id

/NOIDENTIFICATION (D)
Specifies the PID of the process for which information is displayed. The default (/NOIDENTIFICATION) displays information for all processes.
/FACILITY

/FACILITY="*" (D)
Specifies the facility name for which information should be displayed.
By default, information is displayed for all Facilities.
/FULL

/NOFULL (D)
Produces a detailed listing of transaction information.
/NODE[=node-list]

/NODE=default-node-list (D)
Specifies that the command is executed on all nodes specified in node-list. If node-list is omitted then the command is executed only on the node where the command was issued.
/OUTPUT[=file-spec]

/OUTPUT=stdout (D)
Specifies that the resulting information is written to the file file-spec. If /OUTPUT or file-spec is omitted then the standard or default output is used.
/ROUTER

/NOROUTER (D)
Specifies that information should be listed for transactions in a router node. If none of /BACKEND, /FRONTEND or /ROUTER are specified, then information for all of them are displayed. If either /BACKEND or /FRONTEND are specified, then the default (/NOROUTER) inhibits display of router transaction information.
The "Key-Range-State" field for SHOW TRANSACTION /ROUTER /FULL shows the following states:

Table 6-25 Key-Range States
State Meaning

locl_rec Local recovery in progress

shad_rec Shadow recovery in progress

active Active non-shadowed

sec_act Secondary active

pri_act Primary active

pri_lone Primary running alone

sec_chup Secondary is catching up

**Table 6-24 Transaction Invocation Types**
Type	Meaning
ORIGINAL	Original transaction
REPLAY	Replayed transaction
RECOVERY	Shadow recovery transaction

**Table 6-25 Key-Range States**
State	Meaning
locl_rec	Local recovery in progress
shad_rec	Shadow recovery in progress
active	Active non-shadowed
sec_act	Secondary active
pri_act	Primary active
pri_lone	Primary running alone
sec_chup	Secondary is catching up

Examples

 RTR>  SHOW TRANSACTION/BACKEND/FULL
Backend transactions:
 
Tid:                 e100b810,0,0,0,0,a85,83290001
Facility:       RTR$DEFAULT_FACILITY 
Frontend:                    *****   FE-User:                anders.7780
State:                   RECEIVING   Start-Time:Tue Feb 21 15:53:53 1995
Router:                     bronze   Invocation:                ORIGINAL
Active-Key-Ranges:               1   Recovering-Key-Ranges:            0
Total-Tx-Enqs:                   1   Key-Range-Id:              16973824
Server-Pid:                  20828   Server-State:             RECEIVING
Journal-Node:     iron.zuo.dec.com   Journal-State:              SENDING
First-Enq:                       1   Nr-Enqs:                    
Nr-Replies:                      0

Previous Next Contents Index

Reliable Transaction RouterSystem Manager's Manual

SHOW PROCESS

Format

Description

Qualifiers

/CLUSTER

/NOCLUSTER (D)

/COUNTER[=counter-name]

/NOCOUNTER (D)

/IDENTIFICATION=process-id

/NOIDENTIFICATION (D)

/FULL

/NOFULL (D)

/NODE[=node-list]

/NODE=default-node-list (D)

/OUTPUT[=file-spec]

/OUTPUT=stdout (D)

Examples

SHOW REQUESTER

SHOW RESOURCE MANAGER (SHOW RM)

Format

Description

Parameters

resource_name

Qualifiers

/CLUSTER

/NOCLUSTER (D)

/FULL

/NOFULL (D)

/NODE[=node-list]

/NODE=default-node-list (D)

/OUTPUT[=file-spec]

/OUTPUT=stdout (D)

Related Commands

Examples

SHOW RTR

Format

Description

Qualifiers

/CLUSTER

/NOCLUSTER (D)

/COUNTER[=counter-name]

/NOCOUNTER (D)

/FULL

/NOFULL (D)

/NODE[=node-list]

/NODE=default-node-list (D)

/OUTPUT[=file-spec]

/OUTPUT=stdout (D)

/STATUS (D)

/NOSTATUS

/VERSION

/NOVERSION (D)

Related Commands

Example

SHOW SEGMENT

Format

Description

Qualifiers

/CLUSTER

/NOCLUSTER (D)

/FACILITY

/FACILITY="*" (D)

/NODE[=node-list]

/NODE=default-node-list (D)

/OUTPUT[=file-spec]

/OUTPUT=stdout (D)

Examples

SHOW SERVER

Format

Description

Qualifiers

/CLUSTER

/NOCLUSTER (D)

/IDENTIFICATION=process-id

/NOIDENTIFICATION (D)

/FACILITY

/FACILITY="*" (D)

/FULL

/NOFULL (D)

Reliable Transaction Router
System Manager's Manual