Handles an abnormal termination exit.

Sintaxe

Nota:

LABEL not supported for C, C++ or PL/I programs.

Descrição:

HANDLE ABEND handles an abnormal termination exit.
This command is used to activate, cancel, or reactivate an exit for abnormal termination processing.

For COBOL programs only, you can suspend (and later restore) the effect of HANDLE ABEND by means of the PUSH HANDLE and POP HANDLE commands.

The HANDLE ABEND command cannot intercept all abends.
Some abends such as any that result from a severe CICS internal error cannot be handled; and some abends cause the application server that is running the application program to terminate without giving the program a chance to handle the abend.

For COBOL programs, when the label that is specified in a HANDLE ABEND LABEL command receives control, control is transferred to it with all storage intact.

Opções:

LABEL(label)
• Specifies the program label of an abnormal termination exit routine that is to receive control if the task terminates abnormally.
• This option cannot be used for C, C++ or PL/I application programs.

PROGRAM(name)
• Specifies the name of an abnormal termination exit program that is to receive control if the task terminates abnormally.
• The name can consist of up to eight alphanumeric characters, and must be defined in the Program Definitions (PD) as a local program.
• Any COMMAREA that the calling program is using is passed to the exit program.
• This option can be used in C or C++ programs, but the effect of the command cannot be suspended (and restored) by means of the PUSH HANDLE and POP HANDLE commands.

CANCEL
• Specifies that a previously established exit at the logical level of the application program that is in control is to be canceled.

RESET
• Specifies that an exit that was canceled by a HANDLE ABEND CANCEL command, or by CICS, is to be reactivated.
• This option is typically used by an abnormal termination exit routine.
• If a program issues a HANDLE ABEND CANCEL, then XCTLs to another program that issues a HANDLE ABEND RESET, CICS restores the abend handler, if the abend handler is a program.

Condições:

NOTAUTH
• Occurs if a resource security check has failed on PROGRAM(name).
• Ação pré-definida: Terminates the task abnormally.

PGMIDERR
• Occurs for the following conditions:
  • The program has no entry in the PD.
  • The program is defined as remote.
  • The program is disabled.
• Ação pré-definida: Terminates the task abnormally.

Informações relacionadas:

• LINK
• POP HANDLE
• PUSH HANDLE
• RETURN
• XCTL
• TXSeries for Multiplatforms Administration Reference