You can use the following z/OS commands to control an IMS region.
>>-F jobname,DUMP----------------------------------------------><
The MODIFY (F) jobname,DUMP command forces a termination of IMS with an offline dump.
For DBCTL, the following are abended, but are not rolled back until the following /ERESTART command:
Entry z/OS SC:
F jobname,DUMP
Response z/OS SC:
DFS628I ABNORMAL TERMINATION SCHEDULED DFS629I IMS STM TCB ABEND - IMS 0020
>>-F jobname,DUMPxxx-------------------------------------------><
The MODIFY (F) jobname,DUMPxxxx command causes one or more attached external subsystem connections to be terminated with a dump. If xxxx is specified as ESS, the parent external subsystem task and all external subsystem subtasks are terminated. If xxxx is a specific external subsystem name, only that external subsystem is terminated. The subsystem specified must be defined in the IMS external subsystem PROCLIB member.
Entry z/OS SC:
F jobname,DUMPname
Response z/OS SC:
DFS628I ABNORMAL TERMINATION SCHEDULED DFS629I IMS ESI TCB DUMP - IMS 0020 IES DFS3611I EXTERNAL SUBSYSTEM name CONNECTION TERMINATED
Entry z/OS SC:
F jobname,DUMPESS
Response z/OS SC:
DFS628I ABNORMAL TERMINATION SCHEDULED DFS629I IMS ESS TCB DUMP - IMS 0020 DFS629I IMS ESS TCB DUMP - IMS 4095 IES DFS3611I EXTERNAL SUBSYSTEM name CONNECTION TERMINATED
>>-F jobname,FORCExxxx-----------------------------------------><
The MODIFY (F) jobname,FORCExxxx command causes one or more attached external subsystem connections to be terminated without a dump. If xxxx is specified as ESS, the parent external subsystem task and all external subsystem subtasks are terminated. If xxxx is a specific external subsystem name, only that external subsystem is terminated. The subsystem specified must be defined in the IMS external subsystem PROCLIB member.
The FORCE option is not applicable to any other IMS task, for example, to the control task. IMS does not communicate with the external subsystem termination exits, for example, terminate subsystem exits and terminate identify exits.
The reason IMS does not communicate is to allow the installation to break the IMS-to-other-subsystem connection in the event of an error (such as a WAIT STATE) in the external subsystem. If IMS were to invoke one of the exits, as it does with the STOP/DUMP options, the exit can once again start a WAIT STATE, and not allow the termination of that subsystem connection.
Use the FORCE option when either STOP or DUMP fails to break the subsystem connection.
Entry z/OS SC:
F jobname,FORCEname
Response z/OS SC:
DFS628I ABNORMAL TERMINATION SCHEDULED DFS629I IMS ESI TCB DUMP - IMS 0020 IES DFS3611I EXTERNAL SUBSYSTEM name CONNECTION TERMINATED
Entry z/OS SC:
F jobname,FORCEESS
Response z/OS SC:
DFS628I ABNORMAL TERMINATION SCHEDULED DFS629I IMS ESS TCB DUMP - IMS 0020 DFS629I IMS ESS TCB DUMP - IMS 4095 IES DFS3611I EXTERNAL SUBSYSTEM name CONNECTION TERMINATED
>>-F jobname,RECONNECT-----------------------------------------><
The MODIFY (F) jobname,RECONNECT command causes the IMS system on which it is entered to be reconnected to a restarted IRLM.
Jobname is the job name or procedure name for the IMS control region. When this command is successfully completed, a message indicating that the IRLM has been reconnected is sent to both the IMS master terminal operator and the z/OS console operator. Then the IMS MTO can start any Fast Path DEDB areas that were involved in block-level sharing at the time of the IRLM failure.
In this example, two IMS subsystems are connected to the same IRLM when it terminates.
z/OS SYSTEM SC RECEIVES:
DXR121I KRLM212 END-OF-TASK CLEAN-UP SUCCESSFUL - HI-CSA 410K - HI-ACCT-CSA 0K
IMS 1 MT RECEIVES:
DFS2500I IMSA DATABASE dbname SUCCESSFULLY DEALLOCATED
IMS 2 MT RECEIVES:
DFS2500I IMSB DATABASE dbname SUCCESSFULLY DEALLOCATED
z/OS SYSTEM SC:
S KRLM1
z/OS SYSTEM SC RECEIVES:
DXR180I KRLM212 AUTOMATIC RESTART MANAGER IS NOT ENABLED OR DXR172I KRLM212 armelementname ARM READY COMPLETED DXR117I KRLM212 INITIALIZATION COMPLETE
z/OS SYSTEM SC:
F jobname,RECONNECT
IMS 1 MT AND z/OS SYSTEM SC RECEIVE:
DFS626I KRLM RECONNECT COMMAND SUCCESSFUL. IMSA
z/OS SYSTEM SC:
F jobname,RECONNECT
IMS 1 MT AND z/OS SYSTEM SC RECEIVE:
DFS626I KRLM RECONNECT COMMAND SUCCESSFUL. IMSB
IMS MT:
/START AREA areaname
Explanation: The IRLM has abnormally terminated. When the IRLM has been successfully restarted, the z/OS operator modifies the IMSs to reconnect to the restarted IRLM. The areas can then be restarted using the /START AREA command.
>>-F jobname,RECONNSTR-----------------------------------------><
Use this command to cause the IMS subsystem on which you enter it to reconnect to IRLM, OSAM, and VSAM coupling facility structures.
jobname is the job name or procedure name for the IMS control region.
Entry z/OS SC:
F jobname,RECONNSTR
Explanation: If the connection to IRLM, OSAM, or VSAM structures has abnormally terminated, usually IMS automatically reconnects to these structures. If IMS does not reconnect to the structures, the operator can use this command to ensure IMS reconnects to them.
>>-F jobname,STOP----------------------------------------------><
Active threads, BMPs, and DEDB utilities are abended, but not rolled back until the following /ERESTART command.
Normally, IMS is terminated with an IMS /CHECKPOINT shutdown command. Whenever it becomes necessary to force termination of IMS, the z/OS MODIFY command should be used. When MODIFY is used, a dump of the IMS control region can be requested. (Consult the appropriate z/OS operator's guide for specific MODIFY formats.)
The MODIFY (F) jobname,STOP command forces a termination of IMS without a dump.
Entry z/OS SC:
F jobname,STOP
Response z/OS SC:
DFS628I ABNORMAL TERMINATION SCHEDULED DFS629I IMS STM TCB ABEND - IMS 0020
>>-F jobname,STOPxxx-------------------------------------------><
The MODIFY (F) jobname,STOPxxxx command causes one or more attached external subsystem connections to be terminated without a dump. If xxxx is specified as ESS, the parent external subsystem task and all external subsystem subtasks are terminated. If xxxx is a specific external subsystem name, only that external subsystem is terminated. The subsystem specified must be defined in the IMS external subsystem PROCLIB member.
Entry z/OS SC:
F jobname,STOPname
Response z/OS SC:
DFS628I ABNORMAL TERMINATION SCHEDULED DFS629I IMS ESI TCB DUMP - IMS 0020 IES DFS3611I EXTERNAL SUBSYSTEM name CONNECTION TERMINATED
Entry z/OS SC:
F jobname,STOPESS
Response z/OS SC:
DFS628I ABNORMAL TERMINATION SCHEDULED DFS629I IMS ESS TCB DUMP - IMS 0020 DFS629I IMS ESS TCB DUMP - IMS 4095 IES DFS3611I EXTERNAL SUBSYSTEM name CONNECTION TERMINATED