T_WSH Class Definition

Overview

The T_WSH class represents run-time attributes of WSH client processes. These attribute values characterize Workstation statistics specific to a particular WSH client process. This class is linked to the T_WSL class by the common key fields, TA_SRVGRP and TA_SRVID. It is also linked to the T_CLIENT class (see

(5)) by the common key field TA_WSHCLIENTID.

Attribute Table

**T_WSL Class Definition attribute Table**
Attribute¹	Type	Permissions	Values	Default
`TA_CLIENTID( * )`	string	R--R--R--	string[1..78]	N/A
`TA_WSHCLIENTID( * )`	string	R--R--R--	string[1..78]	N/A
`TA_SRVGRP( * )`	string	R--R--R--	string[1..30]	N/A
`TA_SRVID( * )`	long	R--R--R--	1 <= num < 30,001	N/A
`TA_GRPNO( * )`	long	R--R--R--	1 <= num < 30,000	N/A
`TA_STATE( k )`	string	R-XR-XR--	See `T_CLIENT` Class in `TM_MIB`(5)
`TA_LMID( * )`	string	R--R--R--	LMID	N/A
`TA_PID( * )`	long	R--R--R--	1 <= num	N/A
`TA_NADDR`	string	R--R--R--	string[1..78]	N/A
`TA_HWCLIENTS`	long	R--R--R--	1 <= num < 32,767	N/A
`TA_MULTIPLEX`	long	R--R--R--	1 <= num < 32,767	N/A
`TA_CURCLIENTS`	long	R--R--R--	1 <= num < 32,767	N/A
`TA_TIMELEFT`	long	R--R--R--	0 <= num	N/A
`TA_ACTIVE`	string	R--R--R--	"{Y\|N}"	N/A
`TA_TOTACTTIME`	long	R--R--R--	0 <= num	N/A
`TA_TOTIDLTIME`	long	R--R--R--	0 <= num	N/A
`TA_CURWORK`	long	R--R--R--	0 <= num	N/A
`TA_FLOWCNT`	long	R--R--R--	0 <= num	N/A
`TA_NUMBLOCKQ`	long	R--R--R--	0 <= num	N/A
`TA_RCVDBYT`	long	R--R--R--	0 <= num	N/A
`TA_RCVDNUM`	long	R--R--R--	0 <= num	N/A
`TA_SENTBYT`	long	R--R--R--	0 <= num	N/A
`TA_SENTNUM`	long	R--R--R--	0 <= num	N/A
( k ) - `GET` key field ( * ) - `GET/SET` key, one or more required for `SET` operations

¹All attributes in Class T_WSH are local attributes.

Attribute Semantics

TA_CLIENTID : string[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.
TA_WSHCLIENTID : string[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. This field can be used to link the WSH to its associated Workstation client T_CLIENT objects. This field value is always equal to the value for the TA_CLIENTID attribute for this class.
TA_SRVGRP : string[1..30]: Logical name of the server group for the associated WSL.
TA_SRVID : 1 = num 30,001: Unique (within the server group) server identification number for the associated WSL.
TA_STATE :: State for the WSH client within the application. Any state defined for the T_CLIENT class in TM_MIB(5) may be returned or set as indicated on that reference page. State changes to the SUSpended state are transitive to all clients associated with this WSH as is the resetting of a SUSpended WSH to ACTive. Additionally, SUSpended 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 when accessing the T_CLIENT class; however, the state transition to DEAD is allowed via the T_WSH class and will result in all connections being handled by the targetted WSH to be dropped abortively.
TA_LMID : LMID: Current logical machine on which the WSH is running.
TA_PID : 1 = num: Native operating system process identifier for the WSH client. Note that this may not be a unique attribute since clients may be located on different machines allowing for duplication of process identifiers.
TA_NADDR : string[1..78]: Network address of workstation handler. Hexadecimal addresses are converted to an ascii format with a leading "0x". TCP/IP addresses are reported in the "//#.#.#.#:port" format.
TA_HWCLIENTS : 1 = num 32,767: High water number of clients accessing application via this WSH.
TA_MULTIPLEX : 1 = num 32,767: Maximum number of clients that may access the application via this WSH.
TA_CURCLIENTS : 1 = num 32,767: Current number of clients accessing application via this WSH.
TA_TIMELEFT : 0 = num: 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.
TA_ACTIVE : {Y|N}: A value of Y indicates that the WSH is currently performing work on behalf of one of its associated workstation clients. A value of N indicates that the WSH is currently waiting for work to perform on behalf of one of its associated workstation clients.
TA_TOTACTTIME : 0 = num: Time, in seconds, that the WSH has been active since it started processing.
TA_TOTIDLTIME : 0 = num: Time, in seconds, that the WSH has been idle since it started processing.
TA_CURWORK : 0 = num: 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.
TA_FLOWCNT : 0 = num: 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.
TA_NUMBLOCKQ : 0 = num: 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.
TA_RCVDBYT : 0 = num: 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.
TA_RCVDNUM : 0 = num: Number of BEA TUXEDO system 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.
TA_SENTBYT : 0 = num: 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.
TA_SENTNUM : 0 = num: Number of BEA TUXEDO system 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.

Limitations

This class represents a specialization of the T_CLIENT class and as such represents certain attributes that are duplicated in the corresponding T_CLIENT objects. Attributes not listed that are included in the T_CLIENT class must be accessed via that class and are not available through the T_WSH class.

[Top] [Prev] [Next] [Bottom]