Air Cleaner User Manual
Apart from maintaining a value for this parameter, the queue manager
takes no action based on its value.
Specify a value greater than or equal to zero, and less than or equal to
999 999 999.
CFSTRUCT(cfname)
Specifies the name of the Coupling Facility structure where you want
messages stored when you use shared queues.
This parameter is supported only on OS/390 for local and model queues.
The name:
v Cannot have more than 12 characters
v Must start with an uppercase letter (A through Z)
v Can include only the characters A through Z and 0 through 9
The name of the queue-sharing group to which the queue manager is
connected is prefixed to the name you supply. The name of the
queue-sharing group is always four characters. For example, if you use a
queue-sharing group named NY03 and you supply the name PRODUCT7, the
resultant Coupling Facility structure name is NY03PRODUCT7. Note that the
administrative structure for the queue-sharing group (in this case
NY03CSQ_ADMIN) cannot be used for storing messages.
For ALTER QLOCAL, ALTER QMODEL, DEFINE QLOCAL with
REPLACE, and DEFINE QMODEL with REPLACE the following rules
apply:
v On a local queue with QSGDISP(SHARED), CFSTRUCT cannot change.
If you need to change either the CFSTRUCT or QSGDISP value you
must delete and redefine the queue. To preserve any of the messages on
the queue you must offload the messages before you delete the queue
and reload the messages after you have redefined the queue, or move
the messages to another queue.
v On a model queue with DEFTYPE(SHAREDYN), CFSTRUCT cannot be
blank.
v On a local queue with a QSGDISP other than SHARED, or a model
queue with a DEFTYPE other than SHAREDYN, the value of
CFSTRUCT does not matter.
For DEFINE QLOCAL with NOREPLACE and DEFINE QMODEL with
NOREPLACE, the Coupling Facility structure:
v On a local queue with QSGDISP(SHARED) or a model queue with a
DEFTYPE(SHAREDYN), CFSTRUCT cannot be blank.
v On a local queue with a QSGDISP other than SHARED, or a model
queue with a DEFTYPE other than SHAREDYN, the value of
CFSTRUCT does not matter.
Note: Before you can use the queue, the structure must be defined in the
Coupling Facility Resource Management (CFRM) policy data set.
CLUSNL(nlname)
The name of the namelist that specifies a list of clusters to which the queue
belongs.
This parameter is supported only on alias, local, and remote queues.
Changes to this parameter do not affect instances of the queue that are
already open.
Define queues
Chapter 2. The MQSeries commands 115
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|