RLSDSTQ (Release Distribution Queue)

RLSDSTQ Command syntax diagram

 

Purpose

The Release Distribution Queue (RLSDSTQ) command releases a distribution queue from a held status and allows it to be 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

1. This command is shipped with public *EXCLUDE authority and the QPGMR and QSYSOPR user profiles have private authorities to use the command.
2. Messages that report errors about distribution queues may display or print different characters than the user 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 on the Work with Distribution Queue (WRKDSTQ) command. An error may be reported if the character-string value specified for the 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).

 

Required Parameters

DSTQ

Specifies the name of the distribution queue being released from being held. Both normal and high priority portions of the specified distribution queue are shown or printed. The queue specified must have been previously configured. See the Configure Distribution Services (CFGDSTSRV) command or the Add Distribution Queue (ADDDSTQ) command.

PTY

Specifies whether the normal priority or high priority portion of the specified queue is released from being held.

*NORMAL: Releases the normal priority queue, which is for distributions with a service level of data low.

*HIGH: Releases the high priority queue, which is for distributions with a service level of fast, status, or data high.

Examples for RLSDSTQ

Example 1: Releasing the Normal Priority Portion of the Queue

RLSDSTQ  DSTQ(CHICAGO)  PTY(*NORMAL)

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

Example 2: Releasing the High Priority Portion of the Queue

RLSDSTQ  DSTQ(ATLANTA)  PTY(*HIGH)

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

Error messages for RLSDSTQ

*ESCAPE Messages

CPF8802

Distribution queue &1 was not found.

CPF8805

Special value for System name/Group not permitted or not used correctly.

CPF8806

Value &1 not valid for system name or system group.

CPF881C

High priority queue not allowed for *SVDS distribution queue &1

CPF8812

Error occurred while processing distribution queues.

CPF8816

QSNADS communications subsystem is not active.

CPF8817

Distribution queue is held.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9847

Error occurred while closing file &1 in library &2.