Local Shutdown Processing
To stop the local system CA MIM address space only, you can issue a z/OS STOP command for the CA MIM for z/OS started task, and then reply LOCAL or DUMP to the MIM0060 message you receive. Your reply to the MIM0060 message or the parameter you use on the SHUTDOWN command depends on if you want to receive an abend dump. When you specify LOCAL, the local CA MIM address space terminates but does not request an abend dump. When you specify DUMP, the local CA MIM address space terminates and requests an abend dump.
Alternatively, if MIMGR is the name of the started task that you want to stop, you can stop the local MIMGR address space by issuing one of the following CA MIM commands:
F MIMGR,SHUTDOWN LOCAL
F MIMGR,SHUTDOWN DUMP
F MIMGR,SHUTDOWN FREE
Other systems are not able to use resources and devices held by the system that you are stopping. This remains in effect until you restart that system or free resources and devices through the FREE command. This can also be done automatically by issuing the SHUTDOWN FREE command.
When CA MIM for z/OS terminates after a SHUTDOWN LOCAL or SHUTDOWN FREE command, abend code U1222 appears if SETOPTION LOCALSTOP=ABEND.
CA MII Activities During Local Shutdown
WARNING!Stopping a CA MII address space with the SHUTDOWN LOCAL/FREE/RESERVE/DUMP or z/OS STOP command may create data integrity exposures if the system generates new RESERVE or ENQ requests.
If you want to recycle the CA MII address space to install maintenance or to make a change to a parameter setting, we recommend that you use the LOADLIB REFRESH command. This command prevents integrity exposures by suspending new ENQ/DEQ activity while the tasks restart. This command requires that you implement the Restart Manager.
If the CA MII address space is being shut down for an IPL, you can minimize exposures by shutting down the CA MII address space last. . Alternatively, you can simply not shutdown CA MII at all and it will go away with the system. If you have MIM SETOPTION DOWNSYS=AUTOFREE specified, and there is an external system in the same sysplex, then CA MII will be automatically freed from the control file.
Resources held by the local system at the time the CA MII address space is stopped are not available for use by the rest of the MIIplex until you restart the local CA MII address space or the system is freed from the MIIplex with the MIM FREE command. A system can be automatically freed at time of shutdown by issuing the MIM SHUTDOWN FREE command.
CA MIA Activities During Local Shutdown
When CA MIM is stopped on one system, any new tape device activity on that system (such as allocations, z/OS VARY commands, UNLOAD commands, or device name replies to IEF238D WTORs) will not be serialized with the rest of the systems in the complex where CA MIM is still running.
To prevent data integrity exposures, CA MIA automatically varies all managed tape devices offline as part of address space shutdown processing. All managed tape devices that are varied online to the MIAplex, must remain varied offline to all other systems to prevent possible dual allocations.
When CA MIM is shutdown with the LOCAL, or DUMP operand, all tape resources held by the local system at the time of termination, are marked as allocated. These resources remain unavailable for use by systems in the rest of the complex where CA MIM is still running until CA MIM is restarted on the local system, or the local system is freed by issuing the CA MIM FREE command. A system can be automatically freed at time of shutdown by issuing the CA MIM SHUTDOWN FREE command.
Local System Shutdown With or Without Abend Codes
You can adjust the result of certain SHUTDOWN commands so that CA MIM stops with or without abend codes. The SHUTDOWN FREE and SHUTDOWN LOCAL commands cause a U1222 abend, and the SHUTDOWN RESERVE command causes a U1223 abend. These abends are issued only when SET MIM LOCALSTOP=ABEND. You can prevent this by changing this parameter to NOABEND.
Specify one of the following values for the LOCALSTOP parameter on the SETOPTION command:
- ABENDCA MIM stops with abend codes
- NOABENDCA MIM stops without abend codes.
Note:Other operands of the SHUTDOWN command (DUMP and GLOBAL) are not affected by the SETOPTION LOCALSTOP command..
Local Shutdown with Restart Manager
This feature is available when running under the restart manager task and COMPATLEVEL=11.81 or higher. Restart manager provides the capability to restart CA MIM components automatically after a failure, or to perform a planned restart on a single system. To perform a planned restart on a single system, use the LOADLIB REFRESH command. When used with CA MII, the restart manager maintains global resource integrity throughout the restart process. Local ENQ/DEQ activity is suspended for managed QNAMEs from the instant a failure is detected or a LOADLIB REFRESH command is issued. Activity remains suspended until the restart is complete and normal global operation resumes.
Local Shutdown with JES3
When CA MIM is started with SUB=MSTR on a JES3 system and any of the CA MIM logs are allocated to SYSOUT, enter the following command:
F MIM,CLOSELOG MIMLOG
Enter this command before shutting down JES3.