Installation and Maintenance Utilities › ECAIGLO - Processing Panel Manager Variables

ECAIGLO - Processing Panel Manager Variables

The ECAIGLO utility enables easy management of variables for the CA ACF2 for z/VM full-screen facility.

• You can save them in common storage for access by more than one panel
• You can store them in CMS files for later use by panels or other programs
• You can manipulate them by their full names or generically by stem when they have compound names.

Running ECAIGLO

The syntax for running ECAIGLO is:

ECAIGLO subcommand, [fn [ft [fm] ]], [vn], ...

subcommand

Is the function to perform. Valid subcommands are listed below:

GET

Reads the file specified in the second argument, searches for the variable names specified by the third and succeeding arguments, and sets the variables to the values found in the file.

PUT

Retrieves the current values for the specified variables and writes all variables for the specified file back to disk. Refreshes only the variables specified. It does not refresh the other variables active for the file and writes them to disk with whatever values they had at the time of the last PUT request.

DEL

Deletes all occurrences of the specified variable names from the specified file and from the instorage copy of the file.

SET

Retrieves the current values of the specified variables and updates the values it maintains in its own buffers. Does not update the file on disk.

You can use the SET and GET subcommands to manipulate variables that never reside on disk. They are only maintained in storage for the duration of the session.

DROP

Deletes the specified variables from the instorage copy of the file only. Does not update the file on disk. Does not drop the variables in REXX terms. They are still available to the current REXX program.

PURGE

Deletes all variables from the instorage copy of the file only. Does not update the file on disk.

fn

Specifies the filename where the variables are stored. If you do not specify fn, the filename defaults to CAI.

ft

Specifies the filetype where the variables are stored. If you do not specify ft, the filetype defaults to ECAIGLO.

fm

Specifies the filemode where the variables are stored. If you do not specify fm, the filemode defaults to * for existing files and A for new variable files.

vn

Specifies a variable name to process. You can specify up to eight variable names, one per argument for arguments three to ten. You can specify variable names as follows:

• As a specific variable name. (CAI.PROD.1 acts only on that variable.)
• As a stem. (CAI.PROD. acts on all variables that begin that stem.)
• You can specify * to reference all variables associated with a particular file. On a GET, DROP, or DEL request, acts on all variables. On a PUT or SET request, stores all known REXX variables.
• If you omit variable names on a PUT request, saves the file without updating variable values. Omitting variable names on any other request is an effective NOP.
• With the PURGE function, ALL is the only valid specification at this time.

Examples

Get variable CAI.TEST.1 from file CAI GLOBAL A.

CALL ECAIGLO 'GET','CAI GLOBALV A','CAI.TEST.1'

Save all current REXX variables in file CAI GLOBAL A.

CALL ECAIGLO 'PUT','CAI GLOBALV A'

Delete all variables beginning with CAI.TEST. from file CAI GLOBAL A.

CALL ECAIGLO 'DEL','CAI GLOBALV A','CAI.TEST.'

Save all variables beginning with CAI.TEST. into storage.

CALL ECAIGLO 'SET','CAI GLOBALV A','CAI.TEST.'

Delete all variables beginning with CAI.TEST. from storage.

CALL ECAIGLO 'DROP','CAI GLOBALV A','CAI.TEST.'

Delete all variables in file CAI GLOBALV A from disk and storage.

CALL ECAIGLO 'PURGE','CAI GLOBALV A','ALL'