CL Command Reference - ADDDSTQ

CL Command List > ADDDSTQ Reference

Description:

The Add Distribution Queue (ADDDSTQ) command allows you to add an entry to the distribution services queue table. Distribution queues are used to store distributions before they are sent or forwarded to other systems.

Interactive display support is provided by the Configure Distribution Services (CFGDSTSRV) command.

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.

. The combination of remote location name, mode, remote network identifier, and local location name must be unique within the type of distribution queue. This combination does not need to be unique within the system, for SNA distribution services (SNADS) distribution queues in the distribution services queue table (SNADS-type distribution queues), and for SystemView distribution services (SVDS) distribution queues (SVDS-type distribution queues). The default value *LOC, which can be specified on the RMTNETID parameter and the LCLLOCNAME parameter, and the default value *NETATR, which can be specified on the MODE parameter, represent any possible values that the system determines are not already configured for another SNADS or SVDS distribution queue of the same type.

. You must specify a unique remote location name for each RPDS-type distribution queue in the queue table. RPDS queues do not use modes, remote network identifiers, or local location names.

. Configuration of the routing table is not required for SVDS-type distribution queues. SVDS queues may be configured optionally in the SNADS routing table. However, normal SNADS mail can neither be routed to change management queues nor be received through change management connections, and change management connections can neither be routed to SNADS queues nor be received through SNADS connections.

. SVDS-type distribution queues can support only a single queue view (the queue is not divided into normal and priority halves). For configuration and operations purposes, only the normal queue is specified.

. 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: Adding a SNADS Distribution Queue

ADDDSTQ DSTQ(CHICAGO) RMTLOCNAME(CHICAGOLU) MODE(NEWMODE)

This command adds a distribution queue named CHICAGO. The queue uses remote location name CHICAGOLU and mode NEWMODE when sending SNADS distributions.



Example 2: Adding a DLS Distribution Queue

ADDDSTQ DSTQ(DLSQUEUE) DSTQTYPE(*DLS) RMTLOCNAME(DLSLU)
MODE(DLSMODE)

This command adds a DLS type of distribution queue named DLSQUEUE. The queue uses remote location name DLSLU and mode DLSMODE when sending DLS requests.


Example 3: Adding an SVDS Distribution Queue

ADDDSTQ DSTQ(CHICACM) RMTLOCNAME(CHIGAGOLU) DSTQTYPE(*SVDS)

This command adds an SVDS type of distribution queue named CHICACM. The queue uses remote location name CHICAGOLU when sending and receiving SVDS change management distributions.