ESCAPE


ESCAPE

     Allows the CI programmer to simulate all aspects of CI error handling.

SYNTAX

     ESCAPE [ [CIERR=] errnum]


PARAMETERS

ERRNUM              Sets the CIERROR to the absolute value of errnum
and HPCIERR is set to errnum.



OPERATION

     The ESCAPE command causes control to leave all user commands
(regardless of nesting levels) and return to the CI. Batch jobs
terminate and sessions issue the prompt.

If no CONTINUE is active, ESCAPE causes the CI to act as it would
for any error. For sessions the user command environment is
cleared and the prompt is displayed. For jobs the process is
terminated.

If CONTINUE is active, then ESCAPE causes the CI to execute
the second command after the CONTINUE. In the following example,
the CI will execute cmd2 after the ESCAPE:

cmd1
CONTINUE
udc1
ucmdA
ucmdB
ESCAPE
cmd2

This command may be issued from a session, job, program, or in
BREAK. Pressing [BREAK] has no effect on this command.


EXAMPLE(S)

    errclear
continue
run database
if hpcierr < 0 then
echo database warning ![abs(hpfserr)] detected, proceeding...
elseif hpcierr > 0 then
echo FATAL database error !hpcierr detected, halting...
escape

ADDITIONAL INFORMATION

Commands: ERRCLEAR

Manuals : Command Interpreter Access and Variables Programmer's Guide
(32650-90011)