Command Reference
tmadmin
—BEA Tuxedo bulletin board command interpreter.
tmadmin [ -r ] [ -c ] [ -v ]
With the commands listed in this entry, tmadmin
provides for the inspection and modification of bulletin boards and associated entities in a uniprocessor, multiprocessor, or networked environment. The TUXCONFIG
and TUXOFFSET
environment variables are used to determine the location and offset at which the BEA Tuxedo configuration file is loaded.tmadmin
supports the following options:
If tmadmin
is invoked with the -c
option, it enters configuration mode. The only valid commands are default
, echo
, help
, quit
, verbose
, livtoc
, crdl
, lidl
, dsdl
, indl
, and dumptlog
. tmadmin
may be invoked in this mode on any node, including inactive nodes. A node is considered active if tmadmin
can join the application as an administrative process or client (via a running BBL
).
The -r
option instructs tmadmin
to enter the bulletin board as a client instead of as the administrator; in other words, it requests read-only access. This option is useful if you want to leave the administrator slot unoccupied.
Note: If you decide to use this option, however, be aware that you will not get all the information you get by running tmadmin
without the -r
option. Specifically, tmadmin -r
does not report load values for servers running at remote sites.
Only one tmadmin
process can be the administrator at a time. When the -r
option is specified by a user other than the BEA Tuxedo administrator and security is turned on, the user is prompted for a password.
Normally, tmadmin
may be run on any active node within an active application. If it is run on an active node that is partitioned, commands are limited to read-only access to the local bulletin board. These command include bbls
, bbparms
, bbstat
, default
, dump
, dumptlog
, echo
, help
, interfaceparms, printactiveobject, printclient
, printinterface, printfactory, printnet
, printqueue
, printroute, printserver
, printservice
, printtrans
, printgroup
, reconnect
, quit
, serverparms
, serviceparms
, and verbose
, in addition to the configuration commands. If the partitioned node is the backup node for the MASTER
(specified as the second entry on the MASTER
parameter in the RESOURCES
section of the configuration file), the master
command is also available to make this node the MASTER
for this part of the partitioned application.
If the application is inactive, tmadmin
can be run only on the MASTER
processor. In this mode, all of the configuration mode commands are available plus the TLOG
commands (crlog
, dslog
, and inlog
) and boot
.
Once tmadmin
has been invoked, commands may be entered at the prompt (>
) according to the following syntax:
Several commonly occurring arguments can be given defaults via the default
command. Commands that accept parameters set via the default
command check default
to see whether a value has been set. If a value has not been set, an error message is returned.
In a networked or multiprocessor environment, a single bulletin board can be accessed by setting a default
machine
(the logical machine ID
(LMID
) as listed in the MACHINES
section of the UBBCONFIG
file). If the default
machine
is set to all
, all bulletin boards are accessed. If machine
is set to DBBL
, the distinguished bulletin board is addressed. The default
machine
is shown as part of the prompt, as in: MASTER>
.
If machine
is not set via the default
command, the DBBL
is addressed (the local BBL is used in a SHM configuration).
The machine
value for a command can generally be obtained from the default
setting (printserver
is an example). A caution is required here, however, because some commands (the TLOG
commands, for example) act on devices found through TUXCONFIG
; a default
setting of DBBL
or all
results in an error. For some commands, such as logstart
, you must specify the value of machine
on the command line; the value does not appear as an argument to the -m
option.
Once set, a default remains in effect until the session is ended, unless changed by another default
command. Defaults may be overridden by entering an explicit value on the command line, or unset by entering the value "*". The effect of an override lasts for a single instance of the command.
Output from tmadmin
commands is paginated according to the pagination command in use (see the description of the paginate
subcommand later in this entry).
There are some commands that have either verbose or terse output. The verbose
command can be used to set the default output level. However, each command (except boot
, shutdown
, and config
) takes a -v
or -t
option to turn on verbose or terse output for that command only. When output is printed in terse mode, some information (for example, LMID
or GROUP
name, service name, or server name) may be truncated. This type of truncation is indicated by a plus sign, +, at the end of the value. The entire value may be seen by reentering the command in verbose mode.
Commands may be entered either by their full name or their abbreviation (as given in parentheses), followed by any appropriate arguments. Arguments appearing in square brackets, [], are optional; those in curly braces, {}, indicate a selection from mutually exclusive options. Note that command line options that do not appear in square brackets need not appear on the command line (that is, they are optional) if the corresponding default has been set via the default
command. Ellipses following a group of options in curly brackets, {}...
, indicate that more than one of the options listed may appear on the command line (at least one must appear).
If groupname
is specified (on the command line or by default), aborts the transaction associated with the specified transaction index tranindex
at the specified server group. Otherwise, notifies the coordinator of the transaction to abort the global transaction. If the transaction is known to be decided and the decision was to commit, aborttrans
will fail. The index is taken from the previous execution of the printtrans
command. To completely get rid of a transaction, printtrans
and aborttrans
must be executed for all groups that are participants in the transaction. This command should be used with care.
advertise
(adv
) {-q
qaddress
[ -g
groupname
]
[-i
srvid
] | -g
groupname
-i
srvid
} service
[:
func
]
Creates an entry in the service table for the indicated service. service
may be mapped onto a function func
. If qaddress
is not specified, both groupname
and srvid
are required to uniquely identify a server. If this service
is to be added to an MSSQ set, all servers in the set will advertise the service. If all servers in an MSSQ set cannot advertise the service, the advertisement is disallowed. Services beginning with the character `.' are reserved for use by system servers and will fail to be advertised for application servers.
Checks the integrity of all accessers of the bulletin board residing on machine machine
, and the DBBL
as well. bbclean
gracefully removes dead servers and restarts them if they are marked as restartable. It also removes those resources no longer associated with any processes. As its last step, bbclean
causes the DBBL
to check the status of each BBL
. If any BBL
does not respond within SCANUNIT
seconds, it is marked as partitioned. To clean only the Distinguished bulletin board, machine
should be specified as DBBL
. In SHM mode, bbclean
restarts the BBL
, if it has failed; the machine
parameter is optional.
Prints a summary of the bulletin board's parameters, such as the maximum number of servers, objects, interfaces, and services.
Lists the IPC resources for the bulletin board on machine machine
. In SHM
mode, the machine
parameter is optional. Information from remote machines is not available.
This command is identical to the tmboot()
command. See tmboot(1)
for an explanation of options and restrictions on use.
broadcast
(bcst
) [-m
machine
] [-u
usrname
] [-c
cltname
] [text
]
Broadcasts an unsolicited notification message to all selected clients. The message sent is a typed buffer of the type STRING
with the data being text
. text
may be no more than 80 characters in length. If text
is to contain multiple words, it must be enclosed in quotation marks ("
text text
"
). If any parameter is not set (and does not have a default), it is taken to be the wildcard value for that identifier.
changeload
(chl
) [-m
machine
] {-q
qaddress
[-g
groupname
]
[-i
srvid
] -s
service
| -g
groupname
-i
srvid
-s
service
| -I interface
[-g
groupname
]
} newload
Changes the load associated with the specified service or interface to newload
. If qaddress
is not specified, both groupname
and srvid
must be specified. For CORBA environments, interface
may be specified. If machine
is set to all
or is not set, the change is made on all machines; otherwise, a local change is made on the specified machine
. Local changes are overridden by any subsequent global (or local) changes.
changepriority
(chp
) [-m
machine
] {-q
qaddress
[-g
groupname
]
[-i
srvid
] -s
service
| -g
groupname
-i
srvid
-s
service
| -I interface
[-g
groupname
]
} newpri
Changes the dequeuing priority associated with the specified service or interface to newpri
. If qaddress
is not specified, both groupname
and srvid
must be specified. For CORBA environments, interface
may be specified. If machine
is set to all
or is not set, the change is made on all machines; otherwise, a local change is made on the specified machine
. Local changes are overridden by any subsequent global (or local) changes.
changetrace
(chtr
) [-m
machine
] [-g
groupname
] [-i
srvid
] newspec
Changes the run-time tracing behavior of currently executing processes to newspec
. (See tmtrace(5) for the syntax of newspec
.) To change the trace specification of a specific currently running server process, supply the -g
and -i
options. To change the configuration of currently-running server processes in a specific group, supply the -g
option without the -i
option. To change the configuration of all currently-running client and server processes on a particular machine, specify the -m
option. If none of the -g
, -i
, and -m
options is supplied, all non-administrative processes on the default machine are affected. This command does not affect the behavior of clients or servers that are not currently executing, nor Workstation clients.
changetrantime
(chtt
)
[-m
machine
] {-q
qaddress
[-g
groupname
] -
[-i
srvid
] -s
service
| -g
groupname
-i
srvid
-s
service
| -I interface
[-g
groupname
]
} newtlim
Changes the transaction timeout value associated with the specified service or interface to newtlim
. If qaddress
is not specified, both groupname
and srvid
must be specified. For CORBA environments, interface
may be specified. If machine
is set to all
or is not set, the change is made on all machines; otherwise, a local change is made on the specified machine
. Local changes are overridden by any subsequent global (or local) changes.
Commits the transaction associated with the specified transaction index tranindex
at the specified server group. committrans
will fail if the transaction has not been precommitted at the specified server group or if the transaction is known to be abort-only. The index is taken from the previous execution of the printtrans
command. This command prompts for confirmation before proceeding unless the -yes
option is used. This command should be used with care.
This command is identical to the tmconfig
command. See tmconfig, wtmconfig(1)
for an explanation of its use.
crdl
-b
blocks
-z
config
-o
configoffset
[ -O
newdefoffset
] [ newdevice
]
Creates an entry in the universal device list. blocks
specifies the number of physical blocks to be allocated on the device. The default blocks
value is initialized to 1000 blocks. configoffset
specifies the block number at which space may begin to be allocated. If the -o
option is not given and a default has not been set, the value of the environment variable FSOFFSET
is used. If FSOFFSET
is not set, the default is 0. config
points to the first device (which contains the device list); it must be an absolute pathname (starting with /). If the -z
option is not given and a default has not been set, the path named by the FSCONFIG
environment variable is used. The newdevice
argument to the crdl
command, if specified, points to the device being created; it must be an absolute pathname (starting with /). If this parameter is not given, the newdevice
defaults to the config device. newdefoffset
specified an offset to the beginning of newdevice
. If not specified with the -O
(capital O) option of default, the default is 0 (zero).
Creates the DTP transaction log for the named or default machine
(it cannot be "DBBL" or "all"). An error is returned if a TLOG
is not defined for the machine on the configuration. This command references the TUXCONFIG
file to determine the BEA Tuxedo file system containing the TLOG
, the name of the TLOG
in that file system, the offset, and the size (see UBBCONFIG(5)).
default
(d
) [-g
groupname
] [-i
srvid
] [-m
machine
] [-u
usrname
] [-c
cltname
]
[-q
qaddress
] [-s
service
] [-b
blocks
] [-o
offset
] [-z
config
] [-a
{ 0
| 1
| 2
}] [-I interface] [-B objectid] [-r routingname]
Sets the corresponding argument to be the default group name, server ID, machine, user name, client name, queue address, service name, device blocks, device offset, or UDL configuration device path (it must be an absolute pathname starting with /). See printservice
for information on the -a
option. For CORBA environments, you can also set corresponding arguments to be the default object interface name, object ID, or factory-based routing name. When the objectID parameter is specified (with -B), the machine argument (-m
) must also be specified. All defaults may be unset by specifying * as an argument. If machine
has been set to a machine identifier, and later retrievals are to be done from the Distinguished bulletin board, machine
should be set to DBBL
. Unsetting the machine
(-m
*
) is equivalent to setting it to DBBL
. If the default
command is entered with no arguments, the current defaults are printed.
Destroys an entry found in the universal device list. The dlindex
argument is the index on the universal device list of the device that is to be removed from the device list. Entry 0 cannot be removed until all VTOC
files and other device list entries are destroyed first (because entry 0 contains the device which holds the device list and table of contents, destroying it also destroys these two tables.) config
points to the device containing the universal device list; it must be an absolute pathname (starting with /). If the -z
option is not given and a default has not been set, the path named by the FSCONFIG
environment variable is used. offset
specifies an offset into config
. If the -o
option is not given and a default has not been set, the value of the environment variable FSOFFSET
is used. If FSOFFSET
is not set, the default is 0. This command prompts for confirmation before proceeding unless the -yes
option is used.
Destroys the DTP transaction log for the named or default machine
(it cannot be "DBBL" or "all"). An error is returned if a TLOG
is not defined for the machine, if the application is not inactive, or if outstanding transaction records exist on the log. The term outstanding transactions means that a global transaction has been committed but an end-of-transaction has not yet been written. This command references the TUXCONFIG
file to determine the BEA Tuxedo file system containing the TLOG
and name of the TLOG
in that filesystem. This command prompts for confirmation before proceeding unless the -yes
option is specified.
dumptlog
(dl
) -z
config
[ -o
offset
] [ -n
name
] [ -g
groupname
] filename
Dumps a text version of the TLOG
into the specified filename
. The TLOG
is located on the specified config
and offset
, and has the specified name
. If the -n
option is not given and a default has not been set, the name "TLOG" is used. config
points to the device containing the universal device list; it must be an absolute pathname (starting with /). If the -z
option is not given and a default has not been set, the path named by the FSCONFIG
environment variable is used. The -o
offset
option can be used to specify an offset into config
. If the -o
option is not given and a default has not been set, the value of the environment variable FSOFFSET
is used. If FSOFFSET
is not set, the default is 0. If groupname
is specified, only log records for transactions where that group is the coordinator are dumped.
Echoes input command lines when set to on
. If no option is given, the current setting is toggled, and the new setting is printed. The initial setting is off
.
Prints help messages. If command
is specified, the abbreviation, arguments, and description for that command are printed. all
causes a description of all commands to be displayed. Omitting all arguments causes the syntax of all commands to be displayed.
Re-initializes a device on the device list. The argument dlindex
is the index of the device on the universal device list of the device that is to be reinitialized. All space on the specified device is freed; this means that any files, etc., stored on the device may be overwritten in the future so this command must be used cautiously. This command prompts for confirmation before proceeding unless the -yes
option is used. config
points to the device containing the universal device list; it must be an absolute pathname (starting with /). If the -z
option is not given and a default has not been set, the path named by the FSCONFIG
environment variable is used. The -o
offset
option can be used to specify an offset into config
. If the -o
option is not given and a default has not been set, the value of the environment variable FSOFFSET
is used. If FSOFFSET
is not set, the default is 0.
Re-initializes the DTP transaction log for the named or default
machine
(it cannot be "DBBL" or "all"). An error is returned if a TLOG
is not defined for the machine or if the application is not inactive. If outstanding transactions exist on the TLOG
, data may be inconsistent across resource managers acting as participants in these transactions since the resource managers may abort the local transaction instead of correctly committing the transaction. This command references the TUXCONFIG
file to determine the BEA Tuxedo filesystem containing the TLOG
and name of the TLOG
in that filesystem. This command prompts for confirmation before proceeding unless the -yes
option is specified.
Print information about a specific object interface, including the name of the interface, and the load, priority, timeout, and transaction timeout value associated with it. The groupname and interface arguments must be unique. This command is only used in CORBA environments.
Prints the universal device list. For each device the following is listed: the name, the starting block, and the number of blocks on the device. In verbose mode, a map is printed which shows free space (starting address and size of free space). If dlindex
is specified, only the information for that device list entry is printed. config
points to the device containing the universal device list; it must be an absolute pathname (starting with /). If the -z
option is not given and a default has not been set, the path named by the FSCONFIG
environment variable is used. The -o
offset
option can be used to specify an offset into config
. If the -o
option is not given and a default has not been set, the value of the environment variable FSOFFSET
is used. If FSOFFSET
is not set, the default is 0.
Prints information for all VTOC
table entries. The information printed for each entry includes the name of the VTOC
table, the device on which it is found, the offset of the VTOC
table from the beginning of the device and the number of pages allocated for that table. config
points to the device containing the universal device list; it must be an absolute pathname (starting with /). If the -z
option is not given and a default has not been set, the path named by the FSCONFIG
environment variable is used. The -o
offset
option can be used to specify an offset into config
. If the -o
option is not specified, the value of the environment variable FSOFFSET
is used. If FSOFFSET
is not set, the default is 0.
Reads the text version of a TLOG
from the specified filename
(produced by dumptlog
) into the existing TLOG
for the named or default
machine
(it cannot be "DBBL" or "all").
Forces a warm start for the TLOG
information on the specified machine
. This should normally be done following a loadtlog
and after disk relocation during server group migration.
If master
is run on the backup node when partitioned, the backup node takes over as the acting master node and a DBBL is booted to take over administrative processing. If master
is run on the master node when the backup node is acting as the master, the DBBL is migrated to the master node, and the backup node is no longer the acting master node. This command prompts for confirmation before proceeding unless the -yes
option is specified.
The migrategroup
command takes the name of a server group. If the configuration file specifies the MIGRATE
option and an alternate location for the group, all servers in group_name
are migrated to the alternate location. Servers must be shut down for migration with the following command:
The -R
option retains server names in the bulletin board so that migration can be done. The migration can be canceled after the shutdown -R
by the following command:
The -cancel
option deletes the server names from the bulletin board.
All servers running on the specified machine
are migrated to their alternate location. Servers must be shut down for migration with the following command:
When the migratemachine
command is used, all server groups located on machine
must have the same alternate location (otherwise migrategroup
must be used). Migration of an LMID
(that is, machine) that contains Domains gateway servers implies the migration of these gateway servers to the alternate LMID
. Specifying the -cancel
option causes a migration that is already in progress to be cancelled. In other words, the servers have been shut down—with the tmshutdown -R
command—but have not yet been migrated.
Paginates output. If no option is given, the current setting is toggled, and the new setting is printed. The initial setting is on, unless either standard input or standard output is a non-tty
device. Pagination may be turned on only when both standard input and standard output are tty
devices.
The default paging command is indigenous to the native operating system environment. In a UNIX operating system environment, for example, the default paging command is pg
.The shell environment variable PAGER
may be used to override the default command used for paging output.
pclean
first forces a bbclean
on the specified machine
to restart or clean up any servers that may require it. If machine
is partitioned, entries for processes and services identified as running on machine
are removed from all non-partitioned bulletin boards. If machine
is not partitioned, any processes or services that cannot be restarted or cleaned up are removed.
printclient
(pclt
) [-m
machine
] [-u
usrname
] [-c
cltname
][-v
]
Prints information for the specified set of client processes. If no arguments or defaults are set, information on all clients is printed. In a multicontexted client, printclient
produces a separate entry for each context. The -m
, -u
, and -c
options or defaults can be used to restrict the information to any combination of machine, user name, or client name.
pclt-v
adds the heading "Network Address" and IP address number for remote client information output.
If the native client name is not specified, pclt-v displays
the heading "Application Name or Process ID" followed by the process ID (PID).
Prints information about conversational connections. The -m
option or default can be used to restrict the information to connections to or from the specified machine. A machine
value of "all" or "DBBL" prints information from all machines.
Print information about objects that are active in the domain. The information includes the object ID, interface name, service name, program name, group ID, process ID, and reference count. The command accepts an object ID and a machine ID as optional parameters. If no object ID is specified, information for all active objects is printed. If no machine ID is specified, information is provided for all active objects on the machine where the command is issued. Any object ID that contains over 128 characters is displayed as a 40-character, alphanumeric, hash value.
Print information about object factories registered with the factory finder. The information includes the name of the interface, its factory identifier, and attributes of the current factory status. This command takes no arguments. This command is only used in CORBA environments.
Prints server group table information. The default is to print information for all groups. The -g
and -m
options or defaults can be used to restrict the information to a combination of group or machine. The information printed includes the server group name, the server group number, primary and alternate LMIDs, and the current location.
printinterface (pif)
[-m
machine
] [-g
groupname
] [-I
interface
]
Print information about specified object interfaces, including the interface name, queue name, group ID, machine ID, routing name, and the number of requests done by the interface. The command accepts a machine name, group name, and interface name as optional parameters. If a machine name is specified, the number of active objects for the interface is printed. Otherwise, a hyphen (-) indicates that the information about active objects is unavailable. This command is only used in CORBA environments.
Prints network connection information. The default is to print information for all machines. The printnet
command optionally takes a comma-separated list of machines (LMIDs
) as arguments. If such a list is provided, information is restricted to network connections involving the specified machines. For each machine, the information indicates whether the machine is partitioned. If a machine is not partitioned, information is printed indicating the other machines to which it is connected and counts of messages in and out.
Prints queue information for all application and administrative servers. The default is to print information about all queues. The qaddress
command line or default can be used to restrict information to a specific queue. Output includes the server name and the name of the machine on which the queues reside.
Print information about factory-based routing definitions, including routing name, type, field, and ranges. If routingname is not specified, all existing routes are displayed. This commands prints routes for both BEA TUXEDO data dependent routing and CORBA factory-based routing. The type field in the output displays FACTORY for factory-based routing entries and SERVER for data-dependent routing entries. When information for data-dependent routing entries has been requested in verbose mode, the output includes buffer type and field type. This command is only used in CORBA environments.
printserver
(psr
) [-m
machine
] [-g
groupname
] [-i
srvid
] [-q
qaddress
]
Prints information for application and administrative servers. The -q
, -m
, -g
, and -i
options can be used to restrict the information to any combination of queue address, machine, group, and server. In a multicontexted server, printserver
prints a single entry for all contexts in the server.
printservice
(psc
) [-m
machine
] [-g
groupname
] [-i
srvid
] [-a
{ 0
| 1
| 2
}]
[-q
qaddress
] [-s
service
]
Prints information for application and administrative services. The -q
, -m
, -g
, -i
and -s
options can be used to restrict the information to any combination of queue address, machine, group, server or service. The -a
option allows you to select the class of service: -a0
limits the display to application services, -a1
selects application services plus system services that can be called by an application, -a2
selects both of those, plus system services that can be called by the BEA Tuxedo system.
Prints global transaction table information for either the specified or the default machine. If machine
is "all
" or "DBBL
," then information is merged together from transaction tables at all non-partitioned machines in the application. The command line or default groupname
value can be used to restrict the information to transactions in which the group is a participant (including the coordinator).
When printed in terse mode, the following information is provided: the transaction identifier, an index used for aborting or committing transactions with aborttrans
or committrans
, the transaction status, and a count of participants.
In verbose mode, transaction timeout information and participant information (for example, server group names and status, including the identity of the coordinator) is also printed.
reconnect
(rco
) non-partitioned_machine1 partitioned_machine2
Initiates a new connection from the non-partitioned machine to the partitioned machine. reconnect
forces a new connection from the non-partitioned machine to the partitioned machine. If a connection is already active, it is closed before the reconnect. This may cause in-transit messages to be lost, resulting in transaction timeouts. It is possible for a machine or network connection to be down, but the network interface driver will continue to accept and buffer requests without any error indication to the BRIDGE
. In this case, reconnect
will fail, forcing the BRIDGE
to recognize that the remote machine cannot be reached. Note that in most cases, after network problems are resolved, the BRIDGE
reconnects automatically, making manual intervention (with reconnect
) unnecessary.
resume
(res
) {-q
qaddress
| -g
groupname
| -i
srvid
| -s
service
| -I
interface
} . . .
Resumes (unsuspend) services. The -q
, -g
, -s
, -I, and -i
options can be used to restrict the resumed services to any combination of queue, group, service, interface (CORBA environments only), and server. (At least one of these options must be specified or have a default.) Thus the following command line provides a shortcut method of unsuspending all services advertised on the queue with the address servq8
:
Once a suspended service is resumed, the offering server is selected as a candidate server for that service, as well as for other (unsuspended) services it may offer. If multiple servers are reading from a single queue, the status of a particular service is reflected in all servers reading from that queue.
If
MODEL SHM
is specified in the configuration file, shmstats
can be used to assure more accurate statistics. When entered with no argument, shmstats
returns the present setting of the TMACCSTATS
flag of the bbparms.options
member of the bulletin board structure. This tells you whether statistics presently being gathered are exact or approximate. If the command is entered with ex
specified, shmstats
turns on the TMACCSTATS
flag, locks the bulletin board, and zeroes out the counters for server table, queue table, and service table entries.
This command is identical to the tmshutdown()
command. tmshutdown
options can be used to select servers to be stopped. See tmshutdown(1)
for an explanation of options and restrictions on use.
suspend
(susp
) {-q
qaddress
| -g
groupname
| -i
srvid
| -s
service
| -I
interface
} . . .
Suspends services. The -q
, -g
, -s
, -I, and -i
options can be used to restrict the suspended services to any combination of queue, group, service, interface (CORBA environments only), and server (At least one of these options must be specified or have a default.) Thus the following command provides a shortcut method of suspending all services advertised on the queue with the address servq8
:
When a service is suspended, the offering server is no longer selected as a candidate server for that service, although it continues to be selected to process other services it may offer. Queued requests for the suspended service are processed until the queue is drained. If multiple servers are reading from a single queue, the status of a particular service is reflected in all servers reading from that queue.
unadvertise
(unadv
) {-q
qaddress
[-g
groupname
] [-i
srvid
] | -g
groupname
-i
srvid
} service
Removes an entry in the service table for the indicated service
. If qaddress
is not specified, both groupname
and srvid
are required to uniquely identify a server. Specifying either a queue or a particular server on that queue achieve the same results. If this service
is to be removed from a multiple server, single queue (MSSQ) set, the advertisement for service
is removed from all servers reading from that queue.
Produces output in verbose mode. If no option is given, the current setting is toggled, and the new setting is printed. The initial setting is off
. The -v
(verbose) and -t
(terse) options on individual commands can be used to temporarily override the current setting.
When tmadmin
runs as the administrator, it does not pass through security since it is already checked to be the application administrator's login ID.
The only time that tmadmin
may run as someone other than the application administrator is if the -r
option is used to access the application as a client. If such a user invokes tmadmin
with the -r
option, and if security is turned on for the application, the application password is required to access application data. If standard input is a terminal, tmadmin
prompts the user for the password with echo turned off on the reply. If standard input is not a terminal, the password is retrieved from the APP_PW
environment variable. If this environment variable is not specified and an application password is required, tmadmin
fails.
tmadmin
acts as an application client if the -r
option is used or if it cannot register as the application administrator. If this is the case, and if standard input is not from a terminal, the APP_PW
environment variable must be set to the application password in a security application.
If the tmadmin
command is entered before the system has been booted, the following message is displayed:
No bulletin board exists. Entering boot mode
>
tmadmin
then waits for a boot
command to be entered:
If the tmadmin
command is entered, without the -c
option, on an inactive node that is not the MASTER
, the following message is displayed and the command terminates:
Cannot enter boot mode on non-master node.
If an incorrect application password is entered or is not available to a shell script through the environment, a log message is generated and the command terminates, after displaying the following message:
Invalid password entered.
tmadmin
may be run on any node within an active interoperating application. However, the commands and command-line arguments available are restricted to those available via tmadmin
in the release corresponding to the node on which tmadmin
is running. For example, the broadcast
, passwd
, and printclient
commands are not available on Release 4.1 nodes.
tmadmin
is supported on any platform on which the BEA Tuxedo server environment is supported.
The machine
option has no effect in a non-networked uniprocessor environment.
tmboot(1)
, tmloadcf(1)
, tmshutdown(1)
, compilation(5), UBBCONFIG(5)