Add Distribution Queue (ADDDSTQ)
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. More information about configuring a distribution network is in the SNA Distribution Services book, SC41-5410.
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).
| Keyword |
Description |
Choices |
Notes |
| DSTQ |
Distribution queue |
Character value |
Required, Positional 1 |
| RMTLOCNAME |
Remote location |
Communications name |
Required, Positional 2 |
| DSTQTYPE |
Queue type |
*SNADS, *RPDS, *SVDS, *DLS |
Optional |
| MODE |
Mode |
Communications name, *NETATR |
Optional |
| RMTNETID |
Remote network identifier |
Communications name, *LOC, *NONE |
Optional |
| LCLLOCNAME |
Local location |
Communications name, *LOC |
Optional |
| NRMPTY |
Normal priority |
Element list |
Optional |
| Element 1: Send time |
Single values: *ALWAYS
Other values: Element list |
| Element 1: From time (HHMM) |
0000-2359, ' ' |
| Element 2: To time (HHMM) |
0000-2359, ' ' |
| Element 2: Force time (HHMM) |
0000-2359, *NONE |
| Element 3: Send depth |
1-999, 1, *MANUAL |
| HIGHPTY |
High priority |
Element list |
Optional |
| Element 1: Send time |
Single values: *ALWAYS
Other values: Element list |
| Element 1: From time (HHMM) |
0000-2359, ' ' |
| Element 2: To time (HHMM) |
0000-2359, ' ' |
| Element 2: Force time (HHMM) |
0000-2359, *NONE |
| Element 3: Send depth |
1-999, 1, *MANUAL |
| RTYNBR |
Number of retries |
0-9999, 3 |
Optional |
| RTYITV |
Retry interval |
0-9999, 5 |
Optional |
| SNDQ |
Send while receiving |
*NO, *YES |
Optional |
Distribution queue (DSTQ)
Specifies the name of the distribution queue being added to the distribution services queue table.
This is a required parameter.
Remote location (RMTLOCNAME)
Specifies the name of the remote location to which distributions are sent from this distribution queue. The remote location name must be the same as the remote location name specified in the device description of the device used when sending distributions to another system from this distribution queue.
This is a required parameter.
Queue type (DSTQTYPE)
Specifies the type of distribution queue being added.
The possible values are:
- *SNADS
- SNADS is the distribution queue type. SNADS queues are used to send distributions within a SNADS network.
- *DLS
- DLS is the distribution queue type. DLS queues are used to communicate between your system and document library services on a remote system.
- *RPDS
- RPDS is the distribution queue type. RPDS queues are used to communicate between your system and the AS/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 IBM System Manager for i5/OS 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 (MODE)
Specifies the name of the mode that defines the sessions on the device used by the distribution queue. This parameter is not valid if you specify *RPDS on the Queue type prompt (DSTQTYPE parameter).
The possible values are:
- *NETATR
- The mode name defined in the network attributes is used.
- mode-name
- Specify a maximum of 8 characters for the name of the mode. Do not use CPSVCMG or SNASVCMG; these mode names are reserved for system use.
Remote network identifier (RMTNETID)
Specifies the remote network identifier of the remote network to which this distribution queue sends distributions. This parameter is not applicable if you specify *RPDS on the Queue type prompt (DSTQTYPE parameter).
The possible values are:
- *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.
Local location (LCLLOCNAME)
Specifies the name used to identify your system to remote systems in the network. It is recommended that the name be the same as your system name.
The possible values are:
- *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.
Normal priority (NRMPTY)
Specifies the queue sending conditions for distributions having a service level of data low. This parameter's three elements are:
- Send time
- The time period during which queued distributions of this priority are sent from this distribution queue. If you do not enter a time period, the transmissions are controlled by send depth and are not related to time.
- Force time
- 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 you specify a specific to-time and from-time for the send time, the force time must occur within that time period.
- Send depth
- The number of distributions of this priority that must be on the queue before the system automatically begins sending them.
The possible send time values are:
- *ALWAYS
- Distributions of this priority are sent from this distribution queue regardless of the time of day.
- from-time to-time
- Specify the time of day during which distributions of this priority can be sent from this distribution queue. The from-time and to-time must be specified in the 24-hour time format hhmm where h = hours and m = minutes. Both from-time and to-time must be specified.
The possible force time values are:
- *NONE
- No force time is specified.
- force-time
- Specify the force time in the 24-hour format hhmm where h = hours and m = minutes.
The possible send depth values are:
- 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.
- send depth
- Specify the number of distributions of this priority that must be in this distribution queue before any are sent. Valid values range from 1 through 999.
High priority (HIGHPTY)
Specifies the queue sending conditions for distributions having a service level of fast, status, or data high. This parameter's three elements are:
- Send time
- The time period during which queued distributions of this priority are sent from this distribution queue. If you do not enter a time period, the transmissions are controlled by send depth and are not related to time.
- Force time
- 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 you specify a specific to-time and from-time for the send time, the force time must occur within that time period.
- Send depth
- The number of distributions of this priority that must be on the queue before the system automatically begins sending them.
The possible send time values are:
- *ALWAYS
- Distributions of this priority are sent from this distribution queue regardless of the time of day.
- from-time to-time
- Specify the time of day during which distributions of this priority can be sent from this distribution queue. The from-time and to-time must be specified in the 24-hour time format hhmm where h = hours and m = minutes. Both from-time and to-time must be specified.
The possible force time values are:
- *NONE
- No force time is specified.
- force-time
- Specify the force time in the 24-hour format hhmm where h = hours and m = minutes.
The possible send depth values are:
- 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.
- send depth
- Specify the number of distributions of this priority that must be in this distribution queue before any are sent. Valid values range from 1 through 999.
Number of retries (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.
The possible values are:
- 3
- The system attempts to resend distributions a maximum of three 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 to 9999.
Retry interval (RTYITV)
Specifies the interval (in minutes) between each retry attempt.
The possible values are:
- 5
- The number of minutes between retries is 5.
- minutes
- Specify the interval (in minutes) between retries. Valid values range from 0 to 9999.
Send while receiving (SNDQ)
Specifies whether this distribution queue ignores the send time and depth values specified on the Normal priority prompt (NRMPTY parameter) and High priority prompt (HIGHPTY parameter) 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 Queue type prompt (DSTQTYPE parameter).
The possible values are:
- *NO
- Distributions are sent from this queue only when the queue's sending conditions are met, or when the Send Distribution Queue (SNDDSTQ) or Work with Distribution Queue (WRKDSTQ) command is used to send the distributions.
- *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 sending conditions. Distributions are automatically sent for manual queues (queues that have no specified depth variable).
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.
*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.