TP-BACKOUT

ABEND the program. In IMS programs, this call invokes the IMS dynamic backout feature, canceling all database updates and messages sent since running the program or since receipt of the most recent input message.
Restriction: This topic applies only when the AppMaster Builder AddPack has been installed, and applies only to Windows platforms.

Targets:

  • CICS
  • IMS DC

CICS

Syntax: 
TP-BACKOUT [ABORT[(name)]|NOABORT]
Parameters:

ABORT(name)

Invoke CICS ABEND to terminate task. Name specifies a formatted dump of main storage; can be literal or COBOL data name (maximum 4 characters).

NOABORT

Nonfunctional--allowed for compatibility with IMS.

Examples:
The following three examples execute identically. Each terminates a task abnormally by invoking a CICS ABEND code. 
TP-BACKOUT
TP-BACKOUT ABORT
TP-BACKOUT NOABORT
Specify a recovery option and code name to identify a main storage dump related to the task. 
TP-BACKOUT ABORT('PGM1')

IMS DC

Syntax: 
TP-BACKOUT [ABORT|NOABORT] [CONT|NOCONT]
General Rules:
  1. Use ABORT if the detected error prevents other messages from processing successfully.
  2. Use NOABORT if the detected error is specific to the processing message.
  3. To send a message and use TP-BACKOUT, use the EXPRESS keyword with either SEND or MSG-SW.
  4. Coding NOABORT calls an IMS ROLB with the current input message discarded; ABORT calls an IMS ROLL.
  5. The IMS option of issuing a ROLB with an IOAREA to reread the current input message is not supported by TP-BACKOUT. For further information on ROLL and ROLB, see the appropriate IMS manuals.
Parameters:

ABORT

Cancel program and do not reschedule.

NOABORT

Default. Return next input message for processing.

CONT

Default. Set the TP-GOBACK flag to FALSE.

NOCONT

Set the TP-GOBACK flag to TRUE.

Examples:
The following three examples execute identically. Each terminates a task abnormally by invoking a CICS ABEND code. 
TP-BACKOUT
TP-BACKOUT ABORT
TP-BACKOUT NOABORT
Specify a recovery option and code name to identify a main storage dump related to the task. 
TP-BACKOUT ABORT('PGM1')
Parent topic: Data Communication Calls