|
|
|
The FREE command tells CA MIM to free resources and devices held by a system because that system has become temporarily inactive. Use this command if a system has become inactive and you expect the system to rejoin your complex. This command is useful if you are: 1) not starting a system that CA MIM typically runs on, 2) stopping a system, or 3) if a system fails.
A MIM0116 message is issued in response to the FREE command to indicate that this command successfully updated the status of a system in the control file to FREED. A MIM0115 message is returned if a FREE command is issued for a system that is still considered active in the control file. CA MIM does not allow a system to be freed if it still has a status of ACTIVE in the control file.
When CA MIM is shut down on one system, CA MIM on the remaining systems considers resources held on the inactive system to be unavailable at the time of shutdown until a FREE command is issued for the inactive system. For example, if an enqueue that CA MII is managing is held on the system when CA MIM is shut down, CA MII on the remaining systems continues to consider that enqueue as held by the inactive system until a FREE command is issued. The same is true for CA MIA and any managed tape resources held by the system at the time CA MIA becomes inactive. Until the FREE command is issued for the inactive system, these resources are unavailable to the other systems.
Resources not held by the inactive system at the time of CA MIM shutdown are available for use by the remaining CA MIM systems before the FREE command is issued. Also, once the FREE command is issued, all managed resources are available for use by the remaining CA MIM systems. If enqueue and tape activity continues on the system where CA MIM is no longer active, then there is a risk of integrity exposures (corrupted data sets, dual allocations of tape drives) between the inactive system and the remaining CA MIM systems.
Warning! Issue the FREE command only during error recovery, if you are sure that a system has no enqueue activity, reserve activity, or tape activity. Otherwise, an integrity exposure or abend may occur.
If you receive a message about a system being inactive, then follow the procedures for responding to that message rather than simply issuing a FREE command. Procedures for responding to these messages are provided in the chapter “Troubleshooting.”
Example: Freeing resources and devices
To free resources and devices held by a system that has become inactive, or to inform CA MIM that a system will not be joining the complex, issue a FREE command from another system. Specify the system name, alias, or index number of the system that you are freeing on the FREE command. For example, to free system 01, issue this FREE command from another system on which CA MIM is running:
FREE 01
When you issue this command, any resources or devices held by system 01 are freed. All active systems ignore system 01 until you start CA MIM on that system or until you restart the product on another system and format the control files. If you format the control files at the next start-up, then all systems expect system 01 to join the complex. Therefore, reissue the FREE command if system 01 is still inactive at that time.
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |