BEA Tuxedo systems can require clients to run on a workstation for purposes of security, performance, and convenience. A network administrator can define the environment required to control workstation clients using the Workstation MIB. This MIB is an extension of the Core MIB and specifies the information required to control access to a Tuxedo application from multiple workstations.
The Tuxedo Workstation subsystem consists of a workstation clients (WSC) library, the workstation listener (WSL) executable, and the workstation handler (WSH) executable. The Workstation MIB specifies information about workstation listeners and workstation handlers. The following table lists the two WSL and WSH groups through which you can manage a workstation listener and its associated workstation handler processes.
The Workstation MIB consists of the following groups.
You can define new workstation listeners in the tuxTwslTbl
group, and you can obtain information about active workstation handlers from the tuxTwshTbl
group.
The tuxTwshTbl
table represents run-time characteristics of WSH client processes. These objects characterize workstation statistics specific to a particular WSH client process. Objects in this table are only accessible through a Tuxedo SNMP agent installed on the local machine. Objects are only accessible when the corresponding WSH is active.
DisplayString
( SIZE
(1..78
) )
Client identifier for this WSH. The data in this field should not be interpreted directly by the end user except for equality comparison.
DisplayString
( SIZE
(1..78
) )
Client identifier for this WSH. The data in this field should not be interpreted directly by the end user except for equality comparison. Value is same as tuxTwshTaClientId
.
DisplayString
( SIZE
(1..30
) )
Logical name of the server group for the associated WSL.
Unique (within the server group) server identification number for the associated WSL.
INTEGER { active(1), suspended(2), dead(3) }
State for the WSH client within the application. Any state defined for the tuxTclientTbl
group can be returned or set. State changes to the suspended(2)
state are transitive to all clients associated with this WSH as is the resetting of a suspended(2)
WSH to active(1)
. Additionally, suspended(2)
WSH clients are not assigned any additional incoming clients by the WSL.
Note that the state of a WSH client might not be set to dead(3)
when accessing the tuxTclientTbl
group. However, the state transition to dead(3)
is allowed via the tuxTwshTbl
group and results in all connections handled by the targeted WSH being dropped abortively.
DisplayString
( SIZE
(1..30
) )
Current logical machine on which the WSH is running.
Native operating system process identifier for the WSH client.
DisplayString
( SIZE
(1..78
) )
Network address of workstation handler. Hexadecimal addresses are converted to an ASCII format with a leading 0x
.
High water number of clients accessing application through this WSH.
Maximum number of clients that can access the application through this WSH.
Current number of clients accessing the application through this WSH.
A non-0 value for this object indicates that the WSH has been assigned a newly connecting workstation client that has the indicated amount of time, in seconds, to complete the initialization process with the WSH.
INTEGER { yes(1), no(2), unknown(3) }
A value of yes(1)
indicates that the WSH is currently performing work on behalf of one of its associated workstation clients. A value of no(2)
indicates that the WSH is currently waiting for work to perform on behalf of one of its associated workstation clients.
Time, in seconds, that the WSH has been active since it started processing.
Time, in seconds, that the WSH has been idle since it started processing.
Amount of work processed by this WSH since the last WSH assignment by the WSL. This value is used by the WSL to load balance new incoming connections among a set of WSH processes.
Number of times flow control has been encountered by this WSH. This object should be considered only in relation to recent past values because it might wrap around during the lifetime of the WSH.
Number of times this WSH has been unable to enqueue a message to a local UNIX system message queue due to queue blocking conditions. This object should be considered only in relation to recent past values because it might wrap around during the lifetime of the WSH.
Number of bytes received from the network by this WSH from all its present and past workstation clients. This object should be considered only in relation to recent past values because it might wrap around during the lifetime of the WSH.
Number of Tuxedo system messages received from the network by this WSH from all its present and past workstation clients. This object should be considered only in relation to recent past values because it might wrap around during the lifetime of the WSH.
Number of bytes sent to the network by this WSH to all its present and past workstation clients. This object should be considered only in relation to recent past values because it might wrap around during the lifetime of the WSH.
Number of Tuxedo system messages sent to the network by this WSH to all its present and past workstation clients. This object should be considered only in relation to recent past values because it might wrap around during the lifetime of the WSH.
The tuxTwslTbl
table represents configuration and run-time characteristics of WSL server processes configured to manage workstation groups. These object values identify and characterize workstation-specific configuration objects for WSL tuxTsrvrTbl
objects within the application. To create a new row in this table, use a SET request that specifies the values for at least tuxTwslTaSrvGrp
, tuxTwslTaSrvId
, and tuxTwslTaNaddr
.
Logical name of the server group. Server group names cannot contain an asterisk (*), comma, or colon.
Note: | This object can be updated only during row creation. |
Unique (within the server group) server identification number.
Note: | This object can be updated only during row creation. |
Group number associated with this servers group.
INTEGER { active(1), inactive(2), migrating(3), cleaning(4), restarting(5), suspended(6), partitioned(7), dead(8), invalid(9) }
State for the WSL server within the application. Any state defined for the tuxTsrvrTbl
group can be returned or set as indicated.
DisplayString
( SIZE
(1..30
) )
Current logical machine on which the server is running.
Native operating system process identifier for the WSL server.
DisplayString
( SIZE
(0..78
) )
Device name to be used by the WSL process to access the network. This object value is a required value for access to a network through a TLI-based Tuxedo system binary. This object value is not needed for sockets-based Tuxedo system binaries.
Specifies the complete network address to be used by the WSL process as its listening address. The listening address for a WSL is the means by which it is contacted by workstation client processes participating in the application.
If string has the form 0xhex-digits
or \\xhex-digits
, it must contain an even number of valid hexadecimal digits. These forms are translated internally into a character array containing the hexadecimal representations of the string specified.
DisplayString
( SIZE
(1..78
) )
The name of the executable that provides workstation handler services for this workstation listener. The default value for this object is WSH, which corresponds to the system provided workstation handler. Workstation handlers can be customized using the command buildwsh
.
The minimum number of handlers that should be available in conjunction with this WSL at any given time. Upon being activated, the WSL starts this many WSHs immediately and does not deplete the supply of WSHs below this number until the administrator issues a shutdown to the WSL. Modifications to this object for a running WSL might cause additional handlers to be activated.
The maximum number of handlers that should be available in conjunction with this WSL at any given time. Handlers are started as necessary to meet the demand of workstation clients attempting to access the system. This object must be greater than or equal to the setting for the minimum number of handlers.
Maximum number of clients that are supported by any one handler process concurrently.
Maximum amount of time, in minutes, that a workstation client is permitted to be idle before it is abortively disconnected from the application by the handler. A value of 0 allows clients to be idle as long as is necessary without being timed out.
The minimum number of seconds that should be allowed for a workstation client to complete initialization processing through the WSH before being timed out by the WSL.
DisplayString
( SIZE
(0..128
) )
Command-line options to be passed to the WSL server when it is activated. For details, see reference page servopts(5) in BEA Tuxedo File Formats, Data Descriptions, MIBs, and System Processes Reference.
Note: | Run-time modifications to this object do not affect a running WSL server. Server-specific options (that is, those after a double-dash "--") cannot be set and are not returned. |
DisplayString
( SIZE
(0..78
) )
WSL server-specific environment file. See tuxTmachineEnvFile
for a complete discussion of how this file is used to modify the environment.
Note: | Run-time modifications to this object do not affect a running WSL server. |
The period of time, in seconds, during which the tuxTwslTaMaxGen
limit applies. This object value is meaningful only for restartable WSL servers, that is, if the tuxTwslTaRestart
object is set to yes(1)
. When a restarting server would exceed the tuxTwslTaMaxGen
limit but the tuxTwslTaGrace
period has expired, the system resets the current generation (tuxTsrvrGeneration
) to 1 and resets the initial boot time (tuxTsrvrTimeStart
) to the current time. A value of 0 for this object indicates that the WSL server should always be restarted.
Number of generations allowed for a restartable WSL server (tuxTwslTaRestart == yes(1)
) over the specified grace period (tuxTwslTaGrace
). The initial activation of the WSL server counts as one generation and each restart also counts as one. Processing after the maximum number of generations is exceeded is discussed above with respect to tuxTwslTaGrace
.
Application specified command to be executed in parallel with the system restart of an application server. This command must be an executable file in the native operating system.
Restartable (yes(1)
) or non-restartable (no(2)
) WSL server. If server migration is specified for this server group (tuxTdomainOptions = migrate(2)
and tuxTgroupLMID
with alternate site), then this object must be set to yes(1)
.
Specifies when this server should be booted (tmboot
(1)) or shutdown (tmshutdown
(1)) relative to other servers. If two servers are given the same sequence number, it is possible for tmboot
(1) to boot them in parallel and for tmshutdown
(1) to shut them down in parallel. tuxTwslTbl
instances added without a tuxTwslTaSequence
object specified or with an invalid value have a value generated for them that is 10,000 or more and is higher than any other automatically selected default value. Servers are booted by tmboot
(1) in increasing order of sequence number and shutdown by tmshutdown
(1) in decreasing order. Run-time modifications to this object affect only tmboot
(1) and tmshutdown
(1) and affect the order in which running servers can be shutdown by a subsequent invocation of tmshutdown
(1).
Number of currently active handlers associated with this WSL.
Maximum number of currently active handlers associated with this WSL at any one time.
The Tuxedo system /WS protocol version number for this /WS group. Note that /WS clients connecting to this group might themselves have a different protocol version number associated with them.
INTEGER { new(1), all(2), none(3) }
A value of new(1)
indicates that new incoming clients cannot connect through this tuxTwslTbl
instance. A value of all(2)
indicates that workstation clients already connected to the application through this WSL have been suspended(2)
(see tuxTclientState
) in addition to new incoming connections being disallowed. A value of none(3)
indicates that no suspension characteristics are in effect.
INTEGER { yes(1), no-value-returned(2) }
Setting a value of yes(1)
causes all active WSHs in the /WS group to refresh their VIEW buffer type cache. A GET
request on this object always returns no
-value-returned(2)
and does not mean anything. This object has meaning only for SET
requests.
INTEGER {client(1), handler(2), both(3), none(4), not-available(5)}
The network "keep alive" option is configured for the client, the handler, or both the client and the handler, or not on either side of the connection. Changing this value only affects future connections.
The minimum number of seconds that should be allowed for a workstation client to wait for a response from WSL/WSH. A value of 0 indicates no network time-out. Changing this value affects only future connections. This object is supported only on Tuxedo 6.4. -1
is returned if the object is not available.