CL Command Reference - ADDDSTRTE

CL Command List > ADDDSTRTE Reference

Description:

The Add Distribution Route (ADDDSTRTE) command allows you to add an entry to the distribution services routing table. The routing table determines which distribution queue receives a distribution on its way to a particular destination.

Distributions are routed to distribution queues based on service levels. One or more service levels must be specified for each routing table entry. Your system will not route distributions for service levels you have not configured. Normally, all service levels routed to the same destination use the same distribution queue. However, the user can configure several distribution queues for one destination based on distribution service levels.

System names, group names, and 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.

. An error occurs if a distribution route specifying a SystemView distribution services (SVDS) type of distribution queue includes another type of distribution queue (such as SNA distribution services (SNADS) or VM/MVS bridge (RPDS)).


Examples:

Example 1: Adding an Entry for an Adjacent System

ADDDSTRTE SYSNAME(SYSTEMA GROUPA) FAST(SYSTEMA)
STATUS(SYSTEMA)
DATAHIGH(SYSTEMA) DATALOW(SYSTEMA)

This command adds a routing table entry for a system that is directly connected to this system (via a physical advanced program-to-program communications (APPC) connection or a logical APPN connection). The distribution queue is given the same name as the destination system. The hop count defaults to the system default value.



Example 2: Adding a Generic Routing Table Entry

ADDDSTRTE SYSNAME(*ANY GROUPNM1) FAST(SYSTEMA)
STATUS(SYSTEMA)
DATAHIGH(SYSTEMA) DATALOW(SYSTEMA)

This command adds a routing table entry for all systems in system group GROUPNM1. The distribution queue SYSTEMA is used to route distributions to all systems in the group.