[Top] [Previous] [Next] [End of Book]

# Chapter 6 . Administering BEA Connect TPS

## Introduction

BEA TUXEDO has a set of tmadmin subcommands for the administration of gateways to remote systems or regions. Each of these subcommands, summarized here in Table 6-1, are fully supported by Connect TPS:

> Table 6-1 Administration Subcommands

Subcommand | Description
--- | ---
printdomain | Prints information about Connect TPS gateways.
stats | Prints statistical information about services that are accessible through Connect TPS gateways.
mode | Accepts a Connect TPS specific subcommand.

These three subcommands operate by invoking the standard BEA TUXEDO gateway administrative service (GATE_ADMIN) that is offered by Connect TPS Liaisons.

See the BEA TUXEDO Reference Manual for detailed information about the tmadmin command.

## The printdomain Subcommand

The following subsections describe the printdomain subcommand.

### Description

The printdomain subcommand (pd) displays information about Connect TPS gateways. This includes:

- Names of Connect TPS server groups

- Configuration of gateway servers

- Other information

### Syntax and Usage

The syntax of the printdomain subcommand is as follows:

    tmadmin
    printdomain (pd) [ { -i srvid | -g grpid | -q qaddress } ]

where:

`-i srvid`
  specifies an integer that uniquely identifies a server within a server group. The server you specify is a Connect TPS Liaison that offers the gateway administrative service.

`-g grpid`
  specifies the name of the Connect TPS server group. This is the group to which the specified server (srvid) belongs.

`-q qaddress`
  specifies the queue address of a Connect TPS Liaison that offers the gateway administrative service.

As the syntax indicates, you can specify a Connect TPS Liaison by using its srvid, grpid, or qaddress. However, there is one condition. If you use a srvid, the srvid must be unique across the entire node. If the srvid is not unique, you must do one of the following:

- Specify the srvid and the grpid with which it is associated.

- Specify the qaddress.

If you specify no parameters, all servers that offer the gateway administrative service are queried for information.

Note: For more specific information about these parameters, see ubbconfig(5) in the BEA TUXEDO Reference Manual.

### Example

Here is an example of the output that the printdomain subcommand produces. (In actual output, the variables shown would be replaced with literal values.)

>             Group Name: groupname
>                  Queue: queuename
>          Local version: software version

>       Listener address: TCP/IP address in hex
>         Network device: pathname for TCP device
>           Text mapping: data format
>        Max data length: max buffer length
>       Connect attempts: number of connection attempts
>       # of connections: current number of connections
>      Last connect time: time of most recent connection
>          # of Requests: number of processed requests

>             Group Name: groupname
>                  Queue: Liaison's queuename
>          Local version: software version

>                 Status: connection status
>               Attempts: number of connection attempts
>         Remote address: remote system address in hex
>         Network device: pathname for TCP device
>           Text mapping: data format
>                  Queue: queuename
>          Local version: software version

>                 Status: connection status
>               Attempts: number of correction attempts
>         Remote address: remote system address in hex
>         Network device: pathname for TCP device
>           Text mapping: data format
>        Times connected: number of times connections have been established
>        Max data length: max buffer length
>         Remote account: remote gateway account code

## The stats Subcommand

The following subsections describe the stats subcommand.

### Description

The stats subcommand prints statistical information about services that are available through Connect TPS gateways. See subsection "Example" for an example of the output that the stats subcommand produces.

Information can be restricted to a single service by specifying the service name.

### Syntax and Usage

The syntax of the stats subcommand is as follows:

    tmadmin
    stats {-i srvid | -g grpid | -q qaddress } [ -s service ]

where:

`-i srvid`
  specifies an integer that uniquely identifies a server within a server group. The server you specify is a Connect TPS Liaison that offers the gateway administrative service.

`-g grpid`
  specifies the name of the Connect TPS server group. This is the group to which the specified server (srvid) belongs.

`-q qaddress`
  specifies the queue address of a Connect TPS Liaison that offers the gateway administrative service.

`-s service`
  specifies a single service that you want information about.

