SETGRC command

Summary

Privileges

Any user

Function

Sets a global variable return code according to the presence or absence of counting errors in the execution of the preceding command

Syntax

SETGRC [rcname] [errstringname]

Where:

rcname	is a global variable that holds the return code.
errstringname	is a global variable that holds the string of the error message associated with the counting error. If multiple messages are issued as a result of the cascade effect of the initial error, the initial error message is retrieved.

Example

In the following example, SETGRC is followed by IF commands that test the success or failure of SETGRC and include different procedures depending on the value of the SETGTRC return code variable:

COPY PROC ALL TO FILEA SETGRC XRC XMSG IF XRC = 0, YES.PROC IF XRC = 1, NO.PROC

If the value of XRC is 1, the procedure NO.PROC, which does error processing and other recovery work, is included:

PROC NO.PROC BEGIN PRINT 'COPY PROC FAILED - ' WITH $GETG('XMSG') . . . error processing work . . . END END PROCEDURE

If the value of XRC is 0, the procedure YES.PROC is included:

PROC YES.PROC BEGIN PRINT 'PROCEDURES COPIED SUCCESSFULLY' . . . continue doing next logical work . . . END END PROCEDURE

Similarly, you can follow SETGRC with a request that executes different User Language statements depending on the value in the global variable:

COPY PROC ALL TO FILEA SETGRC YRC YMSG BEGIN IF $GETG('YRC') THEN PRINT 'COPY PROC FAILED - ' WITH $GETG('YMSG') . . . other error processing statements . . . ELSE PRINT 'COPY PROC RAN SUCCESSFULLY - PROCESSING CONTINUED' END IF

Usage notes

Use SETGRC to test for the success or failure of Model 204 command execution when you are working in User Language.

If there are no counting errors in the execution of the preceding command, SETGRC sets a global variable to 0. If there are counting errors, SETGRC sets a global variable to 1.