MQREPHLQ

Read syntax diagramSkip visual syntax diagram
>>-MQREPHLQ=-mqrep-hlq-----------------------------------------><

MQREPHLQP
Specifies an installation-specific high-level qualifier to be used in the name pattern of the dynamic reply queue for Websphere MQ related functions. The specific queue name used is returned by the Queue Manager being used at the time.
mqrep-hlq
You can specify any valid qualifier, including multilevel if required, up to a total length of 38 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 your TSO prefix. Note that the current user ID is always appended to this high-level qualifier when requesting a dynamic queue.

Also note that the characters '#' (X'7C'), '@' (X'7B') and '$' (X'5B'), while allowed in user IDs, are not permitted in Websphere MQ. Although specifying them in this parameter is accepted, they are changed at runtime to the allowable MQ character '_'.

&&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 2 below). A period separating parts of a multilevel qualifier must be doubled (see Example 3 below).

Example 1

If the user ID is XXXX, specifying the value HFMTMQL. results in a dynamic name request for the pattern:

HFMTMQL.XXXX.*

Example 2

If the user ID is XX#XX and the TSO prefix is YYYY, then specifying &&USER.1.TEMP.&&PREFIX results in a dynamic name request for the pattern:

XX_XX1.TEMP.YYYY.XX_XX.*

Example 3

If the user ID is ZZZZ, then specifying HFM.&&USER..ABCD. results in a dynamic name request for the pattern:

HFM.ZZZZ.ABCD.ZZZZ.*

Note: 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.