WRKDSTQ (Work with Distribution Queues)

WRKDSTQ Command syntax diagram

 

Purpose

The Work with Distribution Queues (WRKDSTQ) command allows the user to display and work with the distribution requests on the Systems Network Architecture distribution services (SNADS) distribution queues. A detailed description of SNADS is in the SNA Distribution Services book.

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. Before this command is run for the first time, the QSNADS subsystem must have been previously started to create the internal SNADS objects that this command uses.
3. 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 QUEUE 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).

 

Optional Parameters

QUEUE

Specifies the name of the distribution queue being shown or printed. The queue must have been previously configured using the Configure Distribution Services (CFGDSTSRV) command or the Add Distribution Queue (ADDDSTQ) command.

*ALL: The normal and high priority of all distribution queues are shown or printed in alphabetical order.

distribution-queue-name: Specify the name of the distribution queue to show or print. Both normal and high priority portions of the specified distribution queue are shown or printed.

OUTPUT

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output. More information on this parameter is in commonly used parameters.

*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.

*PRINT: The output is printed with the job's spooled output.

Examples for WRKDSTQ

Example 1: Working With All Distribution Queues

WRKDSTQ

This command allows the user to work with the status and contents of all distribution queues. The normal and high priority portions of each distribution queue are shown or printed.

Example 2: Printing Information

WRKDSTQ  OUTPUT(*PRINT)

This command prints information on all distribution queues. The status of the normal and priority portions of the distribution queues are printed followed by a list of the distribution requests on the normal and high priority portions of each distribution queue.

Error messages for WRKDSTQ

*ESCAPE Messages

CPF8802

Distribution queue &1 was not found.

CPF8806

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

CPF8807

Error occurred while using QSNADS journal.

CPF8809

Errors detected on SNADS internal queues.

CPF8812

Error occurred while processing distribution queues.

CPF8813

No entries exist.

CPF8819

Special value for distribution queue name not permitted.

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.

CPF9850

Override of printer file &1 not allowed.