5. Global Variables

You can use CTMAPI to set variables in the IOA Variable Database.

• The SET command inserts or updates a global variable in the IOA Variable Database.
• The CKP (CHECKPOINT) command writes all variables which have been SET in the IOA Variable Database to disk.
• The SETCKP command combines the action of both the SET and the CKP commands.

Note: starting with Version 9, the global variables in the IOA Variable Database (IOAVAR) are being check-pointed automatically by the CMEM or Control-O monitor.

For compatibility reasons, the CKP and SETCKP commands are still valid but the actual check-pointing is done by the monitor on its next interval.

The resolve option is available only when CTMAPI is called in Conversation mode.

The full syntax for this CTMAPI service is

GLOBAL {SET | SETCKP | CHECKPOINT | CKP}

{PRODUCT=x APPL=xxx GROUP=xxx MEMBER=xxx VAR=%%\xxx VALUE=xxx}

Note: Separate the parameters in GLOBAL commands with blanks, not commas.

If the action to be performed is SET or SETCKP, the name of the variable must be supplied. The keyword parameters are used to define the variable name.

For more information on the actions and components of the variable name, see the IOA administration chapter in the INCONTROL for z/OS Administrator Guide.