![]() |
![]() |
|
|
T_APPQMSG Class Definition
Overview
The T_APPQMSG class represents messages stored in application queues. A message is not created by an administrator; instead, it comes into existence as a result of a call to tpenqueue(3). A message can be destroyed either by a call to tpdequeue(3) or by an administrator. In addition, certain attributes of a message can be modified by an administrator. For example, an administrator can move a message from one queue to another queue within the same queue space or change its priority.
Limitations
It is not possible to retrieve all instances of this class by leaving all key fields unset. Instead, sufficient key fields must be supplied to explicitly target a single application queue space. These required key fields are TA_APPQSPACENAME, TA_QMCONFIG, and TA_LMID, except when the application is unconfigured (i.e., the TUXCONFIG environment variable is not set), in which case TA_LMID must be omitted. For example, if the TA_APPQSPACENAME, TA_QMCONFIG, and TA_LMID attributes are set in a request using tpcall(3), then all T_APPQMSG objects in all queues of the specified queue space will be retrieved.
Attribute Table
Attribute1 |
Type |
Permissions |
Values |
Default |
---|---|---|---|---|
TA_APPQMSGID(k)(*) TA_APPQNAME(k)(*) TA_APPQSPACENAME(k)(*) TA_QMCONFIG(k)(*) TA_LMID(k)(*)2 |
string string string string string |
r--r--r-- r--r--r-- r--r--r-- r--r--r-- r--r--r-- |
string[1..32] string[1..15] string[1..15] string[1..78] string[1..30] |
N/A N/A N/A N/A N/A |
TA_STATE3 |
string |
rw-r--r-- |
GET:{VAL} SET:{INV} |
N/A N/A |
TA_NEWAPPQNAME TA_PRIORITY TA_TIME |
string long string |
-w--w---- rw-rw-r-- rw-rw-r-- |
string[1..15] { 1 = num = 100 | -1 } { YY[MM[DD[hh[mm[ss]]]]] |
N/A N/A N/A |
TA_CORRID( k ) TA_LOWPRIORITY( k ) TA_HIGHPRIORITY( k ) TA_MSGENDTIME( k ) TA_MSGSTARTTIME( k ) |
long long long string string |
r--r--r-- k--k--k-- k--k--k-- k--k--k-- k--k--k-- |
string[0..32] 1 = num = 100 1 = num = 100 { YY[MM[DD[hh[mm[ss]]]]] { YY[MM[DD[hh[mm[ss]]]]] |
N/A 1 100 MAXLONG 0 |
TA_CURRETRIES TA_MSGSIZE |
long long |
r--r--r-- r--r--r-- |
0 = num 0 = num |
N/A N/A |
( k ) - GET key field4 |
1 All attributes of class T_APPQMSG are local attributes. 2TA_LMID must be specified as a key field except when the application is unconfigured (that is, the TUXCONFIG environment variable is not set. 3All operations on T_APPQMSG object (both GET and SET) silently open the associated queue space (that i, implicitly set the state of the queue space to OPEn of it is not OPEn or ACTive). This may be a time-consuming operation if the queue space is large. 4Sufficient key fields must be supplied in a GET operation to explicitly target a single application queue space. |
VALid |
The message exists. This state is INActive equivalent for purposes of permissions checking. |
INValid |
The message is deleted from its queue space. The message must be in state VALid before attempting this operation. Successful return leaves the object in the INValid state. |
unset |
Modify a message. Successful return leaves the state unchanged. |
TA_HIGHPRIORITY: 1 = num = 100
TA_MSGENDTIME:
![]() |
![]() |
![]() |
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|