Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

PARAMETER

Example

HELP RETURN — VMS 5.4

   Terminates a GOSUB subroutine procedure and returns control to the
   command following the calling GOSUB command.

   Format

     RETURN  [status-code]

Additional information available:

PARAMETER

Example

PARAMETER

status-code
   Defines a longword (integer) value or expression equivalent to
   an integer value that gives the exit status of the subroutine by
   defining a numeric value for the reserved global symbol $STATUS.
   The value can be tested by the next outer command level. The low
   order 3 bits of the longword integer value change the value of
   the reserved global symbol $SEVERITY. If you specify a status
   code, DCL interprets the code as a condition code. Note that even
   numeric values produce warning, error, and fatal error messages,
   and that odd numeric values produce either no message or a success
   or informational message.

   If you do not specify a status code, the current value of $STATUS
   is saved. When control returns to the outer command level, $STATUS
   contains the status of the most recently executed command or
   program.

Example

   $ SHOW TIME
     19-APR-1990 14:25:42
   $ GOSUB SYMBOL
   $ EXIT
   $ SYMBOL:
   $     SHOW SYMBOL RED
         RED = "SET DEFAULT [JONES.DCL]"
   $     RETURN 1

     The GOSUB command transfers control to the subroutine labeled
     SYMBOL. After the subroutine is executed, the RETURN command
     transfers control back to the command following the calling
     GOSUB statement, giving $STATUS and $SEVERITY a value of 1. The
     procedure then exits.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026