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

VARSIZE()

Use the VARSIZE() function to set and return the maximum length of a REXX variable string. Typically, REXX variable strings have a maximum allowed length of 4096 bytes. Use VARSIZE() to specify a larger value. This specification applies only to the IMOD in which you set it. The value is not propagated across the CALL/RETURN interface.

Important! Be careful when specifying a larger value. Error conditions such as unplanned loops can temporarily deplete storage.

Syntax

The VARSIZE() function has this syntax:

cursize = VARSIZE([value])

Arguments

The VARSIZE() function takes these arguments.

cursize

Current or new size limit (or error text).

Value

Maximum length to be permitted for a REXX variable string.

Default: The current value is returned and left unchanged.

Return Codes

The VARSIZE() function produces these return codes:

101

ARG 1 MISSING OR INVALID

Example

varsize() == '32767'   /* Current maximum variable length  */