The Remove Distribution Route (RMVDSTRTE) command allows you to remove an entry from the distribution services routing table. Once a system is removed from the table, distributions can no longer be sent directly to that system from this system.

Interactive display support is provided by the Configure Distribution Services (CFGDSTSRV) command. More information on configuring a distribution network is in the SNA Distribution Services book, SC41-5410.

Restriction: This command is shipped with public *EXCLUDE authority, and the QPGMR and QSYSOPR user profiles have private authorities to use the command.

System names and group names are translated to the graphic character set and code page 930 500, using the job's coded character set identifier (CCSID).

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

Top

System name (SYSNAME)

Specifies the system name and group name of the remote system you want to remove from the routing table.

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 remove the routing table entry used to resolve a distribution destination that does not match a specific system name, but matches a group name. Only one *ANY is allowed for each group in the 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 remove 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 table.

This is a required parameter.

Examples

Example 1: Removing a System from the Routing Table

RMVDSTRTE   SYSNAME(SYSTEMA GROUPA)

This command removes the routing table entry for the system named SYSTEMA.

Example 2: Removing a Generic Routing Table Entry

RMVDSTRTE   SYSNAME(*ANY GROUPNM1)

This command removes a routing table entry that has a system name of *ANY and a group name of GROUPNM1.

Error messages

*ESCAPE Messages

CPF8802

Distribution queue &1 was not found.

CPF8807

Error occurred while using QSNADS journal.

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.