BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

 

   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo Command Reference

tmadmin(1)

Name

tmadmin - BEA Tuxedo bulletin board command interpreter

Synopsis

tmadmin [ -r ] [ -c ] [ -v ]

Description

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.

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.

The -v option causes tmadmin to display the BEA Tuxedo version number and license number. After printing out the information, tmadmin exits. If the -v option is entered with either of the other two options, the others are ignored; only the information requested by the -v option is displayed.

Normally, tmadmin may be run on any active node within an active application. If it is run on an active node that is partitioned, then commands are limited to read-only access to the local bulletin board. These command include bbls, bbparms, bbstat, default, dump, dumptlog, echo, help, printclient, printnet, printqueue, 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.

command [arguments]

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 re-entering the command in verbose mode.

tmadmin Commands

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

aborttrans (abort) [ -yes ] [ -g groupname ] tranindex

If groupname is specified (on the command line or by default), abort the transaction associated with the specified transaction index tranindex at the specified server group. Otherwise, notify 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]

Create an entry in the service table for the indicated service. service may be mapped onto a function func. If qaddress is not specified, then 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.

bbclean (bbc) machine

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

bbparms (bbp)

Print a summary of the bulletin board's parameters, such as the maximum number of servers and services.

bbsread (bbls) machine

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

bbstats (bbs)

Print a summary of bulletin board statistics. (See also shmstats.)

boot (b) [options]

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, then it must be enclosed in quotation marks ("text text"). If any parameter is not set (and does not have a default), then 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 } newload

Change the load associated with the specified service to newload. If qaddress is not specified, then both groupname and srvid must 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 over-ridden 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 } newpri

Change the dequeuing priority associated with the specified service to newpri. If qaddress is not specified, then both groupname and srvid must 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 over-ridden by any subsequent global (or local) changes.

changetrace (chtr) [-m machine] [-g groupname] [-i srvid] newspec

Change 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, then 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 } newtlim

Change the transaction timeout value associated with the specified service to newtlim. If qaddress is not specified, then both groupname and srvid must 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 over-ridden by any subsequent global (or local) changes.

committrans (commit) [ -yes ] -g groupname tranindex

Commit the transaction associated with the specified transaction index tranindex at the specified server group. committrans will fail if the transaction has not been pre-committed 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.

config (conf)

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 ]

Create 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 path name (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 path name (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).

crlog (crlg) -m machine

Create 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}]

Set 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 path name starting with /). See printservice for information on the -a option. 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.

dsdl [ -yes ] -z config [ -o offset ] dlindex

Destroy 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 path name (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.

dslog (dslg) [ -yes ] -m machine

Destroy 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 file system. This command prompts for confirmation before proceeding unless the -yes option is specified.

dump (du) filename

Dump the current bulletin board into the file filename.

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 path name (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, then only log records for transactions where that group is the coordinator are dumped.

echo (e) [{off | on}]

Echo input command lines when set to on. If no option is given, then the current setting is toggled, and the new setting is printed. The initial setting is off.

help (h) [{command | all}]

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

initdl (indl) [ -yes ] -z config [ -o offset ] dlindex

Reinitializes 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 path name (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.

inlog [ -yes ] -m machine

Reinitialize 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 file system containing the TLOG and name of the TLOG in that file system. This command prompts for confirmation before proceeding unless the -yes option is specified.

lidl -z config [ -o offset ] [ dlindex ]

Print 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, then 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 path name (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.

livtoc -z config [ -o offset ]

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 path name (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.

loadtlog -m machine filename

Read 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").

logstart machine

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

master (m) [ -yes ]

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.

migrategroup (migg) [-cancel] group_name

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.

shutdown -R -g groupname

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.

migrategroup -cancel groupname

The -cancel option deletes the server names from the bulletin board.

migratemach (migm) [-cancel] machine

All servers running on the specified machine are migrated to their alternate location. Servers must be shut down for migration with the following command.

shutdown -R -l machine

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.

paginate (page) [{off | on}]

Paginate output. If no option is given, then 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.

passwd

Prompt the administrator for a new application password in an application requiring security.

pclean (pcl) machine

pclean first forces a bbclean on the specified machine to restart or cleanup 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 can not be restarted or cleaned up are removed.

printclient (pclt) [-m machine] [-u usrname] [-c cltname]

Print information for the specified set of client processes. If no arguments or defaults are set, then 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.

printconn (pc) [-m machine]

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

printgroup (pg) [-m machine] [-g groupname]

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

printnet (pnw) [ mach_list ]

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

printqueue (pq) [qaddress]

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

printserver (psr) [-m machine] [-g groupname] [-i srvid] [-q qaddress]

Print 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]

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

printtrans (pt) [-g groupname] [-m machine]

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

quit (q)

Terminate the session.

reconnect (rco) non-partitioned_machine1 partitioned_machine2

Initiate 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} . . .

Resume (unsuspend) services. The -q, -g, -s, and -i options can be used to restrict the resumed services to any combination of queue, group, service, 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.

> resume -q 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.

serverparms (srp) -g groupname -i srvid

Print the parameters associated with the server specified by groupname and srvid for a group.

serviceparms (scp) -g groupname -i srvid -s service

Print the parameters associated with the service specified by groupname, srvid, and service.

shmstats (sstats) [ ex | app ]

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.

shutdown (stop) [options]

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

Suspend services. The -q, -g, -s, and -i options can be used to restrict the suspended services to any combination of queue, group, service, 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.

> suspend -q 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

Remove an entry in the service table for the indicated service. If qaddress is not specified, then 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, then the advertisement for service is removed from all servers reading from that queue.

verbose (v) [{off | on}]

Produce output in verbose mode. If no option is given, then 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.

! shellcommand

Escape to the shell and execute shellcommand.

!!

Repeat previous shell command.

# [text]

Lines beginning with "#" are comment lines and are ignored.

<CR>

Repeat the last command.

Security

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, then the application password is required to access application data. If standard input is a terminal, then 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, then tmadmin fails.

Environment Variables

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, then the APP_PW environment variable must be set to the application password in a security application.

Diagnostics

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, then a log message is generated and the command terminates, after displaying the following message.

Invalid password entered.

Interoperability

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.

Portability

tmadmin is supported on any platform on which the BEA Tuxedo server environment is supported.

Notices

The machine option has no effect in a non-networked uniprocessor environment.

See Also

tmboot(1), tmloadcf(1), tmshutdown(1), compilation(5), UBBCONFIG(5)

Administering a BEA Tuxedo Application at Run Time