|
|
|
|
|
|
Workstation MIB
Tuxedo and WLE 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 Tuxedo Core MIB and specifies the information required to control access to a Tuxedo or WLE 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.
|
Group Name |
Description |
|---|---|
|
Workstation Handler |
|
|
Workstation Listener |
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 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 BEA SNMP agent installed on the local machine. Objects are only accessible when the corresponding WSH is active.
|
Variable Name |
Object ID |
|---|---|
|
tuxTwshTaClientId |
.1.3.6.1.4.1.140.300.1.1.1.1 |
|
tuxTwshTaWshClientId |
.1.3.6.1.4.1.140.300.1.1.1.2 |
|
tuxTwshTaSrvGrp |
.1.3.6.1.4.1.140.300.1.1.1.3 |
|
tuxTwshTaSrvId |
.1.3.6.1.4.1.140.300.1.1.1.4 |
|
tuxTwshTaGrpNo |
.1.3.6.1.4.1.140.300.1.1.1.5 |
|
tuxTwshTaState |
.1.3.6.1.4.1.140.300.1.1.1.6 |
|
tuxTwshTaLmid |
.1.3.6.1.4.1.140.300.1.1.1.7 |
|
tuxTwshTaPid |
.1.3.6.1.4.1.140.300.1.1.1.8 |
|
tuxTwshTaNaddr |
.1.3.6.1.4.1.140.300.1.1.1.9 |
|
tuxTwshTaHwClients |
.1.3.6.1.4.1.140.300.1.1.1.10 |
|
tuxTwshTaMultiplex |
.1.3.6.1.4.1.140.300.1.1.1.11 |
|
tuxTwshTaCurClients |
.1.3.6.1.4.1.140.300.1.1.1.12 |
|
tuxTwshTaTimeleft |
.1.3.6.1.4.1.140.300.1.1.1.13 |
|
tuxTwshTaActive |
.1.3.6.1.4.1.140.300.1.1.1.14 |
|
tuxTwshTaTotacttime |
.1.3.6.1.4.1.140.300.1.1.1.15 |
|
tuxTwshTaTotidltime |
.1.3.6.1.4.1.140.300.1.1.1.16 |
|
tuxTwshTaCurwork |
.1.3.6.1.4.1.140.300.1.1.1.17 |
|
tuxTwshTaFlowcnt |
.1.3.6.1.4.1.140.300.1.1.1.18 |
|
tuxTwshTaNumblockQ |
.1.3.6.1.4.1.140.300.1.1.1.19 |
|
tuxTwshTaRcvdByt |
.1.3.6.1.4.1.140.300.1.1.1.20 |
|
tuxTwshTaRcvdNum |
.1.3.6.1.4.1.140.300.1.1.1.21 |
|
tuxTwshTaSentByt |
.1.3.6.1.4.1.140.300.1.1.1.22 |
|
tuxTwshTaSentNum |
.1.3.6.1.4.1.140.300.1.1.1.23 |
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 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.
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 through this WSH.
Syntax
INTEGER ( 1..32767 )
Access
read-only
Description
Maximum number of clients that can access the application through this WSH.
Syntax
INTEGER ( 1..32767 )
Access
read-only
Description
Current number of clients accessing the application through this WSH.
Syntax
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 of no(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 among 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 because it might 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 because it might 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 its present and past workstation clients. This attribute should be considered only in relation to recent past values because it might 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 its present and past workstation clients. This attribute should be considered only in relation to recent past values because it might 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 its present and past workstation clients. This attribute should be considered only in relation to recent past values because it might 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 its present and past workstation clients. This attribute 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 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.
|
Variable Name |
Object ID |
|---|---|
|
tuxTwslTaSrvGrp |
.1.3.6.1.4.1.140.300.1.2.1.1 |
|
tuxTwslTaSrvId |
.1.3.6.1.4.1.140.300.1.2.1.2 |
|
tuxTwslTaGrpNo |
.1.3.6.1.4.1.140.300.1.2.1.3 |
|
tuxTwslTaState |
.1.3.6.1.4.1.140.300.1.2.1.4 |
|
tuxTwslTaLmid |
.1.3.6.1.4.1.140.300.1.2.1.5 |
|
tuxTwslTaPid |
.1.3.6.1.4.1.140.300.1.2.1.6 |
|
tuxTwslTaDevice |
.1.3.6.1.4.1.140.300.1.2.1.7 |
|
tuxTwslTaNaddr |
.1.3.6.1.4.1.140.300.1.2.1.8 |
|
tuxTwslTaWshName |
.1.3.6.1.4.1.140.300.1.2.1.9 |
|
tuxTwslTaMinHandlers |
.1.3.6.1.4.1.140.300.1.2.1.10 |
|
tuxTwslTaMaxHandlers |
.1.3.6.1.4.1.140.300.1.2.1.11 |
|
tuxTwslTaMultiplex |
.1.3.6.1.4.1.140.300.1.2.1.12 |
|
tuxTwslTaMaxIdleTime |
.1.3.6.1.4.1.140.300.1.2.1.13 |
|
tuxTwslTaMaxInitTime |
.1.3.6.1.4.1.140.300.1.2.1.14 |
|
tuxTwslTaClOpt |
.1.3.6.1.4.1.140.300.1.2.1.15 |
|
tuxTwslTaEnvFile |
.1.3.6.1.4.1.140.300.1.2.1.16 |
|
tuxTwslTaGrace |
.1.3.6.1.4.1.140.300.1.2.1.17 |
|
tuxTwslTaMaxGen |
.1.3.6.1.4.1.140.300.1.2.1.18 |
|
tuxTwslTaRcmd |
.1.3.6.1.4.1.140.300.1.2.1.19 |
|
tuxTwslTaRestart |
.1.3.6.1.4.1.140.300.1.2.1.20 |
|
tuxTwslTaSequence |
.1.3.6.1.4.1.140.300.1.2.1.21 |
|
tuxTwslTaCurHandlers |
.1.3.6.1.4.1.140.300.1.2.1.22 |
|
tuxTwslTaHwHandlers |
.1.3.6.1.4.1.140.300.1.2.1.23 |
|
tuxTwslTaWsProto |
.1.3.6.1.4.1.140.300.1.2.1.24 |
|
tuxTwslTaSuspended |
.1.3.6.1.4.1.140.300.1.2.1.25 |
|
tuxTwslTaViewRefresh |
.1.3.6.1.4.1.140.300.1.2.1.26 |
|
tuxTwslTaKeepAlive |
.1.3.6.1.4.1.140.300.1.2.1.28 |
|
tuxTwslTaNetTimeOut |
.1.3.6.1.4.1.140.300.1.2.1.29 |
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 can 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 through 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 that provides workstation handler services for this workstation listener. The default value for this is WSH, which corresponds to the system provided workstation handler. Workstation handlers can 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. 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 attribute for a running WSL might 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 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 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.
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 the WSL server when it is activated. See the servopts(5) reference page for details.
Note: Runtime modifications to this attribute do not affect a running WSL server. Server-specific options (that is, those after a double-dash "--") cannot be set and are not 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 do not affect a running WSL server.
Syntax
INTEGER
Access
read-write
Description
The period of time, in seconds, during which the tuxTwslTaMaxGen limit applies. This attribute is meaningful only for restartable WSL servers, that is, if the tuxTwslTaRestart attribute 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 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 number of generations is exceeded is discussed above with respect to tuxTwslTaGrace.
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) and tuxTgroupLMID with alternate site), then this attribute must be set to yes(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 for tmboot(1) to boot them in parallel and for tmshutdown(1) to shut them down in parallel. tuxTwslTbl instances added without a tuxTwslTaSequence attribute 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. Runtime modifications to this attribute 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).
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 might 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 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.
Syntax
INTEGER { yes(1), no-value-returned(2) }
Access
read-write
Description
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.
Syntax
INTEGER {client(1), handler(2), both(3), none(4), not-available(5)}
Access
read-write
Description
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. 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 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.
|
|
|
|
|
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|