Micro Focus Enterprise Developer 2.3 Update 2 for Eclipse > Programming > Mainframe Programming > PL/I Programming > CodeWatch User's Guide > CodeWatch Commands > Ncatch

Ncatch

Use

Prevents process control from returning to the debugger when the given signal or ON-unit is generated. Also turns off notification for a specified ON-unit.

Command Syntax

NCATCH signal

NCATCH {ON-unit}

where:

signal: Can be either a signal name mnemonic (such as SIGALRM, SIGINT, and so on) or the signal number corresponding to that signal. Signal names may be specified in either uppercase or lowercase

ON-unit: The name of an ON-unit at which you want stop notification whenever the debugger detects a condition that triggers the ON-unit.

Description

The NCATCH command prevents process control from returning to the debugger when the given signal or ON-unit is generated. The child (user) process continues without interruption, as if the given signal had been generated. This implies that user-defined handlers are executed.

Example

In the following example, the process control will not return from the child process to the debugger when a SIGALRM is generated.

CodeWatch> NCATCH SIGALRM
Changing SIGALRM to no longer be caught.

As a result, NCATCH allows the child process to continue uninterrupted when a SIGALRM is generated. If the user process has its own signal handler for a SIGALRM, that signal handler will be executed.

This example uses NCATCH to stop catching an ENDFILE ON-unit.

CodeWatch> NCATCH ENDFILE
Changing ENDFILE to no longer be caught.