Defining System Options in Parmlib › Parmlib Syntax › System Symbol Substitution

System Symbol Substitution

CA Tape Encryption supports system symbol substitution in the parmlib members. For example, &SYSNAME resolves to the system name on which CA Tape Encryption is run. In addition to the standard system symbols, the following symbols may be used:

• &JOBNAME for the jobname of the started task
• &STEPNAME for the stepname of the started task
• &BES for the subsystem id of the started task (BESn where n = 1-8)
• &PARMDIR for the parmlib member containing the ParmlibDirectory section
• &THIS for the current parmlib member name
• Substring notation is allowed. For example, &SYSNAME(4:1) means the substring of &SYSNAME starting in position 4 for a length of 1. If the value of &SYSNAME is TSO1, then the value of &SYSNAME(4:1) is “1”

Symbolic variables allow attributes to be assigned unique values while sharing parmlib members among different subsystems.

Example: symbolic substitution

In this example a common BESPARMS member directs CA Tape Encryption to different members to determine the appropriate symmetric keys or B2B key rings to use:

<ParmlibDirectory>                       ; Directory of Parmlib Members
  StartupOptions         =&This          ; Options used at initialization
  DynamicOptions         =&This          ; Options which can be refreshed
  SymmetricKeys          =TESTKEYS       ; Get Symmetric Keys from
                                         ; member TESTKEYS
  CAEKM_API_Options       CAEKMAPI       ; Options related to the CA EKM API
  B2BKeyrings            =KR&SYSNAME     ; Get Key ring definitions from
                                         ; member KRSYS1 when run on SYS1
                                         ; and KRSYS2 when run on SYS2

Note: For information on the use of system symbols including substring notation, see the IBM MVS Initialization and Tuning Reference.