RETURN

Parameters

None

Operation Notes

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.

Use

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

Example

The following example uses the RETURN command to exit from a command file prematurely based on 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 causes a slightly different output because the error number precedes the message.