General CA MIM Statements and Commands › (MIM) FREE Command-Release Resources

(MIM) FREE Command-Release Resources

The FREE command allows you to release devices and resources held by a system that is currently inactive. You should not attempt to free an active system.

Scope: Global

This command has the following format:

FREE sysid | (sysid1,sysid2,...)

sysid

Identifies an inactive system that is to be freed. You can use the system name, alias, or index number to identify this system. You can specify multiple system IDs if you want to free more than one system, but multiple IDs must be enclosed in parentheses.

Usage Notes: FREE Command

Important! You should not free a system unless you are sure that CA MIM is not running on that system. If you free a system that is active, the system will ABEND with user code U0322.

• Prior to synchronization in a CTCONLY environment, the FREE command can only be used to free a system that is directly connected through CTC paths. This will prevent a system from mistakenly being freed while it is still active.
• The FREE command can be issued only for a system that is considered possibly inoperative. Systems considered possibly inoperative are those indicated in messages MIM0061, MIM0062, or MIM0350.
• The FREE command must be issued from a console or a TSO session. You cannot issue this command from the CA MIM parameter data set.
• You must be authorized to issue system control commands to issue the FREE command. TSO users generally are not authorized to issue system control commands.
• Using the FREE command causes the status of the system to be considered inactive.
• Use the DISPLAY SYSTEMS command to list the names and status of all systems in the MIMplex.

Examples: FREE Command

• To inform CA MIM that system SYSB is inactive, issue the following command:

  FREE SYSB
  

• To inform CA MIM that systems SYSB and SYSC are inactive, issue the following command:

  FREE (SYSB,SYSC)