Enabling SOA Using WebSphere Messaging

Chapter 5. Point-to-point runtime configuration 163

5.3.2 Set up the CFRM policy with the MQ structures

You need to define the coupling facility structures used by the queue managers

in the queue-sharing group in the Coupling Facility Resource Management

(CFRM) policy data set, using IXCMIAPU. All the structures for the queue

sharing group start with the name of the queue sharing group (in our case, it is

MQQG). You must have the following:

򐂰 An administrative structure called qsg-name CSQ_ADMIN (in our case, it is

MQQGCSQ_ADMIN). This structure is used by WebSphere MQ itself and

does not contain any user data.

򐂰 One or more structures used to hold messages for shared queues. These can

have any name you choose, up to 16 characters in length. The first four

characters must be the queue-sharing group name (in our case, the structure

name is MQQGWEBQUEUE).

Figure 5-34 shows the statements added to the CFRM policy to define the two

MQ structures.

Figure 5-34 Define structures in CFRM policy

When you have defined your structures successfully, activate the CFRM policy

that is being used with the SETXCF command.

5.3.3 Add the MQ data sharing group entry to the DB2 table

You need to define the MQ subsystems that are participating in the MQ

queue-sharing groups and the MQ sharing group itself in the DB2 table. You can

use the CSQ5PQSG utility to add queue-sharing group and queue manager

entries to the WebSphere MQ tables in the DB2 data-sharing group. You can run

STRUCTURE NAME(MQQGCSQ_ADMIN)

INITSIZE(10240)

SIZE(20480)

PREFLIST(CF03,CF06)

REBUILDPERCENT(5)

FULLTHRESHOLD(85)

STRUCTURE NAME(MQQGWEBQUEUE)

INITSIZE(10240)

SIZE(20480)

PREFLIST(CF03,CF06)

REBUILDPERCENT(5)

FULLTHRESHOLD(85)

164 Enabling SOA Using WebSphere Messaging

the utility for the queue-sharing group and for the queue manager that is to be a

member of the queue-sharing group.

To accomplish this requires the following:

򐂰 Add a queue sharing group entry.

򐂰 Add a queue manager entry for MQQ1.

򐂰 Add a queue manager entry for MQQ2.

Add a queue sharing group entry

Add a queue-sharing group entry into the WebSphere MQ DB2 tables using the

ADD QSG function of the CSQ5PQSG program by running the CSQ45AQS job.

Note the following:

򐂰 You need to perform this function once for

each queue-sharing group that is

defined in the DB2 data-sharing group.

򐂰 The queue-sharing group entry must exist

before adding any queue manager

entries that reference the queue-sharing group.

Example 5-7 Add a queue-sharing group entry - CSQ45AQS

//MQQGAQS JOB (999,POK),'CONWAY',CLASS=A,MSGCLASS=T,

// NOTIFY=&SYSUID,TIME=1440,REGION=0M

/*JOBPARM L=999,SYSAFF=SC55

//******************************************************************

//* IBM WebSphere MQ for z/OS *

//* *

//* Sample job to add a queue-sharing group record into the *

//* DB2 administration table CSQ.ADMIN_B_QSG used by WebSphere MQ *

//* using the CSQ5PQSG utility. *

//* *

//******************************************************************

//* *

//* MORE INFORMATION - See: *

//* "WebSphere MQ for z/OS System Setup Guide" *

//* for information about this customization job *

//* "WebSphere MQ for z/OS System Administration Guide" *

//* for information about CSQ5PQSG *

//* and managing queue-sharing groups *

//* *

//******************************************************************

//* CUSTOMIZE THIS JCL HERE FOR YOUR INSTALLATION

//******************************************************************

//*

//ADDQSG EXEC PGM=CSQ5PQSG,REGION=4M,

// PARM='ADD QSG,MQQG,DB8QU,D8QG'

//SYSPRINT DD SYSOUT=*

//STEPLIB DD DSN=MQ600.SCSQANLE,DISP=SHR

Chapter 5. Point-to-point runtime configuration 165

// DD DSN=MQ600.SCSQAUTH,DISP=SHR

// DD DSN=DB8Q8.SDSNLOAD,DISP=SHR

//

Add a queue manager entry for MQQ1

Add a queue manager entry for MQQ1 into the WebSphere MQ DB2 tables using

the ADD QMGR function of the CSQ5PQSG program by running the

CSQ45AQM job.

Example 5-8 CSQ45AQM, add a queue manager entry

//MQQGAQM JOB (999,POK),'CONWAY',CLASS=A,MSGCLASS=T,

// NOTIFY=&SYSUID,TIME=1440,REGION=0M

/*JOBPARM L=999,SYSAFF=SC55

//******************************************************************

//* IBM WebSphere MQ for z/OS *

//* *

//* Sample job to add a queue manager record into the *

//* DB2 administration table CSQ.ADMIN_B_QMGR used by WebSphere MQ *

//* using the CSQ5PQSG utility. *

//* *

//******************************************************************

//* *

//* MORE INFORMATION - See: *

//* "WebSphere MQ for z/OS System Setup Guide" *

//* for information about this customization job *

//* "WebSphere MQ for z/OS System Administration Guide" *

//* for information about CSQ5PQSG *

//* and managing queue-sharing groups *

//* *

//******************************************************************

//* CUSTOMIZE THIS JCL HERE FOR YOUR INSTALLATION

//******************************************************************

//*

//ADDQMGR EXEC PGM=CSQ5PQSG,REGION=4M,

// PARM='ADD QMGR,MQQ1,MQQG,DB8QU,D8QG'

//SYSPRINT DD SYSOUT=*

//STEPLIB DD DSN=MQ600.SCSQANLE,DISP=SHR

// DD DSN=MQ600.SCSQAUTH,DISP=SHR

// DD DSN=DB8Q8.SDSNLOAD,DISP=SHR

//

Add a queue manager entry for MQQ2

Add a queue manager entry for MQQ2 by running the same job and updating the

parm field specifying the queue manager name.