CL Command Reference - CHGDSTQ
CL Command List > CHGDSTQ Reference
Description:
The Change Distribution Queue (CHGDSTQ) command allows you to change an entry in the distribution services queue table. Distribution queues are used to store distributions before they are sent or forwarded to other systems.
The CHGDSTQ command does not provide interactive display support. This is provided by the Configure Distribution Services (CFGDSTSRV) command.
If connection information (remote location name, mode, remote network identifier, and local location name) is changed and a SNADS (SNA distribution services) sender job is active (but not sending), the SNADS sender job is ended and a new job is started to ensure that the job name always reflects the remote location name.
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.
. Connection information cannot be changed when the queue has a status of ¡åSending¡å or when queue entries have the status of ¡åSuspend¡å or ¡åPending.¡å Wait for the status of the queue or queue entry to be no longer active or, as an alternative, use the Initialize Distribution Queue (INZDSTQ) command to reset this condition.
. SVDS-type distribution queues cannot be changed when a receiver is active or when distributions have been received and the sender has not acknowledged receiving the confirmation. Wait for the remote system to complete sending, or as an alternative, use the Initialize Distribution Queue (INZDSTQ) command to reset this condition.
. 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:
CHGDSTQ DSTQ(CHICAGO) RMTLOCNAME(NEWLU) MODE(*NETATR)
This command changes the distribution queue named CHICAGO. The remote location name is changed to NEWLU and the mode is changed to the mode specified in the system network attributes.