Preparing to start the CQS address space

Before you can start the Common Queue Server (CQS) address space, you must define CQS parameters, and you must create and activate the necessary z/OS® policies.

Because they are a part of the defined IMS system, CQS and Base Primitive Environment (BPE) are automatically linked into IMS.SDFSRESL when you run the JCLIN job stream.

You must define CQS parameters before starting the CQS address space. Define the parameters using either of the following:

  • CQS initialization parameters member of the IMS PROCLIB data set (CQSIPxxx)
  • CQS startup procedure (CQSINIT0 or BPEINI00)

Procedure

  1. Create a coupling facility resource management (CFRM) policy that defines the structures to which you want CQS to connect. The CFRM policy specifies the name, size, attributes, and location that the structure is to be assigned when it is allocated.
  2. Define the following z/OS policies:
    • Sysplex failure management (SFM) policy
    • System logger (LOGR) policy
      Note: In the LOGR policy, specify the MAXBUFSIZE parameter as 65272 bytes to ensure that the system logger can write the largest possible log record that is written by CQS.
    • Automatic restart management (ARM) policy
  3. Activate the CFRM policy using the following command: 
    SETXCF START,POLICY,TYPE=CFRM,POLNAME=CONFIG01
    The structure is allocated when the first CQS connects to it.
  4. If you are using the SFM policy, activate it using the following command: 
    SETXCF START,POLICY,TYPE=SFM,POLNAME=SFMPOL
  5. Create the CQS and BPE members of the IMS PROCLIB data set.
  6. Define all CQS execution data sets.
  7. Customize your CQS environment; determine which exits you want to use and then write the exits, which can include the following:
    • CQS initialization-termination user-supplied exit routine
    • CQS client connection user-supplied exit routine
    • Queue overflow user-supplied exit routine for CQS
    • CQS structure statistics user-supplied exit routine
    • CQS structure event user-supplied exit routine
    • CQS statistics available through the BPE statistics user exit
  8. Authorize connections to CQS structures.
  9. Update the z/OS program properties table.
  10. Plan security.