AUXHLQ

Read syntax diagramSkip visual syntax diagram
>>-AUXHLQ=aux-hlq----------------------------------------------><

AUXHLQ
Specifies an installation-specific high-level qualifier to be used in the name of the auxiliary data set for a full function edit session.

You can specify any valid qualifier, including multilevel if required, up to a total length of 24 characters. If you specify &&USER. for any part of the qualifier in your HFM0POPT macro, this is replaced with your user ID. If you specify &&PREFIX. for any part of the qualifier, this is replaced with the user TSO prefix.

&&USER. and &&PREFIX. can also be concatenated with a character string. A multilevel qualifier with symbols follows the same rules as in the specification of a data set name with symbolic parameters in JCL procedures. Thus, a single period used after a symbol combines the symbol with the text following it (See Example 1 below); a period separating parts of a multilevel qualifier must be doubled (see Example 2 below).

Example 1

If the user ID is XXXX and the TSO prefix is YYYY, then specifying
      &&USER.1.TEMP.&&PREFIX
results in a high-level-qualifier of
XXX1.TEMP.YYYY

Example 2

If the user ID is ZZZZ then specifying
      HFM.&&USER..ABCD
results in a high-level-qualifier of
      HFM.ZZZZ.ABCD
Note:
  1. The AUXHLQ parameter can be up to 24 characters long. However, temporary data sets can have different lengths, and the system part of the data set name may be longer than 20 characters. In this case, minor levels of AUXHLQ are ignored, to the extent that the final data set name is less than or equal to 44 characters.
  2. Concatenation of &&USER.string, or &&PREFIX.string, could result in a part of the high-level qualifier being longer than eight characters. In this case, the string is shortened to the extent that the final part of the qualifier is eight characters long.