CL Command Reference - HLDDSTQ

CL Command List > HLDDSTQ Reference

Description:

The Hold Distribution Queue (HLDDSTQ) command prevents a distribution queue from being sent.

Distribution queue names are translated to the graphic character set and code page 930 500, using the jobĄ¯s coded character set identifier (CCSID).

Restrictions:

. This command is shipped with public *EXCLUDE authority, and the QPGMR and QSYSOPR user profiles have private authorities to use the command.

. Messages that report errors about distribution queues may display or print different characters than you entered for the distribution queue name because of internal system transformations. Similarly (depending on the language used for the work station), the internal value for a distribution queue name may differ from the characters shown for the Work with Distribution Queue (WRKDSTQ) command. An error may be reported if the character-string value specified for the Distribution queue prompt (DSTQ parameter) does not match the rules for an internal distribution queue value or if it does not match the internal value for any defined distribution queue (ignoring case differences).


Examples:

Example 1: Holding the Normal Priority Portion of a Queue

HLDDSTQ DSTQ(CHICAGO) PTY(*NORMAL)

This command holds the normal priority portion of the CHICAGO distribution queue.



Example 2: Holding the High Priority Portion of a Queue

HLDDSTQ DSTQ(ATLANTA) PTY(*HIGH)

This command holds the high priority portion of the ATLANTA distribution queue.