General CA MIM Statements and Commands › (MIM) REMOVE Command-Remove System ID

(MIM) REMOVE Command-Remove System ID

The REMOVE command lets you permanently remove a system ID from the CA MIM control files.

Scope: Global

This command has the following format:

REMOVE sysid

sysid

Specifies the system name, system alias, or index number of the system that should be removed permanently from the control files.

Usage Notes: REMOVE Command

• REMOVE must be issued from a console or a TSO session. You cannot issue REMOVE from the CA MIM parameter data set.
• You must be authorized to issue system control commands to issue the REMOVE command. TSO users generally are not authorized to issue system control commands.
• CA MIM cannot be active on the specified system when you issue the REMOVE command. If CA MIM is active on that system, message MIM0097 is issued and the command is ignored.
• The REMOVE command cannot be issued in a CTCDASD, CTCONLY, or XCF environment.
• The REMOVE command should not be issued before the FREE command in a two-system complex, because this prevents the first system started from initializing.

  Note: For more information, see Product Activation Considerations in the chapter “Advanced Topics” in the CA MIM Programming Guide.

• The local system will not synchronize if all external systems are removed.
• If a system is inactive temporarily, then you should use the FREE command instead of the REMOVE command.
• To determine what system IDs have been assigned to a system, issue the DISPLAY SYSTEMS command.
• After a system is removed using the REMOVE command, the system should also be deleted from the DEFSYS statement on all systems in the complex. Otherwise, the system will be added back into the control files the next time the control files are formatted.

Example: REMOVE Command

To permanently remove the entry for system SYSB from the CA MIM control files, issue this command:

REMOVE SYSB