Reliable Transaction Router
System Manager's Manual


Previous Contents Index

  1. Display information about all declared channels.
  2. The channel called RTR$DEFAULT_CHANNEL is open as a server channel.
  3. The channel called CLI_CHN is open as a client channel.
  4. The channel called CLI_CHN2 is open as a client channel, and has been opened by another process (in another window).

SHOW CLIENT

Display information about client channels.

Format

SHOW CLIENT

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

Description

The SHOW CLIENT command displays information about client channels.

Information such as PID, key range, state, event mask and event name 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.

/IDENTIFICATION=process-id

/NOIDENTIFICATION (D)

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

/FACILITY

/FACILITY="*" (D)

Specifies the facility name for which information should be displayed.

By default, information is displayed for all Facilities.

/FULL

none (D)

Specifies a detailed listing of client 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 CLIENT/FULL  (1)
  
 Process-id:      9234          Facility:       TEST43  (2)
 Channel:         500           Flags:             CLI  (3)
 State:           declared      rcpnam:       "V3TEST" (4)
 User Events:     255           RTR Events:          0 (5)
  
 

  1. Show the client in detail.
  2. The client's process id and facility name.
  3. The client's channel id and the flags set when the channel was opened.
  4. The channel state and recipient name for events.
  5. (5) The user events and RTR events subscribed to.

SHOW DISPLAY

Show which items were displayed by the most recently issued MONITOR command or DISPLAY commands.

Format

SHOW DISPLAY

Command Qualifiers Defaults
/ALL /NOALL
/OUTPUT[=file-spec] /OUTPUT=stdout
/X=column
/Y=row

Description

The SHOW DISPLAY command shows which items were displayed by the most recently issued MONITOR command. These may have been read in from a display file using the MONITOR file-spec command, or entered interactively using DISPLAY commands.

The item definitions are shown in DISPLAY command format. (The command SHOW DISPLAY/OUTPUT=file may be used to create new monitor files.)


Qualifiers

/ALL

/NOALL (D)

Specifies that all monitored items are shown.

/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.

/X=column /Y=row

Specify that the single item in position (column,row) is shown.

Related Commands


Examples


 RTR> MON CALLS  (1)
 RTR> SHOW DISPLAY/ALL  (2)
  
 DISPLAY TEXT  "RTR api calls, Node: $node_name ,- (3)
          PID: $process_id, Process name: -ALL-" -
         /X=1   /Y=1 - 
         /BOLD="1"
    .
    .
    .
 DISPLAY NUMERIC         "rtr_open_channel_succ" -
         /X=1   /Y=5 - 
         /BLANK - 
         /LABEL=" rtr_open_channel    " -
         /WIDTH=9
    .
    .
    .
 

  1. Display the CALLS monitor picture.
  2. Show all the items contained in the monitor picture.
  3. The items are displayed in DISPLAY command format. See the description of the relevant DISPLAY commands for a description of the various qualifiers.

Examples

See Section A.1, Interactive Definition of a Monitor Picture, for an example of how to use the SHOW DISPLAY command.

SHOW ENVIRONMENT

Shows the default nodes used for remote command execution.

Format

SHOW ENVIRONMENT


Description

The SHOW ENVIRONMENT command shows which nodes are used by default for remote command execution.

Related Commands


Examples


 RTR> SET ENVIRONMENT/NODE=(FE2,FE3)  (1)
 RTR> SHOW ENVIRONMENT  (2)
 %RTR-S-COMARESEN, commands sent by default to node FE2 (3)
 %RTR-S-COMARESEN, commands sent by default to node FE3
 

  1. Set the command environment so that subsequent commands will be executed on nodes FE2 and FE3.
  2. Show which nodes are selected.
  3. The RTR-S-COMARESEN message is displayed for each selected node.

SHOW FACILITY

Show the names, configuration and status of one or more facilities.

Format

SHOW FACILITY [facility-name]

