RETURN

RETURN

     Causes execution to return from the current User Command
     (UDC or command file) to the calling environment.

SYNTAX

     RETURN

PARAMETERS

None

OPERATION

     This command terminates the execution of the currently
     executing User Command.  Control resumes in the calling
     environment at the command line following the User Command
     in which RETURN was embedded.  Invoking RETURN at the CI
     colon (:) prompt has no effect.

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

EXAMPLE(S)

The following example uses the RETURN command to exit from a command
file prematurely by testing for a parameter error condition.

PARM ERROR_NUM
COMMENT Display CIERR message associated with "error_num"
IF NOT NUMERIC (!ERROR_NUM) THEN
     ECHO Expected a number.
     RETURN

ENDIF

SETVAR CIERROR ABS(!ERROR_NUM)
ECHO !HPCIERRMSG

The last two lines above can be combined as:

ECHO ![SETVAR(CIERROR,ABS(!ERROR_NUM))] !HPCIERRMSG

This line will cause a slightly different output, because the error
number will precede the message.