(ZOS) Update the CFRM policy

We must update the coupling facility resource management (CFRM) policy before using log streams that are CF-resident, such as the WebSphere Application Server error log and RRS logs. If we have the source for the current active CFRM policy, update the source and use the IXCMIAPU Administrative Data utility to generate the new policy.

If we do not have the source for the current active CFRM policy, rebuild the source from the active CFRM policy.

Tasks

1. Find the active policy by issuing the command: D XCF,POL You will get output similar to this (partial display):

   D XCF,POL                                             
     IXC364I  10.57.49  DISPLAY XCF 061                    
     . . .                               
     TYPE: CFRM                                            
          POLNAME:       POLCF1N1                          
          STARTED:       03/14/2003 11:32:22               
          LAST UPDATED:  03/14/2003 11:31:52               
     . . . 
   

2. List the active CFRM Policy's structure definitions using the Administrative Data utility:

   //STEP1   EXEC PGM=IXCMIAPU
   //STDOUT DD   STDERR=*
   //SYSABEND DD   STDERR=*
   //SYSIN    DD   *
   DATA TYPE(CFRM) REPORT(YES)
   /*
   
   

3. Extract the definitions for the ACTIVE policy only. Using the STDOUT from the previously listed utility job, edit the output with the following steps so it can be used to define a new policy in the next job:

   1. Extract the definitions for the ACTIVE policy only.

   2. Delete the heading lines.

   3. Add the new structure definition using the BBOWCFRM member of the target CNTL dataset as a model.

   4. Copy it into a FB-LRECL(80) dataset to be used as SYSIN for the following job.

4. Use the Administrative Data utility to update the CFRM policy. The policy name can be the same as the ACTIVE CFRM policy or a new name. If we use the active policy name, REPLACE(YES) must be specified on the DEFINE control statement.

   //STEP20   EXEC PGM=IXCMIAPU
   //STDOUT DD   STDERR=*
   //SYSABEND DD   STDERR=*
   //SYSIN    DD   *
    DATA TYPE(CFRM) REPORT(YES)
   
    DEFINE POLICY NAME(POLCF1N1) REPLACE(YES)
   
       CF NAME(CF1LPAR) DUMPSPACE(5000) PARTITION(0E) CPCID(00)
          TYPE(009672) MFG(IBM) PLANT(02) SEQUENCE(000000051205)
   
       CF NAME(CF2LPAR) DUMPSPACE(5000) PARTITION(0F) CPCID(00)
          TYPE(009672) MFG(IBM) PLANT(02) SEQUENCE(000000051205)
   
       STRUCTURE NAME(CTS130_DFHLOG) SIZE(24000) INITSIZE(12000)
          REBUILDPERCENT(1)  PREFLIST(CF1LPAR, CF2LPAR)
       . . .
                 <== Insert the new structure definitions here
   

5. Activate the new policy by issuing the following MVS™ Command:

   SETXCF START,POLICY,TYPE=CFRM,POLNAME=POLCF1N1
   

What to do next

For more information about coupling facility structures and the IXCMIAPU utility, see the z/OS manual MVS Setting Up a Sysplex (SA22-7625).

Choose and using diagnosis tools and controls on z/OS

Diagnose problems (using diagnosis tools)