As the syntax indicates, you obtain information about services by specifying one of the following:

- The identifier of a Connect TPS Liaison

- The server group to which the Connect TPS Liaison belongs

- The queue address of a Connect TPS Liaison

However, there is one condition. If you use asrvid, the srvid must be unique across the entire node. If the srvid is not unique, you must do one of the following:

- Specify the srvid and the grpid with which it is associated.

- Specify the qaddress.

Finally, you can restrict the output of the stat subcommand by specifying a single service.

Note: For more specific information about these parameters, see ubbconfig(5) in the BEA TUXEDO Reference Manual.

### Example

Here is an example of the stats subcommand and the output it produces:

>     $ tmadmin
>     > stats -q queuename
>                   =TRANSACTION=STATUS=   =AVERAGE=NETWORK=       =LAST=USER=DATA=
>     SERVICE NAME   PASS  FAIL  MSGS     SENT SVNG  RCVD SVNG    SENT SVNG  RCVD SVNG
>     ------------   ----  ----  ----     ---- ----  ---- ----    ---- ----  ---- ----
>     servicename       0     0     0        0   0%     0   0%       0    0%    0   0%

>     $ tmadmin
>     > stats -q queuename
>                  =TRANSACTION=STATUS=    =AVERAGE=NETWORK=       =LAST=USER=DATA=
>     SERVICE NAME   PASS  FAIL  MSGS     SENT SVNG  RCVD SVNG    SENT SVNG  RCVD SVNG
>     ------------   ----  ----  ----     ---- ----  ---- ----    ---- ----  ---- ----
>     TRAN1            0    0     0         0    0%    0   0%       0    0%    0    0%
>     TRAN2            0    0     0         0    0%    0   0%       0    0%    0    0%
>     TRAN3            0    0     0         0    0%    0   0%       0    0%    0    0%
>                    ====  ====  ====     ==== ====  ==== ====
>                        0    0      0         0     0%    0   0%

## The mode Subcommand

The following subsections describe the mode subcommand.

### Description

The mode subcommand makes it possible to direct command strings to Connect TPS through local gateway processes or queues you specify on the command line.

### Syntax and Usage

The syntax of the mode subcommand is as follows:

    tmadmin
    mode { -g group | -i srvid | -q qaddress }
    > command [ arguments ]

The optional command [ argument ] parameter can be one of the following:

    clearstats (clr) [ service ]
    help (h) [ command ]
    ping [ otpid ]
    remotecommand (rcmd) otpid command [ ; command ]
    stats [ service ]
    wakeup (wake) [ pid ]

Here are descriptions of parameters that are used to specify which Connect TPS Liaison will process the mode subcommand:

`-g group`
  specifies the name of the Connect TPS server group. This is the group to which the specified server (srvid) belongs.

`-i srvid`
  specifies an integer that uniquely identifies a server within a server group. The server you specify is a Connect TPS Liaison that offers the gateway administrative service. If the srvid is not unique across the entire node, you must either specify the srvid

`-q qaddress`
  specifies the queue address of a Connect TPS Liaison that offers the gateway administrative service.

Here are descriptions of the optional commands and arguments you can direct to the specified Connect TPS gateway:

`clearstats (clr) [ service ]`
  clears the output of the stats subcommand.

`help (h) [ command ]`
  prints information about the specified mode subcommand. If invoked without an argument, help prints a list of mode subcommands.

`ping [ otpid]`
  verifies connectivity with a particular otpid (Connect TPS gateway group).

`remotecommand (rcmd) otpid command [ ; command . . . ]`
  causes the specified command or commands to be sent to the specified remote system.

`stats [ service ]`
  prints statistical information about services that are available via the specified local Connect TPS gateway.

`wakeup (wake) [ pid ]`
  wakes up (signals) a process.

When you invoke the mode subcommand, tmadmin enters a multiline input mode that lasts until you enter "q" or "quit" on a line by itself. All commands you enter are sent to the remote Connect TPS gateway you select. See the user documentation for your remote gateway to determine what COMMAND messages it supports.

[Top] [Previous] [Next] [End of Book]