search cancel

Dynamic refresh for MIM when applying maintenance

book

Article ID: 228774

calendar_today

Updated On:

Products

MIM Resource Sharing (MIM)

Issue/Introduction

We are applying some new MIM PTFs  on our environment.
Is there any dynamic refresh on CAMIMGR that we can perform without stopping it, or do we need to IPL the system?

 

 

Environment

Release : 12.5

Component : MIM

Resolution

MIM has a LOADLIB command that can be used to implement a different LOAD library than what is currently active. In this process, MIM does an internal shutdown, while still ensuring resource integrity, then restarts with the new maintenance. It is less intrusive than an IPL but maintains the integrity of your environment.

Before using the LOADLIB command, please be aware of the following:

1. Your MIM address space must be configured to use the MIM Restart Manager and any load libraries must be defined as PDS.

2. If you are using virtual control files, be sure you are not entering the LOADLIB REFRESH command on the current VCF master - it should be migrated to a different system first.

3. We recommend that these PTFS be applied to avoid potential problems when issuing the command (see also Additional Information)
RO97775 VCF delays
RO98592 S0D3 REASON=13 AFTER LOADLIB REFRESH
SO07592 RESERVES not converted with LOADLIB REFRESH
SO08094 S0C4 RC=4 MIMDRBGN MIMASCRE
SO13799 ENQ HANG IN MIMEQXGD

The last two correct issues with PE'd PTF SO07592.



This is how it works in a nutshell:

1. You will be adding the new LOAD library to a specific location in the MIM MRMFIL (this is either explicitly defined or dynamic)

2. You will issue LOADLIB REFRESHFROM to change from your current LOADLIB to the new one.

An example of the order of commands could be

F MIM,D LOADLIB                            <---see what libraries are in the MIM RMFIL
F MIM,LOADLIB RESETALTERNATE <--remove the existing alternate library
F MIM,LOADLIB SETALTERNATE=(new.load,DASD) <---add the new library containing maintenance
F MIM,LOADLIB REFRESHFROM=ALTERNATE <---refresh MIM with the new library

The display command will show something like

MIM0067I Command DISPLAY 801             
MIM0964I MIM Load Library Display:      
 Type DSName                             
Init MIM.LXT1.MIM125.TS1.CBTDLOAD       
Curr MIM.LXT1.MIM125.TS1.CBTDLOAD       
 Prim MIM.LXT1.MIM125.TS1.CBTDLOAD       
Alt  MERGR01.MIM125.MII00284.CBTDLOAD.T
 SETAPF=Yes                              
 STARTFROM=Initial  


You can have up to 4 different LOAD libraries defined, and commands exist to change the content of any one of those by pointing to the TYPE.  In my example, the first 3 are the same as my current STEPLIB. I pointed to the last one, Alt (ALTERNATE), to add a different library and use it for the REFRESH.


If you are not familiar with this command, I recommend that you read up on it. 
These sections in our doc are helpful.


This section of the doc gives an overview of the Dynamic Refresh Feature.
https://techdocs.broadcom.com/us/en/ca-mainframe-software/traditional-management/ca-mim-for-z-os/12-5/release-notes/new-features-in-ca-mim-for-z-os-release-12-5/new-ca-mim-driver-features.html 


This section shows the syntax
https://techdocs.broadcom.com/us/en/ca-mainframe-software/traditional-management/ca-mim-for-z-os/12-5/statement-and-command-reference/general-ca-mim-statements-and-commands/mim-loadlib-command.html

and this section outlines the process  described above, Dynamic Refresh Activation
https://techdocs.broadcom.com/us/en/ca-mainframe-software/traditional-management/ca-mim-for-z-os/12-5/ca-mim-product-maintenance/dynamic-refresh-activation.html

Additional Information

Regarding the recommended PTFs - the described problems have affected a very few customers, so you can issue the command even if they are not applied. The caveat is that if you do hit one of those problems, it is safest to have a plan in place to IPL the system in order to recover as quickly and cleanly as possible.