Previous Topic: Customizing Performance Management AssistantNext Topic: Assigning APF Authorization to the Authorization Library

Customization › Customizing Performance Management Assistant › Systems-Level Enqueue for Considerations

Systems-Level Enqueue for Considerations

When Performance Management Assistant is installed in a sysplex, the clusters are shared across all servers and batch jobs that are running in the sysplex. To prevent the clusters from being corrupted because multiple users are updating it concurrently, systems-level enqueues with a QNAM $APC0900 are used.

Depending on the different possibilities of the enqueue tool that is used, you have to make sure that the QNAM $APC0900 is defined for the usage of global enqueuing. This means that if you follow an RNL INCLUDE policy, QNAM $APC0900 must be included in the RNL definition list. If you follow an RNL EXCLUDE policy, QNAM $APC0900 need not be on the exclude list.

To ensure that SYSTEMS level enqueues are honored, Performance Management Assistant provides sample members for GRS and CA MIM with QNAME entries that are used by PMA.

The PMA.SAMP data set contains two sample members that can be used to define the QNAME definitions for GRS or CA MIM:

You can add the definitions that are described in these members to the appropriate GRS member in SYS1.PARMLIB or to the appropriate QNAME member in a CA MIM CNTL library. See the following examples.

GRS Example

/********************************************************************/
/*                                                                  */
/*   SAMPLE IBM GLOBAL RESOURCE SERIALIZATION(GRS) DEFINITIONS      */
/*                                                                  */
/********************************************************************/
/*                                                                  */
/********************************************************************/
/*                                                                  */
/* SYSTEM  INCLUSION RESOURCE NAME LIST- RNLDEF STATEMENTS          */
/*                                                                  */
/********************************************************************/
/*                                                                  */
RNLDEF RNL(INCL) TYPE(GENERIC) QNAME($APC0900)                        
/*                                                                  */
/********************************************************************/

MIM Example

*            SAMPLE QNAME DEFINITIONS FOR USE WITH               
*  CA-MULTI-IMAGE MANAGER (MIM) FOR RESOURCE SHARING             
*                                                                
*  PMA INTEGRITY QNAMES. GDIF IS TO INTERCEPT SYSTEMS ENQUEUE    
*  REQUESTS (INCLUDES RESERVES) AND CONVERT THEM TO GLOBAL       
*  ENQUEUES.  ECMF SHOULD REPORT CONFLICTS AS THEY OCCUR.        
*  THE EXEMPT LIST SHOULD BE APPLIED TO THIS QNAME.              
*                                                                
$APC0900 GDIF=YES,         /* GDIF SHOULD PROCESS THIS QNAME     
         SCOPE=SYSTEMS,    /* GDIF TO PROCESS ALL ENQS           
         EXEMPT=YES,       /* APPLY EXEMPT LIST                  
         ECMF=NO,          /* ECMF REPORTS CONFLICTS             
         RPTAFTER=30,      /* REPORT CONFLICT IMMEDIATELY        
         RPTCYCLE=120,     /* AND AT EVERY 120 SECONDS THEREAFTER
         TRACE=NONE        /* NO TRACING