Command Qualifiers Defaults
/BALANCE /NOBALANCE
/CLUSTER /NOCLUSTER
/CONFIGURATION /NOCONFIGURATION
/COUNTER[=counter-name] /NOCOUNTER
/FULL /NOFULL
/LINKS /NOLINKS
/STATE /NOSTATE
/OUTPUT[=file-spec] /OUTPUT=stdout
/NODE[=node-list] /NODE=default-node-list

Description

The SHOW FACILITY command shows the names, configuration and status of facilities on the node where the command is executed. If no qualifiers are used, only the facility name or names and the roles in the facility on the node are displayed.


Parameters

facility-name

Specifies the name of the facility you want to display. Facility-name may contain wild cards ("*" and "%"), in which case all matching facilities will be displayed. If facility-name is omitted all configured facilities are displayed.

Qualifiers

/BALANCE

/NOBALANCE (D)

Specifies that the load-balancing status of the facility is also displayed. See Section 2.6, Router Load Balancing for details of load-balancing.

/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.

/CONFIGURATION

/NOCONFIGURATION (D)

Specifies that the facility configuration is to be displayed. The configuration information indicates the role(s) of the the node where the command is executed, and

/COUNTER[=counter-name]

/NOCOUNTER (D)

Specifies that the facility counters are displayed. Counter-name is the name of the counter. If counter-name is omitted then all counters are displayed. Counter-name may contain wild card characters.

/FULL

/NOFULL (D)

Equivalent to specifying /CONFIGURATION, /STATE and /LINK.

/LINKS

/NOLINKS (D)

Lists all links to connected nodes in the facility (including the node where the command is executed. The following information is shown for each link:

/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.

/STATE

/NOSTATE(D)

Specifies that the state of the facility is displayed.

On nodes having a backend or router role, the quorum status is shown. Also, the current quorum threshold is shown (default quorum value is shown as zero), and the minimum broadcast rate (if it has been set).

On a frontend, this qualifier can be used to find out whether the node is currently connected to a router.

Related Commands


Examples


 RTR> SHOW FACILITY/FULL/NODE=BRONZE  (1)
  
Facility:       FUNDS_TRANSFER  (2)
Configuration:-                 (3)
  
Frontend:         no    Router:              yes  Backend:            yes
                        Router call-out:      no  Backend call-out:    no
                        Load balance:         no  Quorum-check off:    no
  
State:-                         (4)
  
FE -> TR:      unused   Router quorate:      yes  Backend quorate:    yes
                        Quorum threshold:      0  Min broadcast rate:   0
  
Links:-                         (5)
  
Link to:                      bronze  
Frontend:          no   Router:              yes  Backend:            yes
Router -> Frontend:no   Frontend -> Router:   no  
                        Backend -> Router:   yes  Router -> Backend:  yes
                        Router quorate:      yes  Backend quorate:    yes
                        Router current:       no  Backend coordinator:yes
  
Link to:                      airola    (6)
Frontend:          yes  Router:               no  Backend:             no
Router -> Frontend:yes  Frontend -> Router:   no  
                        Backend -> Router:    no  Router -> Backend:   no
                        Router quorate:       no  Backend quorate:     no
                        Router current:       no  Backend coordinator: no
  
 

  1. Show all facilities in detail.
  2. The facility's name.
  3. The facility's configured roles on this node. In this example, the node is a router and a backend; load balancing, router callouts and backend callouts are not enabled.
  4. The facility's state. The router and backend roles are quorate. (Quorate means that this node's view of the availability of the other nodes in the configuration matches that of the other backends and routers. A facility that is not in the quorate state is effectively unusable.) The quorum threshold is at the default (zero) and no minimum broadcast rate has been set.
  5. (5) The facility's links. The first link shown (to node "bronze" i.e. itself) shows that it is a router, connected to the backend, and the router is quorate. The router is not current because there is no frontend on this connection. The link is also a backend, connected to the router, and this backend is quorate. This backend would also be the backend coordinator if load balancing was enabled.
  6. The second link shown (to node "airola") shows that it is a frontend, and is a frontend to router connection.

