[Top]
[Previous Page] [Next Page] [Bottom]
The BEA TUXEDO system allows you to make changes to your configuration without shutting
it down. Without inconveniencing your users, you can suspend or resume interfaces or
services, advertise or unadvertise services, and change interface or service parameters
(such as LOAD
and PRIORITY
). If your configuration
specifies interfaces or services as AUTOTRAN
,
it is also possible to change the timeout value associated with such transactions. Thus,
you can adjust your system to reflect either current or expected conditions.
This chapter discusses the following topics:
You have a choice of two methods for making changes to your system while the system is running:
tmadmin
command
interpreter-a shell-level command with 50 subcommands for performing various
administrative tasks, including dynamic system modification Because it is a graphical user interface, the Web-based GUI is simpler to use than the tmadmin
command interpreter. If you
prefer using a GUI, bring it up on your screen as soon as you are ready to begin an
administrative task. The graphics and detailed procedures will guide you through any task
you need to perform.
For instructions on using the tmadmin
command interpreter, see Chapter 8, "Monitoring a Running System."
Instructions for dynamically modifying your system through tmadmin
are provided in this
chapter.
This section provides procedures for making the following types of changes, through tmadmin
, while your system is
running:
AUTOTRAN
timeout value This section provides instructions for suspending and resuming services and servers, and describes the results of these operations.
Note: The two commands described in this section have minimal impact on the BEA TUXEDO system.
To suspend a server or a service, enter the suspend
(or susp
)
command, as follows.
prompt> tmadmin > susp
The suspend
command
marks as inactive one of the following:
After you have suspended a service or a server, any requests remaining on the queue are handled, but no new service requests are routed to the suspended server. If a group ID/server ID combination is specified and it is part of an MSSQ set, all servers in that MSSQ set become inactive for the services specified.
To resume a server or a service, enter the resume
(or res
)
command, as follows.
prompt> tmadmin > res
The resume
command
undoes the effect of the suspend
command: it marks as active for the queue one of the following:
If, in this state, the group ID or the server ID is part of an MSSQ set, all servers in that MSSQ set become active for the services specified.
This section provides instructions for advertising and unadvertising services and servers, and describes the results of these operations.
To advertise a service, enter the following command.
adv [{[-q queue_name] | [-g grpid] [-i srvid]}] service
Note: Although a service must be suspended before it may be unadvertised, you do not need to "unsuspend" a service before re-advertising it. If you simply advertise a service that has been suspended and unadvertised previously, the service will be unsuspended.
To unadvertise a service, complete the following procedure.
unadv [{[-q queue_name] | [-g grpid] [-i srvid]}] service
Note: Unadvertising has more drastic results than suspending because when you unadvertise a service, the service table entry for that service is deallocated and the cleared space in the service table becomes available to other services.
You can change the service parameter values for the following:
The following table lists the names of the parameters for which you can change values dynamically, along with the commands for changing them.
To Change . . . | Enter the Following Command . . . |
---|---|
Load
value (LOAD ) |
chl -s service_name |
Dequeueing
priority (PRIO ) |
chp -s service_name |
Transaction timeout value | chtt -s service_name |
You must specify a service name (after the -s
option) for all three commands.
You can specify this option on either the command line (for the chl
, chp
, or chtt
command) or on a default
subcommand line.
Note: The -s
option is listed as optional because the required value may be specified on the default
subcommand line.
To change the transaction timeout (TRANTIME
)
of an interface or service with the AUTOTRAN
flag set, run the changetrantime
(chtt
) command, as
follows.
chtt [-m machine
]
{-q qaddress
[-g groupname
]
[-i srvid
] |-g\
groupname
-i srvid
} -s service
newtlim
Note: Transaction timeouts begun by application clients using tpbegin()
or tx_set_transaction_timeout()
cannot
be changed.
[Top] [Previous Page] [Next Page] [Bottom]