(MIM) SHUTDOWN Command-Stop CA MIM

The SHUTDOWN command lets you stop .
cmfzs125
The SHUTDOWN command lets you stop
CA MIM for z/OS
.
Note:
Data integrity exposures occur when the
CA MIM for z/OS
address space is terminated on an active operating system.
Scope:
Local or Global
This command has the following format:
SHUTDOWN[ {DUMP |             FORCE |              FREE |             GLOBAL |             LOCAL |              RESERVE |              WAIT}]
  • DUMP
    (Optional) Stops
    CA MIM for z/OS
    on the local system with a U1122 user ABEND code.
    CA MIM for z/OS
    also requests an ABEND dump.
    Warning!
    Integrity exposures can occur when you specify this operand. For more information about possible integrity exposures when stopping
    CA MIM for z/OS
    , see CA MIM Programming.
  • FORCE
    (Optional) Stops
    CA MIM for z/OS
    when the communication method is CTC or XCF, 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. If the SHUTDOWN FORCE command is entered before the MIM0468W message has been issued, MIM ignores the FORCE operand and uses whatever is coded or defaulted on the SET MIM SHUTDOWN option.
    WARNING!
    Integrity exposures can occur when you specify this operand.
  • FREE
    (Optional) Shuts down
    CA MIM for z/OS
    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 for z/OS
    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.
    Warning!
    Integrity exposures can occur when you specify this operand. For more information about possible integrity exposures when stopping
    CA MIM for z/OS
    , see CA MIM Programming.
  • GLOBAL
    Stops
    CA MIM for z/OS
    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 for z/OS
    in multiple-system or multiple-image environments, except in an emergency.
    This value stops
    CA MIM for z/OS
    without allowing integrity exposures to occur.
    CA MIM for z/OS
     stops only after all RESERVE requests that were converted have been released through DEQ requests.
  • LOCAL
    (Optional) Stops
    CA MIM for z/OS
    on the local system immediately. No ABEND dump is requested.
    CA MIM for z/OS
    stops with an ABEND code U1222 if SETOPTION MIM LOCALSTOP=ABEND.
    Integrity exposures can occur when you specify this operand. For more information about possible integrity exposures when stopping
    CA MIM for z/OS
    , see CA MIM Programming.
  • RESERVE
    (Optional) Stops
    CA MIM for z/OS
    on the local system with a U1223 ABEND if SETOPTION MIM LOCALSTOP=ABEND. On other systems, GDIF stops eliminating hardware reserves and stops propagating RESERVE requests as global ENQ requests. GDIF retains hardware reserves unconditionally until you identify this system as temporarily inactive (through the FREE command) or until
    CA MIM for z/OS
    is restarted on this system. You can use the abbreviation RSV for this operand.
    • An integrity exposure can occur if a converted RESERVE request issued from this system currently is involved in a cross-system conflict.
    • Integrity exposures can occur when you specify this operand.
    • For more information about possible integrity exposures when stopping
      CA MIM for z/OS
      , see CA MIM Programming.
  • WAIT
    Sets the status of the local system to a freed state (as if a 'FREE' sysid was issued on an external system), then places the system into a disabled wait state code ‘FFF’. Unlike SHUTDOWN FREE, WAIT ensures complete integrity, because the local system does not continue processing. No abend dump is requested. If WAITSTATE=NEVER, SHUTDOWN WAIT command is equivalent to SHUTDOWN FREE.
    This option is required when MIMINIT keyword WAITSTATE set to anything other than NEVER.
Usage Notes: SHUTDOWN Command
  • The SHUTDOWN command must be issued from a console or TSO session. You cannot issue this command from the MIMPARMS data set.
  • You must be authorized to issue system control commands to issue the SHUTDOWN command. TSO users generally are not authorized to issue system control commands.
  • You can use the SETOPTION MIM SHUTDOWN command to set the default value for how you want to stop
    CA MIM for z/OS
    .
  • You also can use the z/OS STOP command to stop
    CA MIM for z/OS
    .
Examples: SHUTDOWN Command
  • To stop
    CA MIM for z/OS
    on all systems (if the SETOPTION SHUTDOWN operand was set to GLOBAL), issue this command:
    SHUTDOWN
  • To stop
    CA MIM for z/OS
    on the local system only and simultaneously free it from the MIMplex, issue this command:
    SHUTDOWN FREE