RTR> SHOW FACILITY/BALANCE 
Facilities: 
 
Facility:       RTR$DEFAULT_FACILITY 
 
Load:- 
 
Frontends connected:               1     Frontends allowed:                 1 
Load coordinator:                yes     Quorate routers:                   1 
Total Frontends:                   1     Current Credit:                    1 
FE -> TR:                          - 

This display shows the load balancing status. This node is the current load coordinator.


SHOW JOURNAL

Display information about current RTR journal files.

Format

SHOW JOURNAL

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

Description

The SHOW JOURNAL command shows the disks where the RTR journal files reside, and (optionally) the maximum and allocated number of blocks for each journal file and the journal file name.


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.

/FILENAMES

/NOFILENAMES (D)

/FILE adds the journal filenames to the display.

/FULL

/NOFULL (D)

/FULL adds to the display the maximum and allocated number of blocks for each journal file.

/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


Examples


 RTR> SHOW JOURNAL/FULL/FILENAMES  (1)
                             
 RTR journal:- 
     (2)          (3)            (4)        (5)          (6)
 Disk(1):  /dev/rz3a      Blocks: 1500 Allocated: 1502 Maximum: 3000
 File(1):  /dev/rz3a /rtrjnl/SYSTEM/BRONZE.J01(7)
 Disk(2):  /dev/rz2c      Blocks: 1500 Allocated: 1502 Maximum: 3000 
 File(2):  /dev/rz2c /usr/users/rtrjnl/SYSTEM/BRONZE.J11
  
  
 

  1. Show the disks used for RTR's recovery journal and the filenames.
  2. Two disks are currently in use.
  3. Device name.
  4. File size in blocks.
  5. (5) Allocated file size in blocks.
  6. Maximum file size in blocks.
  7. Filename.

SHOW KEY

Display the key definitions created by the DEFINE/KEY command.

Format

SHOW KEY [key-name]

Command Qualifiers Defaults
/ALL /NOALL
/FULL /NOFULL
/OUTPUT[=file-spec] /OUTPUT=stdout
/IF_STATE /NOIF_STATE

Description

The SHOW KEY command shows the key definitions created by the DEFINE /KEY command.


Parameters

key-name

Specifies the name of the key whose definition you want displayed. See the description of the DEFINE/KEY command for a list of the valid key names.

Qualifiers

/ALL

/NOALL (D)

Requests that all key definitions in the current state be displayed. You can use the /IF_STATE qualifier to request key definitions in other states. Do not specify a key name with the /ALL qualifier. If no state is specified, all key definitions in the current state are displayed.

/FULL

/NOFULL (D)

Requests that all qualifiers associated with a definition are displayed. By default, only the state of the definition and the definition itself are displayed.

/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.

/IF_STATE=state-name

/NOIF_STATE (D)

Specifies the name of a state for which the specified key definitions are displayed. State names can be any appropriate alphanumeric string. State names are created with the DEFINE/KEY command. If you omit the /IF_STATE qualifier or use /NOIF_STATE, key definitions in the current state are displayed.

Related Commands


Examples


 RTR> SHOW KEY/FULL  
 DEFAULT PF1 defined as ""
 DEFAULT KP0 defined as "MONITOR/RESUME"
 DEFAULT KP2 defined as "SCROLL DOWN 1"
 DEFAULT KP4 defined as "SCROLL LEFT 1"
 DEFAULT KP5 defined as "SCROLL HOME"
 DEFAULT KP6 defined as "SCROLL RIGHT 1"
 DEFAULT KP8 defined as "SCROLL UP 1"
 GOLD KP2 defined as "SCROLL DOWN 10"
 GOLD KP4 defined as "SCROLL LEFT 10"
 GOLD KP6 defined as "SCROLL RIGHT 10"
 GOLD KP8 defined as "SCROLL UP 10"


Previous Next Contents Index