System variables substitution in parameter library members

Some MainView AutoOPERATOR BBPARM members support system variables substitution. (Refer to Table 1 for a brief description of each BBPARM member.) With symbolic substitution, you can reduce the number of parameter libraries that you maintain. When the member is read, the value of the symbol is substituted for the symbol. The symbol must begin with an ampersand, followed by one to eight characters, and can optionally end with a period. You can define your own symbols by placing them in the IBM PARMLIB member IEASYMxx.

Symbolic names can be concatenated as a string, and names can be added at the beginning, middle or end of the string. See the following example:

DSN=VAM3.&SYSPLEX..&SYSNAME..OFFLOAD

If &SYSPLEX=BMC1 and &SYSNAME=SJSD, the preceding string converts to

DSN=VAM3.BMC1.SJSD.OFFLOAD

Note

A period at the end of a symbolic name is assumed to be a delimiter and is omitted in the conversion. If you want to generate the string BMC1SJSD, you would code &SYSPLEX&SYSNAME.

For more information about symbolic substitution, refer to 'System Symbols and Symbolic Substitution' in the IBM Initialization and Tuning Reference.

You can control substitution on a member-by-member basis by adding a control card (a PROCESS statement) at the beginning of each member. The PROCESS statement is described in Table 1.

Table 1. PROCESS statement

Control Card

Description

PROCESS [SYM=YES|NO,][LIST=YES|NO]

indicates whether system variables substitution is allowed

When present, the PROCESS statement must be the first statement in the member and must begin in column 1. Possible keywords are as follows

  • SYM= YES|NO

    • YES is the default and indicates that symbols are replaced by their value if the calling program has enabled symbol substitution.

    • NO indicates that symbolic substitution is suppressed for this member even if the calling program has enabled substitution.

Only the first character (Y or N) needs be specified.

Substitution is not performed on comments or any data beyond column 71.

  • LIST=YES| NO

    This keyword indicates whether the contents of the member being processed (all statements following the PROCESS statement) are written to the job log, one statement at a time as the member is read.

  • YES causes the entire contents of the member (except the PROCESS statement) to be written to the job log.

    If substitution is performed, two WTO messages are displayed for each statement where substitution is performed. The first message contains the statement with the symbol, and the second message contains the same statement with the substituted value of the symbol. The second statement is also prefixed with < > to indicate that the statement is modified.

  • NO is the default and indicates that the contents of this member are not written to the job log or displayed as WTO messages.

You can use the Dynamic Parameter Manager (DPM) to display and alter specific parameters in members AAOEXPxx, AAOALSxx, AAOARPxx, and AAOTSPxx. For more information about DPM, see Continuous operation with the Dynamic Parameter Manager.

Was this page helpful? Yes No Submitting... Thank you

Comments