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:
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 following subsections describe the printdomain subcommand.
The printdomain subcommand (pd) displays information about Connect TPS gateways. This includes:
The syntax of the printdomain subcommand is as follows:
where:
Syntax and Usage
tmadmin
printdomain (pd) [ { -i srvid | -g grpid | -q qaddress } ]
-i srvid
-g grpid
-q qaddress
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:
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.
Here is an example of the output that the printdomain subcommand produces. (In actual output, the variables shown would be replaced with literal values.)
The following subsections describe the stats subcommand.
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.
The syntax of the stats subcommand is as follows:
where:
Example
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
Description
Syntax and Usage
tmadmin
stats {-i srvid | -g grpid | -q qaddress } [ -s service ]
-i srvid
-g grpid
-q qaddress
-s service
As the syntax indicates, you obtain information about services by specifying one of the following:
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.
Here is an example of the stats subcommand and the output it produces:
The following subsections describe the mode subcommand.
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.
The syntax of the mode subcommand is as follows:
The optional command [ argument ] parameter can be one of the following:
Here are descriptions of parameters that are used to specify which Connect TPS Liaison will process the mode subcommand:
Example
$ 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
Description
Syntax and Usage
tmadmin
mode { -g group | -i srvid | -q qaddress }
> command [ arguments ]clearstats (clr) [ service ]
help (h) [ command ]
ping [ otpid ]
remotecommand (rcmd) otpid command [ ; command ]
stats [ service ]
wakeup (wake) [ pid ]
-g group
-i srvid
-q qaddress
Here are descriptions of the optional commands and arguments you can direct to the specified Connect TPS gateway:
clearstats (clr) [ service ]
help (h) [ command ]
ping [ otpid]
remotecommand (rcmd) otpid command [ ; command . . . ]
stats [ service ]
wakeup (wake) [ pid ]
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.