The RETURN command terminates the GOSUB subroutine and returns control
back to the command following the calling GOSUB command.
When a DCL command, user program, or command procedure completes
execution, the command interpreter saves the condition code value in
the global symbol $STATUS. The system maintains this value in
hexadecimal. If a RETURN command does not explicitly set a value for
$STATUS, the command interpreter uses the current value of $STATUS to
determine the error status.
The low-order 3 bits of the status value contained in $STATUS represent
the severity of the condition. The reserved global symbol $SEVERITY
contains this portion of the condition code. Severity values range from
0 to 4, as shown in the following table:
Value |
Severity |
0
|
Warning
|
1
|
Success
|
2
|
Error
|
3
|
Information
|
4
|
Severe (fatal) error
|
Note that the success and information codes have odd numeric values,
and that warning and error codes have even numeric values.