z/OS TSO/E CLISTs
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


GLOBAL statement

z/OS TSO/E CLISTs
SA32-0978-00

Use the GLOBAL statement to share values between nested CLISTs. In the hierarchy of nested CLISTs, the highest-level CLIST must contain a GLOBAL statement with the maximum number of variables used throughout the nested chain. Lower-level CLISTs must include a GLOBAL statement if they intend to refer to the global variables defined in the highest-level CLIST.

Note: The GLOBAL statement cannot be used to give a REXX exec access to a CLIST's global variables. CLIST variables cannot be accessed by REXX execs.

The global variables are positional, and the order is defined by the GLOBAL statement in the highest-level CLIST. All lower-level CLISTs that reference this same set of variables must follow this order to reference the same values. The variable names may be unique to the lower-level CLISTs. This means that the Nth name on any level GLOBAL statement refers to the same value, even though the symbolic name at each level may be different. For example, if a nested CLIST references the fifth global variable, then it must define five global variables. If it references the second global variable, then it needs to define only two global variables.

Multiple GLOBAL statements are cumulative. For example, if a CLIST has a GLOBAL statement that defines three variables followed by another GLOBAL statement that defines two variables, then five variables have been defined. The second GLOBAL statement defines the fourth and fifth variables.

The GLOBAL statement must precede any statement that uses or defines its variables.

Read syntax diagramSkip visual syntax diagram
                                   .--------------.   
                                   V              |   
>>-+--------+--GLOBAL--variable_1----+----------+-+------------><
   '-label:-'                        '-variable-'     

label
A name the CLIST can reference in a GOTO statement to branch to this GLOBAL statement. label is one-to-31 alphanumeric characters, beginning with an alphabetic character.
variable_1 / variable
A symbolic variable name for this CLIST. The name refers to a variable that is either being created by this GLOBAL statement or that was created by a GLOBAL statement in the highest-level CLIST.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014