General CA MIM Statements and Commands › SHUTDOWN Command—Stop CA MIM

SHUTDOWN Command—Stop CA MIM

The SHUTDOWN command lets you stop CA MIM.

This command has the following format:

SHUTDOWN [{DUMP | FORCE | FREE | GLOBAL | LOCAL}]

DUMP

(Optional). Stops CA MIM on the local system with a U1122 user ABEND code. CA MIM also requests an ABEND dump.

Important! Integrity exposures can occur when you specify this operand.

Note: For more information about possible integrity exposures when stopping CA MIM, see the CA MIM Programming Guide.

FORCE

(Optional) Stops CA MIM when the communication method is virtual, and when the system being shut down is the only eligible master system in a virtual control file environment. Using this operand prevents accidental shutdown of the master system while non-master systems are still active. FORCE should only be specified after you have received a MIM0468W message.

When the FORCE operand is specified on a SHUTDOWN command after MIM0468W message appears the original rejected command is executed.

Important! Integrity exposures can occur when you specify this operand.

FREE

(Optional). Shuts down CA MIM on the local system and leaves it in a freed state (as if a 'FREE' sysid was issued on an external system). No ABEND dump is requested. CA MIM stops with an ABEND code U1222 if SETOPTION MIM LOCALSTOP=ABEND. FREE is similar to LOCAL, except that it prevents MIM0061 messages from being issued on other systems.

Important! Integrity exposures can occur when you specify this operand. For more information about possible integrity exposures when stopping CA MIM, see the CA MIM Programming Guide.

GLOBAL

(Optional) Stops CA MIM on all systems without producing an ABEND or an ABEND dump.

We recommend that you specify the GLOBAL operand when you are stopping CA MIM in multiple-system or multiple-image environments, except in an emergency.

LOCAL

(Optional). Stops CA MIM on the local system immediately. No ABEND dump is requested. CA MIM stops with an ABEND code U1222 if SETOPTION MIM LOCALSTOP=ABEND.

Important: Integrity exposures can occur when you specify this operand. For more information about possible integrity exposures when stopping CA MIM, see the CA MIM Programming Guide.

Default: The value specified on the SETOPTION SHUTDOWN command.

Usage Notes: SHUTDOWN Command

• The SHUTDOWN command must be issued from a service virtual machine console or from a CMS user ID having OPER authorization.
• You can use the SETOPTION MIM SHUTDOWN command to set the default value for how you want to stop CA MIM.

Examples: SHUTDOWN Command

• To stop CA MIM on all systems (if the SETOPTION SHUTDOWN operand was set to GLOBAL), issue this command:

  SHUTDOWN
  

• To stop CA MIM on the local system only and simultaneously free it from the MIMplex, issue this command:

  SHUTDOWN FREE