Define the z/VM service machines to MVS

Before MVS™ can use the z/VM® Guest Coupling Simulation support, the administrative policy data in the Coupling Facility Resource Manager (CFRM) policy must be updated to define the CF Service Machines to MVS. Figure 1 is an example of the JCL required to define a sysplex. In this example, the sysplex will use two z/VM CF Service Machines. The user ID of the first CF Service Machine is CFCC1 and the user ID of the second is CFCC2.

Figure 1. Example: JCL to define the CF Service Machines to MVS

//UPADJOB  JOB
//******************************************************************
//*                                                                *
//* EXAMPLE JCL TO UPDATE THE ADMINISTRATIVE POLICY DATA IN THE    *
//* COUPLE DATA SET FOR CFRM (COUPLING FACILITY RESOURCE MANAGER)  *
//*                                                                *
//******************************************************************
//STEP20    EXEC PGM=IXCMIAPU
//SYSPRINT  DD   SYSOUT=A
//SYSABEND  DD   SYSOUT=A
//SYSIN     DD   *
            DATA TYPE(CFRM) REPORT(YES)
                                       
            DEFINE POLICY NAME(POLICY1) REPLACE(YES)

              CF NAME(CFCC1
                     TYPE(SIMDEV)
                     MFG(IBM)
                     PLANT(EN)
                     SEQUENCE(0000000CFCC1)
                     PARTITION(0)
                     CPCID(00)
                     DUMPSPACE(2000)

              CF NAME(CFCC2
                     TYPE(SIMDEV)
                     MFG(IBM)
                     PLANT(EN)
                     SEQUENCE(0000000CFCC2)
                     PARTITION(0)
                     CPCID(00)
                     DUMPSPACE(2000)

              STRUCTURE NAME(LIST_01)
                     SIZE(10000)
                     INITSIZE(1000)
                     PREFLIST(CFCC1,CFCC2)
                     EXCLLIST(CACHE_01)

              STRUCTURE NAME(CACHE_01)
                     SIZE(1000)
                     REBUILDPERCENT(25)
                     PREFLIST(CFCC2,CFCC1)
                     EXCLLIST(LIST_01)

The information for TYPE(0), MFG(), PLANT(), and SEQUENCE() can be obtained by using the CP QUERY MSGPROC command. The TYPE(), MFG(), and PLANT() information will always be the same when using z/VM Guest Coupling Simulation support. The SEQUENCE() value must be unique and is based on the user ID of the CF Service Machine.