CA-GSS Statements and Commands › GSS Extended Functions › IO Functions › Number, String, and Variable Functions › System Information Functions › SETRC()

SETRC()

CA-GSS extended functions set the RC special variable upon their completion. This permits an IMOD to test for correct execution in a straightforward manner, either by checking for RC = 0 or by trapping failures with SIGNAL ON conditions. SETRC() permits an IMOD that is called as an external subroutine or function to set the RC special variable in the calling IMOD.

Syntax

The SETRC() function has this syntax:

oldval = SETRC([newval])

Arguments

The SETRC() function takes these arguments:

Usage Notes

• The value of RC in the currently executing IMOD will not be affected.
• If SETRC() is not used, RC will be set to zero upon completion of the external routine.
• SETRC() has no effect upon the value of RC upon completion of an internal routine.
• SETRC() should be issued immediately before RETURN or EXIT. If you call another IMOD after you issue a SETRC() the value will be canceled.

Example

#desc IMOD to check for palindromes 
#callable
   parse upper value arg(1) arg1
   parse upper value arg(2) arg2
   arg2 = reverse(arg2)
   if arg1 = arg2 then return 'PALINDROME'
   x = stern(200)
   return 'NOT PALINDROME'