| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Distribution Route (CHGDSTRTE) command allows you to change an entry in the distribution services routing table. One or more service levels must be specified for each routing table entry.
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 book.
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:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SYSNAME | System name | Element list | Required, Positional 1 |
| Element 1: System name | Character value, *ANY | ||
| Element 2: System group | Character value, *ANY | ||
| FAST | Fast service level | Single values: *SAME, *NONE Other values: Element list |
Optional |
| Element 1: Distribution queue name | Character value | ||
| Element 2: Hop count | 1-255, *NETATR | ||
| STATUS | Status service level | Single values: *SAME, *NONE Other values: Element list |
Optional |
| Element 1: Distribution queue name | Character value | ||
| Element 2: Hop count | 1-255, *NETATR | ||
| DATAHIGH | Data high service level | Single values: *SAME, *NONE Other values: Element list |
Optional |
| Element 1: Distribution queue name | Character value | ||
| Element 2: Hop count | 1-255, *NETATR | ||
| DATALOW | Data low service level | Single values: *SAME, *NONE Other values: Element list |
Optional |
| Element 1: Distribution queue name | Character value | ||
| Element 2: Hop count | 1-255, *NETATR | ||
| TEXT | Text | Character value, *SAME, *BLANK | Optional |
| Top |
Specifies the system name and group name of the remote system for which you want to change a routing table entry.
The maximum hop count is the maximum number of times in a SNADS network that a distribution can be routed (hop) between systems at the SNADS level, including the hop to the final destination system. The maximum hop count does not include the hops made by advanced peer-to-peer networking (APPN) routing. If the maximum number of hops is exceeded, the distribution is ended and an error message is sent to the user who originally sent the distribution. Maximum hop count provides a means to prevent a distribution from looping indefinitely among systems.
You can specify a maximum of 8 characters for the system name and a maximum of 8 characters for the group name.
*ANY can be specified for the system name. When SYSNAME(*ANY group) is specified, you are changing the routing table entry used to resolve a distribution destination that does not match a specific system name, but matches the group name. Only one *ANY is allowed for each group in the routing table.
*ANY can be specified for the group name only if *ANY is also specified for the system name. When SYSNAME(*ANY *ANY) is specified, you are changing the routing table entry used to resolve a distribution destination that does not match any other routing table entries. Only one SYSNAME(*ANY *ANY) entry is allowed in the routing table.
This is a required parameter.
| Top |
Specifies the distribution queue and maximum hop count to the destination system for fast service level distributions. The fast service level is the highest priority service level.
The possible distribution queue values are:
The possible maximum hop count values are:
| Top |
Specifies the distribution queue and maximum hop count to the destination system for status service level distributions. The status service level is used for network status and other feedback information.
The possible distribution queue values are:
The possible maximum hop count values are:
| Top |
Specifies the distribution queue and maximum hop count to the destination system for data high service level distributions. The data high service level is used for high priority data traffic.
The possible distribution queue values are:
The possible maximum hop count values are:
| Top |
Specifies the distribution queue and maximum hop count to the destination system for data low service level distributions. The data low service level is used for most data traffic.
The possible distribution queue values are:
The possible maximum hop count values are:
| Top |
Specifies the text that briefly describes the object.
The possible values are:
| Top |
CHGDSTRTE SYSNAME(SYSTEMA) DATAHIGH(SYSTEMAFAST 2)
This command changes the distribution queue for distributions sent to SYSTEMA with a data high service level. The new distribution queue is SYSTEMAFAST with a hop count of 2.
| Top |
*ESCAPE Messages
| Top |