ESCAPE

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index

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)

Back to Main Index