Error handling in a batch environment

IMS Administration Tool takes specific action for the different categories of errors that can occur in a batch environment.

When IMS Administration Tool command driver runs as a batch job (IMS BMP, IMS DL/I batch, or standard z/OS® batch), you might encounter errors that fall into one of the following categories:

• General

  A general error occurs when IMS Administration Tool fails to edit a command.

• Routing

  A routing error occurs when a command fails due to routing problem. This error is viewed by IMS Administration Tool as an IMS region being unavailable.

• DFS0488I

  The DFS04881 error is issued when a command that changes the state of a database/AREA fails to perform the required action.

  This error is typically caused by IMS Administration Tool not receiving an acceptable return code on a DFS0488I/ATY0488I message.

  You can specify whether or not IMS Administration Tool treats a DFS3466I/ATY3466I (database/AREA not defined) as an error condition in the global record by using the ISPF dialog, or by using the ERR3466 parameter in the ATYOPTS ddname input statement.

• DBRC

  The DBRC error occurs if a subsystem record in the RECON has the database/AREA open with update intent after a /DBD or /DBR command.

  Note: IMS Administration Tool DBRC verification does not work in a DBRC environment that utilizes the RECON loss notification option unless user exit DSPSCIX0 provides the name of the XCF group.

IMS Administration Tool allows each error category to be handled by the following actions:

• Abend

  Action: Terminate the batch job with the specified abend code.

• Return code

  Action: Terminate the batch job with the specified return code.

• WTOR

  Action: Issue a WTOR and allow operator intervention to determine course of action.

• Ignore

  Action: Continue processing the next command as if no error had occurred.

  (For DBRC, this option is specified as DBRC=NODBRC.)