RETURN [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation
MPE/iX Commands Reference Manual Volume I
RETURN
Causes execution to return from the current user command (UDC or command
file) to the calling environment. (Native Mode)
Syntax
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.
Related Information
Commands ESCAPE
Manuals None
MPE/iX 5.0 Documentation