CQSIPxxx member of the IMS PROCLIB data set

Use the CQSIPxxx member of the IMS PROCLIB data set to specify parameters that are related to initialization of the CQS address space. You can use CQS execution parameters to override certain parameters within CQSIPxxx.

Syntax

You can use the IMS Syntax Checker to modify this member of the IMS PROCLIB data set.

Usage

The following rules apply to the format of the CQSIPxxx member:

The execution member consists of one or more fixed-length character records. (The configuration data set can be of any logical record length (LRECL) greater than eight, but it must be of fixed-record format.)
The rightmost eight columns of each record are ignored and you can use them for sequence numbers or any other notation. In the remaining columns, you code the keyword parameters. For example, if your record size is 80, you use columns 1 through 72 for your configuration data. You can use columns 73 through 80 for sequence numbers.
Keywords can contain leading and trailing blanks.
Each record can contain multiple keywords.
Use commas or spaces to delimit keywords.
Use an asterisk (*) or pound sign (#) in column one to begin a comment. You can include a comment anywhere within a statement by enclosing it between a slash-asterisk and an asterisk-slash pair.
```
/*This is an example of a comment within a statement*/
```
Values coded in this member of the IMS PROCLIB data set are case sensitive.

Parameters

ARMRST= Y | N

Specifies whether the z/OS® Automatic Restart Manager (ARM) is used to restart the CQS address space after an abend. If you specify Y (yes), ARM restarts the CQS address space after most system failures. If you specify N (no), ARM does not restart the CQS address space after any system failure.

ARM does not restart the CQS address space if the CQS abends before restart is complete.

To restart the CQS when it has been canceled by z/OS, you must specify the ARMRESTART option of either the z/OS CANCEL or FORCE command.

Related reading: For information about the CANCEL and FORCE commands, see MVS/ESA System Commands.

This parameter can be specified as an execution parameter on the CQS procedure to override the value in CQSIPxxx.

CQSGROUP=

Specifies a 1- to 5-character identifier. CQS concatenates this identifier to the characters CQS to create the group name of the z/OS cross-system coupling facility CQS shared queues. You must use the same identifier for all CQS address spaces that share the same set of structures. You can also use the same identifier for the SQGROUP= parameter in the DFSSQxxx member of the IMS PROCLIB data set.

This parameter can be specified as an execution parameter on the CQS procedure to override the value in CQSIPxxx.

IMSPLEX()

Specifies the IMSplex to which CQS joins. IMSPLEX is an optional parameter. IMSPLEX does not have a default value. Only one IMSPLEX keyword can be specified. The IMSPLEX definition parameter follows:

NAME=: A 1- to 5-character user-specified identifier that is concatenated to 'CSL' to create the cross-system coupling facility (XCF) CSL IMSPLEX group name. The value specified here must match the IMSPLEX NAME= value specified in the SCI startup procedure. All OM, RM, SCI, IMS, CQS and similar address spaces must specify the same name to be part of the same IMSplex. The same identifier must also be used for the IMSPLEX= parameter in the CSLSIxxx, CSLOIxxx, CSLRIxxx, and DFSCGxxx members of the IMS PROCLIB data set.

NUMTASKSPUT=

Specifies the number of PUT request tasks (z/OS TCBs) per structure within the CQS address space. The number must be from 1 to 9. The default is 2.

PUT request tasks process CQSPUT and CQSUPD requests. The total number of PUT request tasks is equal to the NUMTASKSPUT value times the number of primary message queue and resource structures that are defined, but no more than 64.

Recommendation:

Use the default value for NUMTASKSPUT unless you are advised to use different values by IBM®. It's a performance tuning parameter that relates to the number of tasks available within the CQS address space to process certain CQS requests.

The default value is generally sufficient.

Having more tasks can add capacity for certain peak high-volume situations, but can also possibly cause more contention and overhead.

NUMTASKSREAD=

Specifies the number of READ request tasks (z/OS TCBs, or SRBs if CONDSRB=COND or ALWAYS) per structure within the CQS address space. The number must be from 1 to 9. The default is 2.

READ request tasks process CQSREAD and CQSBRWSE requests. The total number of READ request tasks is equal to the NUMTASKSREAD value times the number of primary message queue and resource structures that are defined, but no more than 64.

Recommendation:

Use the default value for NUMTASKSREAD unless you are advised to use different values by IBM. It's a performance tuning parameter that relates to the number of tasks available within the CQS address space to process certain CQS requests.

The default value is generally sufficient.

Having more tasks can add capacity for certain peak high-volume situations, but can also possibly cause more contention and overhead.

NUMTASKSOTHER=

Specifies the number of OTHER request tasks (z/OS TCBs) per structure within the CQS address space. The number must be from 1 to 9. The default is 2.

OTHER request tasks process CQSDEL, CQSINFRM, CQSMOVE, CQSRECVR, CQSRSYNC, and CQSUNLCK requests. The total number of OTHER request tasks is equal to the NUMTASKSOTHER value times the number of primary message queue and resource structures that are defined, but no more than 64.

Recommendation:

Use the default value for NUMTASKSOTHER unless you are advised to use different values by IBM. It's a performance tuning parameter that relates to the number of tasks available within the CQS address space to process certain CQS requests.

The default value is generally sufficient.

Having more tasks can add capacity for certain peak high-volume situations, but can also possibly cause more contention and overhead.

SSN=

Specifies the name for the CQS address space. The value must be 1 - 4 alphanumeric characters. The SSN= parameter can be specified either in the CQSIPxxx PROCLIB member or as a CQS execution parameter. If the SSN= parameter is specified in both the CQSIPxxx PROCLIB member and as an execution parameter, the value specified for the execution parameter overrides the value specified in the CQSIPxxx PROCLIB member. The name specified is used to create the CQSID, which is used in CQS processing. The CQSID is the SSN followed by the characters CQS. Every CQS within the same CQSGROUP must have a unique name. Additionally, every CQS running on the same LPAR must have a unique name, regardless of what CQSGROUP it is in. Recommendation: Give unique names to all CQSs across your sysplex. This helps to avoid name conflicts if CQSs are ever moved among LPARs.

Every CQS within the same CQSGROUP must have a unique name. Additionally, every CQS running on the same LPAR must have a unique name, regardless of what CQSGROUP it is in.

Recommendation: Give unique names to all CQSs across your sysplex. This helps to avoid name conflicts if CQSs are ever moved among LPARs.

Example: If SSN=ABC, CQSID=ABCCQS.

Trailing blanks are deleted and the CQSID is padded with blanks.

Note: CQS does not register as a IBM z/OS subsystem.

STRDEFG=

Specifies a 3-character suffix for the CQS global structure definition member of the IMS PROCLIB data set, CQSSGxxx. This member contains the parameters related to the coupling facility structures that are common to all CQS address spaces that are sharing the queues. If you specify this as an execution parameter on the CQS startup procedure, it overrides the value specified in the CQSIPxxx member of the IMS PROCLIB data set. The default suffix is 000.

STRDEFL=

Specifies a 3-character suffix for the CQS local structure definition member of the IMS PROCLIB data set, CQSSLxxx. This member contains the parameters that are related to the coupling facility structures and that are unique to an individual CQS address space. If you specify this as an execution parameter on the CQS startup procedure, it overrides the value specified in the CQSIPxxx member of the IMS PROCLIB data set. The default suffix is 000.

Sample CQSIPxxx member of the IMS PROCLIB data set

A sample CQSIPxxx member of the IMS PROCLIB data set is shown here:

**********************************************************************
* CQS INITIALIZATION PROCLIB MEMBER                                  *
**********************************************************************
 
ARMRST=Y                /* ARM SHOULD RESTART CQS ON FAILURE        */
CQSGROUP=GRUP1          /* GROUP NAME (XCF GROUP = GRUP1CQS)        */
SSN=CQS1                /* CQS ADDRESS SPACE  (CQSID = CQS1CQS)     */
STRDEFG=190             /* GLOBAL STR DEFINITION MEMBER = CQSSG190  */
STRDEFL=191             /* LOCAL STR DEFINITION MEMBER  = CQSSL191  */
IMSPLEX(NAME=PLEX1)     /* IMSPLEX NAME(CSLPLEX1)                   */