RMVDSTQ (Remove Distribution Queue)

RMVDSTQ Command syntax diagram

 

Purpose

The Remove Distribution Queue (RMVDSTQ) command allows the user to remove a distribution queue entry from the distribution services queue table. Distribution queues are used to store distributions before they are sent or forwarded to other systems.

The RMVDSTQ command does not provide interactive display support. This is provided by the Configure Distribution Services (CFGDSTSRV) command. More information about configuring a distribution network is in the SNA Distribution Services Link to PDF 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. The following distribution queues cannot be removed:

    • Queues referred to in the routing table

    • Queues that contain distributions waiting to be sent

    • DLS (document library services) queues that have remote libraries configured to use them

    • SVDS (SystemView distribution services) queues when a receiver is active or when distributions have been received and the sender has not acknowledged receiving confirmation.

  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 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 entry to be removed.

Example for RMVDSTQ 

RMVDSTQ   DSTQ(CHICAGO)

This command removes the distribution queue entry named CHICAGO.

Error messages for RMVDSTQ

*ESCAPE Messages

CPF8802
Distribution queue &1 was not found.
CPF8807
Error occurred while using QSNADS journal.
CPF8809
Errors detected on SNADS internal queues.
CPF881B
Distributions are being received for distribution queue &1
CPF8826
Distribution queue entries exist for distribution queue &1.
CPF8827
Routing table entries exist for distribution queue &1.
CPF8828
Remote document library entries exist for *DLS distribution queue &1.
CPF8833
Distribution queue &1 already exists.
CPF8849
Queue &1 in use by another distribution services function.
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.
CPF9899
Error occurred during processing of command.