![]() |
![]() |
|
|
T_APPQ Class Definition
Overview
The T_APPQ class represents application queues. One or more application queues may exist in a single application queue space.
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_APPQ objects within the specified queue space will be retrieved.
Attribute Table
Attribute1 |
Type |
Permis- |
Values |
Default |
---|---|---|---|---|
TA_APPQNAME( k )( r )( * ) |
string |
ru-r--r-- |
string[1..15] |
N/A |
TA_APPQSPACENAME( k )( r )( * ) |
string |
ru-r--r-- |
string[1..15] |
N/A |
TA_QMCONFIG( k )( r )( * ) |
string |
ru-r--r-- |
string[1..78] |
N/A |
TA_LMID( k )( r )( * )2 |
string |
ru-r--r-- |
string[1..30] |
N/A |
TA_STATE (Note 3)3 |
string |
rw-r--r-- |
GET:{VAL} SET:{NEW|INV} |
N/A N/A |
TA_APPQORDER4 |
string |
rw-r--r-- |
{PRIO|TIME|LIFO|FIFO} |
FIFO |
TA_CMD |
string |
rw-r--r-- |
shell-command -string[0..78] |
"" |
TA_CMDHW |
string |
rw-r--r-- |
0 = num [Bbm%] |
100% |
TA_CMDLW |
string |
rw-r--r-- |
0 = num [Bbm%] |
0% |
TA_MAXRETRIES |
long |
rw-r--r-- |
0 = num |
0 |
TA_OUTOFORDER |
string |
rw-r--r-- |
{NONE|TOP |MSGID} |
NONE |
TA_RETRYDELAY |
long |
rw-r--r-- |
0 = num |
0 |
TA_CURBLOCKS |
long |
r--r--r-- |
0 = num |
N/A |
TA_CURMSG |
long |
r--r--r-- |
0 = num |
N/A |
( k ) - GET key fie*ld)5 |
1 All attributes of class T_APPQ are local attributes. 2TA_LMID must be specified as a key field except when the application is unconfigured (i.e., the TUXCONFIG environment variable is not set). 3All operations on T_APPQ objects (both GET and SET) silently open the associated queue space (i.e., implicitly set the state of the queue space to OPEn if it is not already OPEn or ACTive). This may be a time-consuming operation if the queue space is large. 4TA_APPQORDER cannot be modified after the application queue is created. 5Sufficient key fields must be supplied in a GET operation to explicitly target a single application queue space. |
VALid |
The specified queue exists. This state is INActive equivalent for purposes of permissions checking. |
NEW |
Create a new queue in the specified queue space. The queue is left in state VALid following successful creation. |
INValid |
Delete the specified queue. The queue must be in state VALid to be deleted. If the queue space has processes attached to it (i.e., it is in the ACTive state), the queue will not be deleted unless the TA_FLAGS attribute includes the QMIB_FORCEDELETE flag. In addition, if the queue has messages in it, it will not be deleted unless QMIB_FORCEPURGE is specified. Successful return leaves the object in the INValid state. |
unset |
Modify an application queue. Successful return leaves the state unchanged. |
PRIO,TIME,LIFO
TIME,PRIO,FIFO
TIME,FIFO
![]() |
![]() |
![]() |
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|