ADDDSTQ (Add Distribution Queue)

ADDDSTQ Command syntax diagram

 

Purpose

The Add Distribution Queue (ADDDSTQ) command adds 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. More information about configuring a distribution network 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. 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.
   
3. A unique remote location name must be specified for each RPDS-type distribution queue in the queue table. RPDS queues do not use modes, remote network identifiers, or local location names.
   
4. Configuration in 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.
   
5. SVDS-type distribution queues can support only a single queue view (the queue is not divided into normal and priority halves). For configurations and operations purposes, only the normal queue is specified.
   
6. 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 a maximum of 16 characters for the name of the distribution queue being added to the distribution services queue table.

RMTLOCNAME

Specifies the name of the remote location where distributions are sent from this distribution queue. The remote location name must be configured in the device description of the device used when sending distributions to another system from this distribution queue.

 

Optional Parameters

DSTQTYPE

Specifies the type of distribution queue being added.

*SNADS: SNADS is the distribution queue type. SNADS queues are used to send distributions within a SNADS network.

*DLS: Document library services (DLS) is the distribution queue type. DLS queues are used to communicate between the local system and document library services on a remote system.

*RPDS: RPDS is the distribution queue type. RPDS queues are used to communicate between the local system and the iSeries 400 VM/MVS bridge, or JES (2,3) on System/370*-type systems, and for the SNADS extended bridge function of the Communications Utilities/400 licensed program.

*SVDS: SystemView distribution services (SVDS) is the distribution queue type. SVDS queues support the communications bridge between a SNADS network and System Manager for iSeries 400 change management. An SVDS queue must be defined in order to receive from as well as send to a remote system using change management.

MODE

Specifies the name of the mode that defines the sessions on the device used by the distribution queue. This parameter is ignored if *RPDS is specified on the DSTQTYPE parameter.

*NETATR: The mode name specified in the network attributes is used.

mode-name: Specify a maximum of 8 characters for the name of the mode. The mode name cannot be CPSVCMG or SNASVCMG; these mode names are reserved for system use.

RMTNETID

Specifies the remote network identifier of the remote network to which this distribution queue sends distributions. This parameter is ignored if *RPDS is specified on the DSTQTYPE parameter.

*LOC: The remote network identifier defined in the device description used by this distribution queue is used.

*NONE: No remote network identifier is specified.

remote-network-ID: Specify the remote network identifier.

LCLLOCNAME

Specifies the name used to identify the local system to remote systems in the network. Whenever possible, the name should be the same as the local system name.

*LOC: The local location name defined in the device description used by this distribution queue is used.

local-location-name: Specify a maximum of 8 characters for the local location name.

NRMPTY

Specifies the queue sending conditions for distributions having a service level of data low.

Element 1: Send Time

The send time is the time period during which queued distributions of this priority are sent from this distribution queue. If no time period is specified, the transmissions are controlled by queue depth and are not related to time. The time must be specified in the 24-hour format hhmm where hh = hours and mm = minutes.

*ALWAYS: Distributions of this priority are sent from this distribution queue regardless of the time of day.

from-time: Specify the time of day at which the system starts sending distributions of this priority from this distribution queue if the value specified for send depth is reached. If from-time is specified, to-time must also be specified.

to-time: Specify the time of day at which the system stops sending distributions of this priority from this distribution queue. If to-time is specified, from-time must also be specified.

Element 2: Force Time

Force time is a specific time during which distributions of this priority are sent regardless of queue depth. If *ALWAYS is specified for the send time, the force time can be set to any time of day. If a specific to-time and from-time is specified for the send time, the force time must occur within that time period. The time must be specified in the 24-hour format hhmm where hh = hours and mm = minutes.

*NONE: No force time is specified.

force-time: Specify the force time.

Element 3: Depth

Queue depth specifies the number of distributions of this priority that are on the queue before sending begins.

1: Distributions are sent when they are put on the queue.

*MANUAL: Distributions are sent only when an operator manually sends them using the Work with Distribution Queue (WRKDSTQ) command or the Send Distribution Queue (SNDDSTQ) command.

depth: Specify the number of distributions of this priority that are on this distribution queue before any are sent. Valid values range from 1 through 999.

HIGHPTY

Specifies the queue sending conditions for distributions having a service level of fast, status, or data high. On this parameter, time must be specified in the 24-hour format hhmm where hh = hours and mm = minutes.

Element 1: Send Time

*ALWAYS: Distributions of this priority are sent from this distribution queue regardless of the time of day.

from-time: Specify the time of day at which the system starts sending distributions of this priority from this distribution queue if the value specified for send depth is reached. If from-time is specified, to-time must also be specified.

to-time: Specify the time of day at which the system stops sending distributions of this priority from this distribution queue. If to-time is specified, from-time must also be specified.

Element 2: Force Time

*NONE: No force time is specified.

force-time: Specify the force time.

Element 3: Depth

1: Distributions are sent when they are put on the queue.

*MANUAL: Distributions are sent only when an operator manually sends them using the WRKDSTQ command or the SNDDSTQ command.

depth: Specify the number of distributions of this priority that are on this distribution queue before any are sent. Valid values range from 1 through 999.

RTYNBR

Specifies the maximum number of times the system attempts to resend distributions from this distribution queue after a failure occurs. This parameter applies to communications line failures and recoverable distribution failures on a remote system. The SNADS job serving this distribution queue ends when the number of retries is exceeded.

3: The system attempts to resend distributions a maximum of 3 times after a failure.

number: Specify the maximum number of times the system can attempt to resend distributions after a failure. Valid values range from 0 through 9999.

RTYITV

Specifies the interval (in minutes) between each retry attempt.

5: The number of minutes between retries is 5.

minutes: Specify the interval between retries. Valid values range from 0 through 9999 minutes.

SNDQ

Specifies whether this distribution queue ignores the send time and depth values specified on the NRMPTY and HIGHPTY parameters and begins sending when a distribution is received from the SNADS system to which the queue sends its distributions.

This parameter is valid only if *SNADS is specified on the DSTQTYPE parameter.

*NO: Distributions are sent from this queue only when the queue's sending conditions are met.

*YES: This distribution queue begins sending when distributions are received from the SNADS system to which the queue sends its distributions, regardless of the queue's other sending conditions. Distributions are automatically sent for manual queues (queues that have no specified depth variable).

Examples for ADDDSTQ

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.

Error messages for ADDDSTQ

*ESCAPE Messages

CPF8802

Distribution queue &1 was not found.

CPF8807

Error occurred while using QSNADS journal.

CPF8809

Errors detected on SNADS internal queues.

CPF881D

High priority data not allowed for *SVDS distribution queues

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.