Table of Contents Previous Next PDF


Creating and Configuring Application Queues
Creating and Configuring Application Queues
The Oracle Tuxedo system uses application queues for time-independent communication. In Oracle Tuxedo system applications, messages are stored on a queue, and queues are defined within a particular queue space. Queueing and dequeueing is done within a transaction. The BEA Tuxedo Administration Console provides the administrative environment required for managing and controlling access to application queues. The following help topics contain information about the application queue resources:
•
Application Queues
•
Creating Application Queues
•
Configuring Application Queues (T_APPQ Class)
•
Application Queue Spaces
•
Creating Application Queue Spaces
•
Configuring Application Queue Spaces (T_APPQSPACE Class)
•
Application Queue Messages
•
Configuring Application Queue Messages (T_APPQMSG Class)
•
Application Queue Transactions
•
Configuring Application Queue Transactions (T_APPQTRANS Class)
 
Application Queues
The Application Queues tree resources allow you to manage the attributes of an application queue such an pathnames, machine IDs, and processing order.
<a name="N_APPQ"></a>
Creating Application Queues
To create new Application Queues:
1.
Select the Application Queue folder in the tree and select Quick Menu —>New (right mouse click) to display the Create New Object window.
2.
Enter values for the following fields:
•
App Queue Name (TA_APPQNAME)
•
Queue Messages Processing Order (TA_APPQORDER)
•
App Queue Space Name (TA_APPQSPACENAME)
•
App Queue Space Device (TA_QMCONFIG)
•
Logical Machine Name (TA_LMID)
3.
Click Create to close the window and create the new application queue.
For information about using the Create New Object window, see Creating Administrative Class Objects.
<a name="T_APPQ"></a>
Configuring Application Queues (T_APPQ Class)
The attributes of application queues are listed in the following tab pages:
•
General Tab
•
Queue Message Tab
•
Retries Tab
•
Command Tab
The Configuration Tool contains some fields that are read-only. The information provided by these display-only fields is described briefly. For general information about using the Configuration Tool to configure administrative resources, see Configuring Administrative Objects.
<a name="C_APPQ"></a>
General Tab
The General tab page contains the following fields:
•
App Queue Name (TA_APPQNAME)
•
App Queue Space Name (TA_APPQSPACENAME)
•
App Queue Space Device (TA_QMCONFIG)
•
Logical Machine Name (TA_LMID)
•
Object State (TA_STATE)
l <a name="13029"></a><a name="12238"></a>
App Queue Name (TA_APPQNAME)
Description
The name of the application queue to be operated upon.
Valid Values
A string of 1 to 127 characters in length.
Example
Q_OPENACCT
<a name="13030"></a><a name="12240">
App Queue Space Name (TA_APPQSPACENAME)
Description
The name of the application queue space associated with the application queue. Filling in this field is half of what you must do to identify such a queue space; you must also enter a value in the App Queue Space Device (TA_QMCONFIG).
Valid Values
A string of 1 to 15 characters in length.
Example
QSP_BANKAPP
<a name="13031"></a><a name="12245"></a>
App Queue Space Device (TA_QMCONFIG)
Description
The pathname for an application queue configuration device, which must be on the current machine when you are using a deactivated configuration. Filling in this field is half of what you must do to identify a queue space associated with the application queue; you must also enter a value in the App Queue Space Name (TA_APPQSPACENAME).
Valid Values
A string of 1 to 78 characters in length.
Example
Q_DEVICE
<a name="13028"></a><a name="12246"></a>
Logical Machine Name (TA_LMID)
Description
Logical machine identifier for the machine on which the application queue space is located.
Valid Values
A string of 1 to 30 characters in length
Example
SITE1
Notes
The value in this field must be specified as a key field except when the application is unconfigured (i.e., the TUXCONFIG environment variable is not set).
<a name="12237"></a>
Object State (TA_STATE)
Description
This field displays the state of your application queue. An application queue may be in only one of the following states:
•
VALID
•
INVALID
•
NEW
All operations (whether GET or SET) on application queues silently open the associated queue space (i.e., they 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.
Queue Message Tab
The Queue Message tab page contains the following fields:
•
Queue Messages Processing Order (TA_APPQORDER)
•
Out of Order Messages Processing (TA_OUTOFORDER)
•
Current Number of Messages (TA_CURMSG)
•
Current Number of Disk Pages Used (TA_CURBLOCKS)
l <a name="12239"></a><a name="13028"></a>
Queue Messages Processing Order (TA_APPQORDER)
Description
The order in which you want messages in the queue to be processed. Consider your needs carefully before selecting an order for your application: the value in this field cannot be modified after the application queue is created.
Valid Values
Select one of the combinations listed below. The commas indicate a secondary (or lower) processing order within the primary processing order. For example, PRIO, LIFO means that the queue is processed in priority order, but if two items in the queue share the same priority, they are then processed in last in first out order.
FIFO — first in first out
PRIO, LIFO — Priority (then last in first out)
PRIO, FIFO — Priority (then first in first out)
TIME, LIFO — Execution Time (then last in first out)
PRIO, TIME, LIFO — Priority (then Execution Time (then last in first out)
PRIO, TIME, LIFO — Priority (then Execution Time (then first in last out)
TIME, PRIO, LIFO — Execution Time (then Priority (then last in first out)
Default
FIFO
<a name="12244"></a>
Out of Order Messages Processing (TA_OUTOFORDER)
Description
Method by which out-of-order message processing will be handled.
Valid Values
Select one of the following:
•
NONE
•
TOP
•
MSGID
Default
NONE
<a name="12234"></a>
Current Number of Messages (TA_CURMSG)
Description
This field displays the number of messages currently in the queue.
<a name="12233"></a>
Current Number of Disk Pages Used (TA_CURBLOCKS)
Description
This field displays the number of disk pages currently in the queue.
<a name="retries"></a>
Retries Tab
The Retries tab page contains the following fields:
•
Max. Number of Retries (TA_MAXRETRIES)
•
Delay Between Retries (in Sec) (TA_RETRYDELAY)
l <a name="12235"></a>
Max. Number of Retries (TA_MAXRETRIES)
Description
The maximum number of retries for a failed queue message. When this number of retries is exhausted, the message is placed on the error queue of the queue’s application queue space, as defined by Error Queue Name (TA_ERRORQNAME). If there is not error queue, the message is dropped.
Valid Values
A number greater than or equal to zero
Default
Zero
<a name="12236"></a>
Delay Between Retries (in Sec) (TA_RETRYDELAY)
Description
The delay, in seconds, between retries for failed queue messages.
Valid Values
A number greater than or equal to zero
Default
Zero
<a name="c_retries"></a>
Command Tab
The Command tab page contains the following fields:
•
High-Water Mark for Command Execution (TA_CMDHW)
•
Low-Water Mark for Command Execution (TA_CMDLW)
•
Command to Execute (TA_CMD)
l <a name="12242"></a>
High-Water Mark for Command Execution (TA_CMDHW)
Description
The high-water mark for command execution is expressed as an integer greater or equal to zero, optionally followed by one of the following:
B or b — the high-water marks are expressed in disk blocks.
M or m — the high-water marks are expressed in messages.
% — the high-water marks are expressed as a percentage of queue capacity.
Syntax
num [b | m | %] (where num is a number greater than or equal to zero)
Default
The default is 100%.
<a name="12243"></a>
Low-Water Mark for Command Execution (TA_CMDLW)
Description
The low-water marks for command execution are expressed in an integer greater or equal to zero, optionally followed by one of the following:
B or b — the low-water marks are expressed in disk blocks.
M or m — the low-water marks are expressed in messages.
% — the low-watermarks are expressed as a percentage of queue capacity.
Valid Values
num [b | m | %] (where num is a number greater than or equal to zero)
Default
The default is 0%.
<a name="12241"></a>
Command to Execute (TA_CMD)
Description
The command to be executed when the high-water mark is reached. If the high-water mark is reached after the low-water mark, the command is re-executed.
Valid Values
A shell command. This must be a string up to 78 characters in length.
Default
No entry
Application Queue Spaces
The Application Queue Spaces objects allow you to manage the attributes of an application queue spaces.
<a name="N_APPQSPACE"></a>
Creating Application Queue Spaces
To create new Application Queue Spaces:
1.
Select the application queue spaces folder in the tree.
2.
Select Quick Menu —>New (right-click) to display the Create New Object window.
3.
Enter values for the following fields:
•
IPC Key (TA_IPCKEY)
•
Max Queues (TA_MAXQUEUES)
•
Max Messages (TA_MAXMSG)
•
Max Disk Pages (TA_MAXPAGES)
•
Max Processes (TA_MAXPROC)
•
Max Open Transactions (TA_MAXTRANS)
•
App Queue Space Name (TA_APPQSPACENAME)
•
App Queue Space Device (TA_QMCONFIG)
•
Logical Machine Name (TA_LMID)
For information about using the Create New Object window, see Creating Administrative Class Objects.
<a name="T_APPQSPACE"></a>
Configuring Application Queue Spaces (T_APPQSPACE Class)
The attributes of application spaces are listed in six tab pages with the following labels:
•
General Tab
•
Disk/Pages Tab
•
Queue Tab
•
Transaction Tab
•
Process Tab
•
Message Tab
For general information about using the Configuration Tool to configure administrative resources, see Configuring Administrative Objects.
<a name="C_APPQSPACE"></a>
General Tab
The General tab page contains the following fields:
•
App Queue Space Name (TA_APPQSPACENAME)
•
App Queue Space Device (TA_QMCONFIG)
•
Logical Machine Name (TA_LMID)
•
IPC Key (TA_IPCKEY)
•
Error Queue Name (TA_ERRORQNAME)
•
Object State (TA_STATE)
This section describes these fields.
<a name="13038"></a> <a name="12265"></a>
App Queue Space Name (TA_APPQSPACENAME)
Description
The name used to identify the application queue space.
Valid Values
A string of 1 to 15 characters in length.
Example
QSP_BANKAPP
<a name="12268"></a>
App Queue Space Device (TA_QMCONFIG)
Description
The absolute pathname of the file or device where the application queue space is located.
Valid Values
A string of 1 to 78 characters in length.
Example
/HOME4/APPS/BANKAPP/QSPDVC
<a name="12269"></a>
Logical Machine Name (TA_LMID)
Description
Identifier of the logical machine on which the application queue space is located.
Valid Values
A string of 1 to 30 characters in length.
Example
SITE1
Notes
You must specify that this field is a key field except when the application is unconfigured (that is, when the TUXCONFIG environment variable is not set).
<a name="13032"></a> <a name="12249"></a>
IPC Key (TA_IPCKEY)
Description
A numeric key used to access queue space shared memory.
Valid Values
A number in the range of 32769 to 262143.
Example
88945
<a name="12266"></a>
Error Queue Name (TA_ERRORQNAME)
Description
The name of the error queue associated with the queue space.
Valid Values
A string of 0 to 127 characters in length.
Default
No entry
Example
Q_ERROR
<a name="12264"></a>
Object State (TA_STATE)
Description
This field displays the state of the application queue space. An application queue space may be in one of the following states:
•
INACTIVE
•
INITIALIZING
•
OPEN
•
ACTIVE
All operations on application queue classes 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.
<a name="diskpg"></a>
Disk/Pages Tab
The Disk/Pages tab page contains the following fields:
•
Max Disk Pages (TA_MAXPAGES)
•
Blocking Factor (TA_BLOCKING)
•
Current Number of Extents (TA_CUREXTENT)
•
Percent Initialized on Disk (TA_PERCENTINIT)
•
Force Initialization of New Extents (TA_FORCEINIT)
This section describes these fields.
<a name="13035"></a> <a name="12260"></a>
Max Disk Pages (TA_MAXPAGES)
Description
The maximum number of disk pages used by all queues in the queue space. Each time this attribute is increased, a new extent is used. You cannot decrease the number of pages by entering a lower number in this field.
Valid Values
A number greater than or equal to zero.
Example
200
<a name="12251"></a>
Blocking Factor (TA_BLOCKING)
Description
The blocking factor used in the queue space for disk space management. The default when a new queue space is created is 16.
Valid Values
A number greater than or equal to zero.
Default
16
<a name="12252"></a>
Current Number of Extents (TA_CUREXTENT)
Description
This field displays the number of extents currently in use by the queue space. The maximum number of extents that can be used is 100.
<a name="12263"></a>
Percent Initialized on Disk (TA_PERCENTINIT)
Description
This field displays the percentage of disk space that has been initialized for the queue space.
<a name="12267"></a>
Force Initialization of New Extents (TA_FORCEINIT)
Description
Select Yes to force the application queue space to initialize immediately, or No to delay the initialization.
Valid Values
Yes or No
Default
No
<a name="queuefolder"></a>
Queue Tab
The Queue tab page contains the following fields:
•
Max Queues (TA_MAXQUEUES)
•
Current Number of Queues (TA_CURQUEUES)
•
Highest Number of Queues (TA_HWQUEUES)
This section describes these fields.
<a name="13033"></a><a name="12250"></a>
Max Queues (TA_MAXQUEUES)
Description
The maximum number of queues that the queue space can accommodate.
Valid Values
A number greater than or equal to zero.
Example
20
<a name="12247"></a>
Current Number of Queues (TA_CURQUEUES)
Description
This field displays the number of server queues that currently exist in the queue space. This number can be determined only if the queue space is new, open, or active. Otherwise a value of -1 is displayed.
<a name="12248"></a>
Highest Number of Queues (TA_HWQUEUES)
Description
This field displays the highest number of queues that existed at any one time in the queue space since the queue space was last opened.
<a name="transaction"></a>
Transaction Tab
The Transaction tab page contains the following fields:
•
Max Open Transactions (TA_MAXTRANS)
•
Current Number of Open Transactions (TA_CURTRANS)
•
Highest Number of Open Transactions (TA_HWTRANS)
This section describes these fields.
<a name="13037"></a> <a name="12262"></a>
Max Open Transactions (TA_MAXTRANS)
Description
The maximum number of open transactions allowed in the queue space.
Valid Values
A number greater than or equal to zero.
Example
5
<a name="12255"></a>
Current Number of Open Transactions (TA_CURTRANS)
Description
This field displays the current number of outstanding transactions involving the queue space.
<a name="12258"></a>
Highest Number of Open Transactions (TA_HWTRANS)
Description
This field displays the highest number of outstanding transactions involving the queue space, since the queue space was last opened. The highest number of queues existing in the queue space since the queue space was last opened. The number is reset to 0 when the queue space state is set to CLEANING.
<a name="process"></a>
Process Tab
The Process tab page contains the following fields:
•
Max Processes (TA_MAXPROC)
•
Current Number of Processes (TA_CURPROC)
•
Highest Number of Processes (TA_HWPROC)
This section describes the following fields.
<a name="13036"></a> <a name="12261"></a>
Max Processes (TA_MAXPROC)
Description
The maximum number of processes that can access the queue space simultaneously.
Valid Values
A number greater than or equal to zero.
Example
5
<a name="12254"></a>
Current Number of Processes (TA_CURPROC)
Description
This field displays the number of processes currently accessing the queue space.
<a name="12257"></a>
Highest Number of Processes (TA_HWPROC)
Description
This field displays the highest number of processes simultaneously attached to the queue space at any one time since the queue space was last opened.
<a name="trans_message"></a>
Message Tab
The Message tab page contains the following fields:
•
Max Messages (TA_MAXMSG)
•
Current Number of Messages (TA_CURMSG)
•
Highest Number of Messages (TA_HWMSG)
This section describes these fields.
<a name="13034"></a> <a name="12259"></a>
Max Messages (TA_MAXMSG)
Description
The maximum number of messages allowed in the queue space.
Valid Values
A number greater than or equal to zero.
Example
200
<a name="12253"></a>
Current Number of Messages (TA_CURMSG)
Description
This field displays the current number of messages in the queue space. This number can be determined only if the queue space is OPEn or ACTive, or if the queue space is newly created. If none of these conditions apply, a value of -1 is returned.
<a name="12256"></a>
Highest Number of Messages (TA_HWMSG)
Description
This field displays the highest number of messages in the queue space at any one time since the queue space was last opened.
Application Queue Messages
The Application Queue Messages objects allow you to manage the attributes of application queue messages.
<a name="T_APPQMSG"></a>
Configuring Application Queue Messages (T_APPQMSG Class)
The attributes of application queue messages are listed in three tab pages with the following labels:
•
General Tab
•
Queue Message Tab
•
Statistics Tab
For general information about using the Configuration Tool to configure administrative resources, see Configuring Administrative Objects.
<a name="C_APPQMSG"></a>
General Tab
The General tab page contains the following fields:
•
Object State (TA_STATE)
•
App Queue Message ID (TA_APPQMSGID)
•
App Queue Name (TA_APPQNAME)
•
App Queue Space Name (TA_APPQSPACENAME)
•
App Queue Space Device (TA_QMCONFIG)
•
Logical Machine Name (TA_LMID)
This section describes these fields.
Object State (TA_STATE)
Description
This field displays the state of the application queue message. An application queue message may be in only one state: VALID.
Note:
All operations on application queue messages (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.
Note: <a name="12276"></a>
App Queue Message ID (TA_APPQMSGID)
Description
This field displays a unique identifier for the queue message, which can be used to select the message for GET or SET operations. No significance should be placed on this value; it is provided for your convenience in doing equality comparisons.
<a name="12277"></a>
App Queue Name (TA_APPQNAME)
Description
This field displays the name of the application queue in which the message is stored.
<a name="12278"></a>
App Queue Space Name (TA_APPQSPACENAME)
Description
This field displays the name of the application queue space containing the message.
<a name="12283"></a>
App Queue Space Device (TA_QMCONFIG)
Description
This field displays the absolute pathname of the file or device where the application queue space is located.
<a name="12285"></a>
Logical Machine Name (TA_LMID)
Description
This field displays the logical machine identifier of the logical machine on which the application queue space is located.
<a name="q_msgs">
Queue Message Tab
The Queue Message tab page contains the following fields:
•
Number of Retries (TA_CURRETRIES)
•
Message Size (TA_MSGSIZE)
•
Message Priority (TA_PRIORITY)
•
Correlation Identifier (TA_CORRID)
•
New App Queue Name (TA_NEWAPPQNAME)
•
Time to Process the Message (TA_TIME)
This section describes these fields.
<a name="12270"></a>
Number of Retries (TA_CURRETRIES)
Description
This field displays the number of retries that have been attempted so far on this message.
<a name="12273"></a>
Message Size (TA_MSGSIZE)
Description
This field displays the size of the message (in bytes).
<a name="12274"></a>
Message Priority (TA_PRIORITY)
Description
The priority of the message. The value in this field is valid only for PRIO-based queues. A value of -1 is returned by a GET operation if the queue is not PRIO-based.
Valid Values
A number in the range of 1 to 100.
Example
3
<a name="12279"></a>
Correlation Identifier (TA_CORRID)
Description
This field displays the correlation identifier for this message provided by the application in the tpenqueue(3) request. The empty string indicates that a correlation identifier is not present.
<a name="12282"></a>
New App Queue Name (TA_NEWAPPQNAME)
Description
Name of the queue into which to move the selected message. This queue must be an existing queue in the same queue space. This operation will not succeed unless the message is in a VALID state.
Valid Values
A string from 1 to 127 characters in length.
Example
APPQ3
<a name="12284"></a>
Time to Process the Message (TA_TIME)
Description
The time when the message will be processed. This field is valid only for TIME-based queues. (If the queue is not TIME-based, an empty string is returned by a GET operation.)
Valid Values
Use either of the following formats.
Format 1:
+seconds
Specifies that the message will be processed seconds in the future. The value 0 (zero) specifies that the message should be processed immediately.
Format 2:
YY[MM[DD[hh[mm[ss]]]]]
Specifies the year, month, day, hour, minute, and second when the message should be processed.
Omitted units default to their minimum possible values.
Example
Example of Format 2:
9506
This is equivalent to 950601000000. The years 00 through 37 are treated as 2000 through 20037, 70 through 99 are treated as 1970 through 1999, and 38 through 69 are invalid.
<a name="q_stats">
Statistics Tab
The Statistics tab page contains the following fields:
•
High Priority (TA_HIGHPRIORITY)
•
Low Priority (TA_LOWPRIORITY)
•
End Time (TA_MSGENDTIME)
•
Start Time (TA_MSGSTARTTIME)
This section describes these fields.
<a name="12271">
High Priority (TA_HIGHPRIORITY)
Description
The highest priority in the range within which to search for occurrences of application messages.
<a name="12272"></a>
Low Priority (TA_LOWPRIORITY)
Description
The lowest priority in the range within which to search for occurrences of application messages.
<a name="12280"></a>
End Time (TA_MSGENDTIME)
Description
The time marking the end of the period during which the search for occurrences of application queue messages is performed.
<a name="12281"></a>
Start Time (TA_MSGSTARTTIME)
Description
The time marking the start of the period during which the search for occurrences of application queue messages is performed.
Application Queue Transactions
The Application Queue Transactions objects allow you to manage the attributes of an application queue transactions.
<a name="T_APPQTRANS"></a>
Configuring Application Queue Transactions (T_APPQTRANS Class)
The attributes of application queue transactions are listed on the tab page labeled General. The fields for application queue transactions are information fields and cannot not be edited. The General tab page fields for Application Queue Transactions are the following.
<a name="C_APPQTRANS"></a>
General Tab
The General tab page contains the following fields.
•
Object State (TA_STATE)
•
Transaction Identifier (TA_XID)
•
App Queue Space Name (TA_APPQSPACENAME)
•
App Queue Space Device (TA_QMCONFIG)
•
Logical Machine Name (TA_LMID)
l <a name="12286"></a>
Object State (TA_STATE)
This field displays the state of the application queue transaction. An application queue transaction may be in any of the following states: ACTIVE, ABORTONLY, ABORTED, COMCALLED, READY, DECIDED, or SUSPENDED.
All operations on application queue transactions (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.
<a name="12287"></a>
Transaction Identifier (TA_XID)
This field displays transaction identifier as returned by tx_info(3) and mapped to a string representation. The data in this field should not be interpreted directly by the user except for equality comparison.
<a name="12288"></a>
App Queue Space Name (TA_APPQSPACENAME)
This field displays the name of the application queue space associated with the transaction.
<a name="12289"></a>
App Queue Space Device (TA_QMCONFIG)
This field displays the absolute pathname of the file or device where the application queue space is located.
<a name="12290"></a>
Logical Machine Name (TA_LMID)
This field displays the identifier of the logical machine where the application queue space is located.
For general information about using the Configuration Tool to configure administrative resources, see Configuring Administrative Objects.

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.