SHARED variables usage and pools

SHARED variables are a pool of GLOBAL variables maintained in CSA.

Variables in this pool are created in the following ways:

Related topic

Variables-in-REXX-EXECs

  • By a user who uses the IMFEXEC VPUT statement in an EXEC
REXX EXEC example
N=1                      /* creates a TSO variable in TSO pool*/
"IMFEXEC VPUT N SHARED"  /* IMFEXEC VPUT cmd places variable in SHARED pool*/


CLIST example
SET &N=1               /* SET command creates a TSO variable in TSO pool*/
IMFEXEC VPUT N SHARED  /* IMFEXEC VPUT cmd places variable in SHARED pool*/

These examples store variables from the TSO pool to the SHARED pool.

  • Supplied by BMC AMI Ops Automation

    BMC AMI OpsA supplies a set of read-only SHARED variables that begin with the prefix Q.

    If you create your own new variables, do not use a prefix of Q.

  • Supplied by BMC AMI OpsA

    BMC AMI OpsA also supplies SHARED variables that represent MVS system symbols

    These SHARED variables begin with the prefix QMSYM. Updating or reloading the MVS system symbols will automatically refresh the QMSYM SHARED variables

    For example, the SHARED variable for the MVS system symbol &SYSCLONE. is &QMSYM_SYSCLONE. In this example, the SHARED variable drops the ampersan    d (&) and the period (.) of &SYSCLONE. Another example is where the SHARED variable for system symbol &VAR1 which is &QMSYM_var1. 

    With the supplied QMSYSM SHARED variables, all MVS system symbols are available. BMC AMI OpsA  processes any variable that begins with double ampersands (&&) as an original MVS system symbol. You should prefix your variables with a single ampersand and not a double ampersand. For example, use &userDefinedVar and not &&userDefinedVar.

If a BBI-SS PAS warm start is performed

The SHARED variable pool is kept, and all variables have the same values as before the warm start.

If a BBI-SS PAS cold start is performed

The SHARED pool will be reset only if you specify the VPOOL=RESET parameter in your BBI-SS PAS JCL. The default is NORESET. See the topic "Cold Start of a BBI-SS PAS" in Administering for more information on resetting the variable pool at BBI-SS PAS cold start.

You can also reset the pool by issuing the following statement in an EXEC:

REXX EXEC example:

"IMFEXEC VDEL ALL SHARED"

CLIST example:

IMFEXEC VDEL ALL SHARED

This statement deletes all of the variables from the SHARED pool except the read-only variables supplied by BMC AMI OpsA . You can also delete SHARED variables using the BBI control command:

        .DEL V <variableName>
      

To display the contents of the variable pool, use the BBI control command .DISPLAY VPOOL (parameters). See BBI control commands. 

This section contains the following topics:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*