Local modification example

VMSES/E helps you manage your software inventory by keeping track of the products you have installed, what service is installed for each product, and any local modifications or local service you have installed. This is beneficial because if one type of service impacts another type (for example, a new PTF affects a part you have modified locally) VMSES/E will notify you.

For this reason, IBM recommends that you use the LOCALMOD command whenever you need to install local service or update certain configuration and control files. The following is an example of updating the constants file for the Virtual Machine Resource Manager (VMRM).

VMRM, part of the CMS component, has a configurable constants file, IRMCONS COPY, that defines many values that are needed by VMRM to help you manage the performance of the Linux images on your z/VM system. In this example, you will change the constant "MinRequired" to improve performance for some Linux guest systems.

1. Update the constants file using the LOCALMOD command:

   localmod cms irmcons copy 
   	VMFLMD2760I LOCALMOD processing started               
   	VMFSET2760I VMFSETUP processing started for SERVP2P CMS
   	.
   	.
   	VMFLMD1301R Local modification L0002 is being created for replacement part
               IRMCONS COPY.                                                 
               Enter (0) to quit; (1) to continue.                           
               If you choose to continue, you will be put into an XEDIT session.
               Make your changes and then enter FILE.                        
    1
     ENTER          

   At this point you will be placed into an XEDIT session for the IRMCONS COPY file. Locate the constant "minrequired" (by specifying "/minrequired"and pressing Enter) and then type over the value "16384" with your new value (32768, for example). Type "file" on the command line and press Enter. More messages will be displayed by the LOCALMOD command:

   VMFREP2760I VMFREPL processing started                                    
   VMFREP2507I IRMCONS CPYL0002 created on your E-disk from part IRMCONS COPY Q
               for use in a VMSES/E environment                                  
   VMFREP2760I VMFREPL processing completed successfully                     
   VMFREP2760I VMFREPL processing started                                    
   VMFREP2509I The version vector table 6VMCMS20 VVTLCL E will be updated for
               the part IRMCONS CPY                                              
   VMFREP2760I VMFREPL processing completed successfully                     
   VMFLMD2760I LOCALMOD processing completed successfully
   Ready;

2. Use the SERVICE command to build VMRM parts with the updated constants file:

   service cms build
   	VMFSRV2760I SERVICE PROCESSING STARTED
   	.
   	.
   	VMFBLD2760I VMFBLD PROCESSING STARTED               
   	VMFBLD1851I READING BUILD LISTS                     
   	VMFBLD2182I IDENTIFYING NEW BUILD REQUIREMENTS      
   	VMFBLD2182I NEW BUILD REQUIREMENTS IDENTIFIED       
   	VMFBLD2180I THERE ARE 2 BUILD REQUIREMENTS REMAINING
   	VMFBLD2760I VMFBLD PROCESSING COMPLETED SUCCESSFULLY
   	VMFBLD2760I VMFBLD PROCESSING STARTED               
   	VMFBLD1851I READING BUILD LISTS                     
   	VMFBLD2182I IDENTIFYING NEW BUILD REQUIREMENTS      
   	VMFBLD2182I NO NEW BUILD REQUIREMENTS IDENTIFIED
   	VMFBLD1851I (1 OF 2) VMFBDCOM PROCESSING DMSBLSRC EXEC Q, TARGET IS BUILD7 493
               (K)                                                           
   	VMFBDC2219I PROCESSING OBJECT =.COPY                                      
   	VMFBLD1851I (1 OF 2) VMFBDCOM COMPLETED WITH RETURN CODE 0 
   	VMFBLD1851I (2 OF 2) VMFBDCOM PROCESSING DMSBL493 EXEC Q, TARGET IS BUILD7 493
               (K)                                                           
   	VMFBDC2219I PROCESSING OBJECT IRMCONS.COPY                                
   	VMFBLD1851I (2 OF 2) VMFBDCOM COMPLETED WITH RETURN CODE 0                
   	VMFBLD2180I THERE ARE 0 BUILD REQUIREMENTS REMAINING
   	VMFBLD2760I VMFBLD PROCESSING COMPLETED SUCCESSFULLY
   	.
   	.
   	VMFSRV1233I THE FOLLOWING PRODUCTS HAVE BEEN SERVICED.
   	VMFSRV1233I CMS                                       
   	VMFSRV2760I SERVICE PROCESSING COMPLETED SUCCESSFULLY
   	Ready; 

3. Use the PUT2PROD command to put the updated parts into production:

   put2prod

   Note: If you are running an SSI cluster, on each member of the SSI cluster you must log on to MAINTvrm and run the PUT2PROD command.