IMS Version 9

MODIFY IMS

You can use the following z/OS commands to control an IMS region.

F jobname,DUMP

Format

Read syntax diagramSkip visual syntax diagram>>-F jobname,DUMP----------------------------------------------><

Usage

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:

Example

Entry z/OS SC:

  F jobname,DUMP

Response z/OS SC:

  DFS628I ABNORMAL TERMINATION SCHEDULED
  DFS629I IMS STM TCB ABEND - IMS 0020

F jobname,DUMPxxxx

Format

Read syntax diagramSkip visual syntax diagram>>-F jobname,DUMPxxx-------------------------------------------><

Usage

Note:
"External subsystem" means a non-CCTL subsystem.

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.

Examples

Example 1 for F jobname,DUMPxxxx

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

Example 2 for F jobname,STOPxxxx

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

Format

Read syntax diagramSkip visual syntax diagram>>-F jobname,FORCExxxx-----------------------------------------><

Usage

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.

Examples

Example 1 for F jobname,FORCExxxx

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

Example 2 for F jobname,FORCExxxx

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

Format

Read syntax diagramSkip visual syntax diagram>>-F jobname,RECONNECT-----------------------------------------><

Usage

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.

Example

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

Format

Read syntax diagramSkip visual syntax diagram>>-F jobname,RECONNSTR-----------------------------------------><

Usage

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.

Example

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

Format

Read syntax diagramSkip visual syntax diagram>>-F jobname,STOP----------------------------------------------><

Usage

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.

Example

Entry z/OS SC:

  F jobname,STOP

Response z/OS SC:

  DFS628I ABNORMAL TERMINATION SCHEDULED
  DFS629I IMS STM TCB ABEND - IMS 0020

F jobname,STOPxxxx

Format

Read syntax diagramSkip visual syntax diagram>>-F jobname,STOPxxx-------------------------------------------><

Usage

Note:
All references to external subsystems refer to non-CCTL subsystems.

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.

Examples

Example 1 for F jobname,STOPxxxx

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

Example 2 for F jobname,STOPxxxx

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

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004