IMS Version 9

CANCEL/FORCE ODBA

The CANCEL and FORCE commands are used to terminate an ODBA application address space with an active connection to an IMS subsystem.

Format

Read syntax diagramSkip visual syntax diagram>>-CANCEL jobname----------------------------------------------><

Usage

The CANCEL jobname command is used to terminate an ODBA application address space with an active connection to an IMS subsystem. In this command, jobname is the ODBA application address space.

If there are no active threads under this connection to IMS, allow the CANCEL command to be processed by z/OS. If there appear to be active threads (IDTTHDCT is greater than zero), the CANCEL command is rejected and message DFS08051 is issued.

Once the CANCEL command has been issued, no additional threads will be allowed to schedule from the target address space until the connection to IMS has been successfully terminated and re-initialized.

The CANCEL is rejected to protect the IMS control region from ABENDU0113 or other related abends. If it is invalid for threads to be active at this time, gather documentation to determine the reason for the active thread(s).

Format

Read syntax diagramSkip visual syntax diagram>>-FORCE jobname-----------------------------------------------><

Usage

The FORCE jobname command is used to terminate an ODBA application address space with an active connection to an IMS subsystem if the CANCEL command was rejected. In this command, jobname is the ODBA application address space.

Recommendation: Attempt the CANCEL command prior to attempting the FORCE command.

If this is the first time that FORCE has been issued against the current iteration of the ODBA application address space, DFS1S100 will change the FORCE to a CANCEL and allow z/OS to process the CANCEL command.

If the CANCEL command was rejected and a prior FORCE command was issued against the current iteration of the ODBA application address space and was not successful, issue a second FORCE command to allow z/OS to process the second FORCE command.

Use the FORCE command with caution. By allowing z/OS to CANCEL the address space, it is possible that the IMS control region may terminate abnormally depending on the actual state of the active thread(s). Resolve the outstanding active threads prior to issuing the FORCE command.

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