Remove Distribution Route (RMVDSTRTE)

Where allowed to run: All environments (*ALL)
Threadsafe: No

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).

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

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.

Top

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.

Top

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.

Top