DELETE-ROUTE / DLRT: Delete route

You use the DELETE-ROUTE command to delete a route with the L3 profile IP, IPv6 or INTF and possibly the associated (partner) processor. Other L3 profiles are not permitted.

Only routes to end systems for which no further connections exist are deleted. Routes to router systems cannot be deleted.

The delayed release of system resources can require considerable command processing time.

The alias name DLRT exists for DELETE-ROUTE in order to provide SNMP support. The SDF alias is DLRT.

BS2000 console	BS2000 SDF command	Command/ SOF file	SNMP management	Parameter service
x	x	x	x

List of valid command sources

DELETE-ROUTE / DLRT       Delete route

ROUTE-NAME = <composed-name 1..8> / <c-string 1 .. 8> / *IP(...) / *IPV6(...) / *ISO(...)
	*IP(...)
		|		IP-ADDRESS = <composed-name 7 .. 15> / <x-string 7 .. 8>
	*IPV6(...)
		|		IPV6-ADDRESS = <text 9 .. 45> / <c-string 9 .. 45>
	*ISO(...)
		|		ISO-ADDRESS = <x-string 1 .. 40>
,DELETE-PROCESSOR = *YES / *NO

ROUTE-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the route that is to be deleted.

ROUTE-NAME=*IP(...)
The routes defined by their partner IP address are deleted.

IP-ADDRESS=<composed-name 7..15> / <x-string 7..8>
Partner IP address of the routes that are deleted.

ROUTE-NAME=*IPV6(...)
The routes defined by their partner IPv6 address are deleted.

IPV6-ADDRESS=<text 9..45> / <c-string 9..45>
Partner IPv6 address of the routes that are deleted.

ROUTE-NAME=*ISO(...)
The routes defined by their partner ISO Internet address are deleted.

ISO-ADDRESS=<x-string 1..40>
Partner ISO Internet address of the routes that are deleted.

DELETE-PROCESSOR=...
This operand specifies whether the associated (partner) processor is also deleted.
The (partner) processor is only deleted if there are no further routes to it following deletion of the specified route

DELETE-PROCESSOR=*YES
The associated (partner) processor is also deleted

DELETE-PROCESSOR=*NO
The associated (partner) processor is not deleted.

Command logging

Positive acknowledgments are supplied in news BCA0686, and negative acknowledgments in news BCA06D7.
A description of the error messages that may be issued during command processing is provided in the table below.

Command return codes

(SC2)      SC1	Maincode	Meaning
0        0	CMD0001	Command successfully processed
0        1	CMD0202	Error in command
0        1	BCA0768	Syntax error in command
0       64	BCA07A1	ROUTE-NAME not found
0       64	BCA07CA	No route found to delete
0       64	BCA07EA	BCOUT/DELETE-ROUTE command is being executed for the processor
0       64	BCA07EB	Route is in use
0       64	BCA07EC	Release not permitted
0       64	BCA07ED	Deletion of route of <type> is not permitted, not an IP, IPV6, INTF route
0       64	BCA07EE	BCOUT/DELETE-ROUTE command is being executed for the route
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active

Example

Command sequence for setting up and deleting a processor and the corresponding routes:

/CREATE-PROCESSOR PROCESSOR-NAME=PROCHUGO

/CREATE-ROUTE ROUTE-NAME=ROUTHUGO,PROCESSOR-NAME=PROCHUGO,    -
/             PATH=*VIA-ROUTER(ROUTER-ROUTE-NAME=ROUTER,      -
/             L3-PROTOCOL=*IP(IP-ADDRESS=1.2.3.4)) 

Delete the route with the command

/DELETE-ROUTE ROUTE-NAME=ROUTHUGO

or alternately with the command

/DELETE-ROUTE ROUTE-NAME=*IP(IP-ADDRESS=1.2.3.4),DELETE-PROCESSOR=*NO

/DELETE-PROCESSOR PROCESSOR-NAME=PROCHUGO