Change Distribution Route (CHGDSTRTE)
| 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:
- This command is shipped with public *EXCLUDE authority, and the QPGMR and QSYSOPR user profiles have private authorities to use the command.
- You must specify a value on at least one of the following parameters: FAST, STATUS, DATAHIGH, or DATALOW. You cannot change the value on all four parameters to *NONE.
- An error occurs if a distribution route specifying a SystemView distribution services (SVDS) type of distribution queue is changed to include another type of distribution queue (such as SNA distribution services (SNADS) or VM/MVS bridge (RPDS)).
| Top |
Parameters
| 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 |
System name (SYSNAME)
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 |
Fast service level (FAST)
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:
- *SAME
- The distribution queue and maximum hop count do not change.
- *NONE
- No distribution queue is specified for distributions requiring a fast service level. Distributions requiring fast service cannot be routed using this routing table entry.
- distribution-queue-name
- Specify the name of the distribution queue to which distributions using this service level and routing entry are sent. The distribution queue must already exist and cannot be a DLS (document library services) type of queue.
The possible maximum hop count values are:
- *NETATR
- The system network attributes value for the maximum hop count is used. You can display the current system value using the Display Network Attributes (DSPNETA) command.
- hop-count
- Specify the maximum hop count. Valid values range from 1 through 255.
| Top |
Status service level (STATUS)
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:
- *SAME
- The distribution queue and maximum hop count do not change.
- *NONE
- No distribution queue is specified for distributions requiring a status service level. Distributions requiring status service cannot be routed using this routing table entry.
- distribution-queue-name
- Specify the name of the distribution queue to which distributions using this service level and routing entry are sent. The distribution queue must already exist and cannot be a DLS (document library services) type of queue.
The possible maximum hop count values are:
- *NETATR
- The system network attributes value for the maximum hop count is used. You can display the current system value using the Display Network Attributes (DSPNETA) command.
- hop-count
- Specify the maximum hop count. Valid values range from 1 through 255.
| Top |
Data high service level (DATAHIGH)
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:
- *SAME
- The distribution queue and maximum hop count do not change.
- *NONE
- No distribution queue is specified for distributions requiring a data high service level. Distributions requiring data high service cannot be routed using this routing table entry.
- distribution-queue-name
- Specify the name of the distribution queue to which distributions using this service level and routing entry are sent. The distribution queue must already exist and cannot be a DLS (document library services) type of queue.
The possible maximum hop count values are:
- *NETATR
- The system network attributes value for the maximum hop count is used. You can display the current system value using the Display Network Attributes (DSPNETA) command.
- hop-count
- Specify the maximum hop count. Valid values range from 1 through 255.
| Top |
Data low service level (DATALOW)
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:
- *SAME
- The distribution queue and maximum hop count do not change.
- *NONE
- No distribution queue is specified for distributions requiring a data low service level. Distributions requiring data low service cannot be routed using this routing table entry.
- distribution-queue-name
- Specify the name of the distribution queue to which distributions using this service level and routing entry are sent. The distribution queue must already exist and cannot be a DLS (document library services) type of queue.
The possible maximum hop count values are:
- *NETATR
- The system network attributes value for the maximum hop count is used. You can display the current system value using the Display Network Attributes (DSPNETA) command.
- hop-count
- Specify the maximum hop count. Valid values range from 1 through 255.
| Top |
Text (TEXT)
Specifies the text that briefly describes the object.
The possible values are:
- *SAME
- The text does not change.
- *BLANK
- The text is changed to blanks.
- 'description'
- Specify a maximum of 50 characters of text enclosed in apostrophes.
| Top |
Examples
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 |
Error messages
*ESCAPE Messages
- CPF8801
- Document library services (*DLS) queue &1 not allowed in routing table.
- CPF8802
- Distribution queue &1 was not found.
- CPF8807
- Error occurred while using QSNADS journal.
- CPF881E
- Distribution route contains combination of distribution queues that is not allowed
- CPF8815
- Routing table entry &1 &2 not found.
- CPF8831
- Entry &1 &2 already exists in routing table.
- CPF8837
- System name/Group &1 &2 in use by another distribution services function.
- 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.
| Top |