Persistent Global Variables Interface › $CAGLBL OPT=LOAD

$CAGLBL OPT=LOAD

Create a persistent global variable.

&CALL PROC=$CAGLBL PARMS=(OPT=LOAD
                   [,NAME={gname | (gname,….)}]
                   [,DEBUG={N | Y}])

Note: Optional parameters that are not required are ignored.

Operands:

OPT=LOAD

Loads persistent global variables. If NAME= is omitted or not specified, all persistent global variables in the external repository are loaded with their corresponding values.

Note: A message is issued to the log listing all GLBLs loaded and the values assigned to them.

If NAME= is specified, specified persistent global variables are loaded. A message is issued to the log listing all global variables loaded and the values assigned to them.

Note: If no persistent variables are found, a message is issued to the log.

NAME=gname

(Optional) Specifies the persistent global variable to load. Do not include the global variable prefix (&&000).

Note: No wildcards are supported.

DEBUG={N|Y}

When set to Y, initiates internal debugging of the $CAGLBL procedure. Should only be used with assistance from CA Support.

Return Codes:

RETCODE

0 - Successful execution

8 - Unsuccessful execution

Examples:

&CALL PROC=$CAGLBL PARMS=(OPT=LOAD)

&CALL PROC=$CAGLBL PARMS=(OPT=LOAD,NAME=MYVAR)