TUXEDO systems include the capability to require that clients run on a workstation for purposes of security, performance, and convenience. A network administrator can define the environment required to control the workstation clients using the Workstation MIB. This MIB is an extension of the TUXEDO 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.
Workstation Handler
Workstation Listener
You can define new workstation listeners in the The
Group Name
Description
tuxTwslTbl
group, and you can obtain information about active workstation handlers from the tuxTwshTbl
group.
tuxTwshTbl
tuxTwshTbl
table represents runtime attributes 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.
tuxTwshTaClientId
Syntax
DisplayString
(SIZE
(1..78
) )Access
read-only
Description
Client identifier for this WSH. The data in this field should not be interpreted directly by the end user except for equality comparison.
Syntax
DisplayString
(SIZE
(1..78
) )Access
read-only
Description
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
.
Syntax
DisplayString
(SIZE
(1..30
) )Access
read-only
Description
Logical name of the server group for the associated WSL.
Syntax
INTEGER
(1..30001)
Access
read-only
Description
Unique (within the server group) server identification number for the associated WSL.
Syntax
INTEGER
(1..30000)
Access
read-only
Description
Group number.
Syntax
INTEGER { active(1), suspended(2), dead(3) }
Access
read-write
Description
State for the WSH client within the application. Any state defined for the
tuxTclientTbl
group may be returned or set. State changes to thesuspended(2)
state are transitive to all clients associated with this WSH as is the resetting of asuspended(2)
WSH toactive(1)
. Additionally,suspended(2)
WSH clients will not be assigned any additional incoming clients by the WSL.Note that the state of a WSH client may not be set to
dead(3)
when accessing thetuxTclientTbl
group; however, the state transition todead(3)
is allowed via thetuxTwshTbl
group and will result in all connections being handled by the targeted WSH to be dropped abortively.
Syntax
DisplayString
(SIZE
(1..30
) )Access
read-only
Description
Current logical machine on which the WSH is running.
Syntax
INTEGER
Access
read-only
Description
Native operating system process identifier for the WSH client.
Syntax
DisplayString
(SIZE
(1..78
) )Access
read-only
Description
Network address of workstation handler. Hexadecimal addresses are converted to an ASCII format with a leading
0x
.
Syntax
INTEGER
(1..32767
)Access
read-only
Description
High water number of clients accessing application via this WSH.
Syntax
INTEGER
(1..32767
)Access
read-only
Description
Maximum number of clients that may access the application via this WSH.
Syntax
INTEGER
(1..32767
)Access
read-only
Description
Current number of clients accessing application via this WSH.
Syntax
INTEGER
Access
read-only
Description
A non-0 value for this attribute 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.
Syntax
INTEGER { yes(1), no(2), unknown(3) }
Access
read-only
Description
A value of
yes(1)
indicates that the WSH is currently performing work on behalf of one of its associated workstation clients. A value ofno(2)
indicates that the WSH is currently waiting for work to perform on behalf of one of its associated workstation clients.
Syntax
INTEGER
Access
read-only
Description
Time, in seconds, that the WSH has been active since it started processing.
Syntax
INTEGER
Access
read-only
Description
Time, in seconds, that the WSH has been idle since it started processing.
Syntax
INTEGER
Access
read-only
Description
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 amongst a set of WSH processes.
Syntax
INTEGER
Access
read-only
Description
Number of times flow control has been encountered by this WSH. This attribute should be considered only in relation to recent past values as it may wrap around during the lifetime of the WSH.
Syntax
INTEGER
Access
read-only
Description
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 attribute should be considered only in relation to recent past values as it may wrap around during the lifetime of the WSH.
Syntax
INTEGER
Access
read-only
Description
Number of bytes received from the network by this WSH from all of its present and past workstation clients. This attribute should be considered only in relation to recent past values as it may wrap around during the lifetime of the WSH.
Syntax
INTEGER
Access
read-only
Description
Number of TUXEDO System/T messages received from the network by this WSH from all of its present and past workstation clients. This attribute should be considered only in relation to recent past values as it may wrap around during the lifetime of the WSH.
Syntax
INTEGER
Access
read-only
Description
Number of bytes sent to the network by this WSH to all of its present and past workstation clients. This attribute should be considered only in relation to recent past values as it may wrap around during the lifetime of the WSH.
Syntax
INTEGER
Access
read-only
Description
Number of TUXEDO System/T messages sent to the network by this WSH to all of its present and past workstation clients. This attribute should be considered only in relation to recent past values as it may wrap around during the lifetime of the WSH.
The tuxTwslTbl
table represents configuration and runtime attributes of WSL server processes configured to manage workstation groups. These attribute values identify and characterize workstation-specific configuration attributes 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
.
Syntax
DisplayString
(SIZE
(1..30
) )Access
read-write
Description
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.
Syntax
INTEGER
(1..30001
)Access
read-write
Description
Unique (within the server group) server identification number.
Note: This object can be updated only during row creation.
Syntax
INTEGER
(1..30001
)Access
read-only
Description
Group number associated with this servers group.
Syntax
INTEGER { active(1), inactive(2), migrating(3), cleaning(4), restarting(5), suspended(6), partitioned(7), dead(8), invalid(9) }
Access
read-write
Description
State for the WSL server within the application. Any state defined for the
tuxTsrvrTbl
group may be returned or set as indicated.
Syntax
DisplayString
(SIZE
(1..30
) )Access
read-only
Description
Current logical machine on which the server is running.
Syntax
INTEGER
Access
read-only
Description
Native operating system process identifier for the WSL server.
Syntax
DisplayString
(SIZE
(0..78
) )Access
read-write
Description
Device name to be used by the WSL process to access the network. This is a required value for access to a network via a TLI-based TUXEDO System/T binary. This attribute is not needed for sockets-based TUXEDO System/T binaries.
Syntax
DisplayString
(SIZE
(1..78
) )Access
read-write
Description
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.
Syntax
DisplayString
(SIZE
(1..78
) )Access
read-write
Description
The name of the executable providing workstation handler services for this workstation listener. The default value for this is WSH, which corresponds to the system provided workstation handler. Workstation handlers may be customized using the command
buildwsh
.
Syntax
INTEGER
(0..256
)Access
read-write
Description
The minimum number of handlers that should be available in conjunction with this WSL at any given time. The WSL will start this many WSHs immediately upon being activated and will not deplete the supply of WSHs below this number until the administrator issues a shutdown to the WSL. Modifications to this attribute for a running WSL may cause additional handlers to be activated.
Syntax
INTEGER
(0..32767
)Access
read-write
Description
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 attribute must be greater than or equal to the setting for the minimum number of handlers.
Syntax
INTEGER
(0..32767
)Access
read-write
Description
Maximum number of clients that are to be supported by any one handler process concurrently.
Syntax
INTEGER
Access
read-write
Description
Maximum amount of time, in minutes, that a workstation client is permitted to be idle before it will be abortively disconnected from the application by the handler. A value of 0 allows clients to be idle as long as they wish without being timed out.
Syntax
INTEGER
Access
read-write
Description
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.
Syntax
DisplayString
(SIZE
(0..128
) )Access
read-write
Description
Command-line options to be passed to WSL server when it is activated. See the
servopts
(5) reference page for details.Note: Runtime modifications to this attribute will not affect a running WSL server. Server-specific options (i.e., those after a double-dash "--") may not be set and will not be returned.
Syntax
DisplayString
(SIZE
(0..78
) )Access
read-write
Description
WSL server-specific environment file. See
tuxTmachineEnvFile
for a complete discussion of how this file is used to modify the environment.Note: Runtime modifications to this attribute will not affect a running WSL server.
Syntax
INTEGER
Access
read-write
Description
The period of time, in seconds, over which the
tuxTwslTaMaxGen
limit applies. This attribute is meaningful only for restartable WSL servers, i.e., if thetuxTwslTaRestart
attribute is set toyes(1)
. When a restarting server would exceed thetuxTwslTaMaxGen
limit but thetuxTwslTaGrace
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 attribute indicates that the WSL server should always be restarted.
Syntax
INTEGER
(0..256
)Access
read-write
Description
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 generations is exceeded is discussed above with respect totuxTwslTaGrace
.
Syntax
DisplayString
(SIZE
(0..78
) )Access
read-write
Description
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.
Syntax
INTEGER { yes(1), no(2) }
Access
read-write
Description
Restartable (
yes(1)
) or non-restartable (no(2)
) WSL server. If server migration is specified for this server group (tuxTdomainOptions = migrate(2)
andtuxTgroupLMID
with alternate site), then this attribute must be set toyes(1)
.
Syntax
INTEGER
(1..10000
)Access
read-write
Description
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 fortmboot
(1) to boot them in parallel and fortmshutdown
(1) to shut them down in parallel.tuxTwslTbl
instances added without atuxTwslTaSequence
attribute specified or with an invalid value will have one generated for them that is 10,000 or more and is higher than any other automatically selected default value. Servers are booted bytmboot
(1) in increasing order of sequence number and shutdown bytmshutdown
(1) in decreasing order. Runtime modifications to this attribute affect onlytmboot
(1) andtmshutdown
(1) and will affect the order in which running servers may be shutdown by a subsequent invocation oftmshutdown
(1).
Syntax
INTEGER
Access
read-only
Description
Number of currently active handlers associated with this WSL.
Syntax
INTEGER
Access
read-only
Description
Maximum number of currently active handlers associated with this WSL at any one time.
Syntax
INTEGER
Access
read-only
Description
The TUXEDO System/T /WS protocol version number for this /WS group. Note that /WS clients connecting to this group may themselves have a different protocol version number associated with them.
Syntax
INTEGER { new(1), all(2), none(3) }
Access
read-write
Description
A value of
new(1)
indicates that new incoming clients may not connect through thistuxTwslTbl
instance. A value ofall(2)
indicates that workstation clients already connected to the application through this WSL have beensuspended(2)
(seetuxTclientState
) in addition to disallowing new incoming connections. A value ofnone(3)
indicates that no suspension characteristics are in effect.
Syntax
INTEGER { yes(1), no-value-returned(2) }
Access
read-write
Description
Setting a value of
yes(1)
will cause all active WSHs in the /WS group to refresh their VIEW buffer type cache. AGET
request on this object always returnsno
-value-returned(2)
and does not mean anything. This object has meaning only forSET
requests.
Syntax
INTEGER {client(1), handler(2), both(3), none(4), not-available(5)}
Access
read-write
Description
The network "keep alive" option will be 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 connections that will be established in the future. This object is supported only on TUXEDO 6.4 or later.
Syntax
INTEGER
(0..35204650)
Access
read-write
Description
The minimum number of seconds that should be allowed for a workstation client to wait for receiving a response from WSL/WSH. A value of 0 indicates no network time-out. Changing this value affects only connections established in the future. This object is supported only on TUXEDO 6.4.
-1
is returned if the object is not available.