Read syntax diagramSkip visual syntax diagram

Specifies an installation-specific high-level qualifier for the temporary data sets created during a Z Data Tools session.
Some Z Data Tools functions that create temporary data sets, for which the TEMPHLQ value is used if specified, are:
  • ZDT/IMS processing the XKEY command
  • ZDT/IMS creating the IMS™ LOG data set
  • ZDT/IMS executing IXB (IMS Extract data in batch) function
  • ZDT/IMS processing and building PSBs
  • ZDT/Db2 editing and showing SQL statements

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 the user's user ID. If you specify &&PREFIX. for any part of the qualifier, this is replaced with the user's 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
will result in a high-level-qualifier of

Example 2

If the user ID is ZZZZ then specifying
will result in a high-level-qualifier of
  1. The TEMPHLQ 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 TEMPHLQ will be 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 will be shortened to the extent that the final part of the qualifier is eight characters long.