Table Of Contents
APPN Configuration Commands
adjacent-cp-name
appn class-of-service
appn connection-network
appn control-point
appn link-station
appn mode
appn partner-lu-location
appn port
appn routing
appn start
appn start link-station
appn start port
appn stop
appn stop link-station
appn stop port
backup-dlus (APPN control point)
backup-dlus (APPN link station)
buffer-percent
class-of-service
connect-at-startup
cost-per-byte (APPN link station)
cost-per-byte (APPN port)
cost-per-connect-time (APPN link station)
cost-per-connect-time (APPN port)
cp-cp-sessions-supported
desired-max-send-btu-size
dlur
dlur-dspu-name
dlus (APPN control point)
dlus (APPN link station)
effective-capacity (APPN link station)
effective-capacity (APPN port)
fr-dest-address
interrupt-switched
lan-dest-address
limited-resource (APPN link station)
limited-resource (APPN port)
link-queuing
local-sap
max-cached-entries
max-cached-trees
minimum-memory
maximum-memory
max-link-stations
max-rcv-btu-size
node-row
null-xid-poll
owning-cp
port (APPN connection network)
port (APPN link station)
propagation-delay (APPN link station)
propagation-delay (APPN port)
pu-type-20
reserved-inbound
reserved-outbound
retry-limit (APPN link station)
retry-limit (APPN port)
role (APPN link station)
role (APPN port)
route-additional-resistance
rsrb-virtual-station
safe-store-cycle
safe-store-host
safe-store-interval
sdlc-dest-address
sdlc-sec-addr
security (APPN link station)
security (APPN port)
service-any
serving-nn
show appn class-of-service
show appn connection-network
show appn directory
show appn dlur-lu
show appn dlur-pu
show appn dlus
show appn intermediate-session
show appn link-station
show appn mode
show appn node
show appn port
show appn session
show appn topology
tg-number
tg-row
transmission-priority
user-defined-1 (APPN link station)
user-defined-2 (APPN link station)
user-defined-3 (APPN link station)
user-defined-1 (APPN port)
user-defined-2 (APPN port)
user-defined-3 (APPN port)
verify-adjacent-node-type
wildcard
x25-dest-address
x25-subaddress
xid-block-number
xid-id-number
APPN Configuration Commands
This chapter describes the commands to configure and monitor the Advanced Peer-to-Peer Networking (APPN) feature. For APPN configuration tasks and examples, refer to the "Configuring APPN" chapter of the Router Products Configuration Guide.
Note: This chapter introduces seven new command modes:
•
APPN class of service configuration
•
APPN connection network configuration
•
APPN control point configuration
•
APPN link station configuration
•
APPN mode configuration
•
APPN partner LU location configuration
•
APPN port configuration
adjacent-cp-name
Use the adjacent-cp-name APPN link station configuration command to specify the name of the partner node for the link station. Use the no form of this command to delete the definition.
adjacent-cp-name netid.cpname
no adjacent-cp-name
Syntax Description
netid.cpname
|
Fully qualified network name of the remote control point. A fully qualified name is a string of 1 to 8 characters, followed by a period, followed by a string of 1 to 8 characters. The following characters are acceptable: A - Z, a - z 0 - 9 $ # @ The first character of either string must not be a number.
|
Default
The default state is no adjacent-cp-name.
Command Mode
APPN link station configuration
Usage Guidelines
If the name configured with this command does not match the remote node's CP name, the link will not come up. If the no form of the command is issues, or the command is not issued at all, no checking is done. This command must be specified if the adjacent node is LEN.
Example
The following example defines a link station that specifies the name of the partner node:
lan-dest-address 1000.C4C1.E5C5
adjacent-cp-name CISCO.APPN1
Related Commands
appn link-station
show appn link-station
appn class-of-service
Use the appn class-of-service global configuration command to define an APPN class of service that is not an IBM-supplied default. Use the no form of this command to delete the definition. This command begins the APPN class of service configuration command mode.
appn class-of-service cosname
no appn class-of-service cosname
Syntax Description
cosname
|
Class of service name not among IBM default names. Class of service names must be a Type A character string. A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @
|
Default
There is no default class of service name.
If this command is not issued, an IBM default class of service can be used. The IBM supplied default classes of service are #CONNECT, #BATCH, #INTER, #BATCHSC, #INTERSC, CPSVCMG, and SNASVCMG.
Command Mode
Global configuration
Usage Guidelines
Class of Service (COS) is a definition of the transport network characteristics that should be used to establish a particular session. The COS definition assigns relative values to factors such as acceptable levels of security, cost per byte, cost per connect-time, propagation delay, and effective capacity. APPN network nodes use COS to select the best session routes between LUs.
If one of the IBM default classes of service does not meet the needs of a particular network, the appn class-of-service global configuration command can be used to create a user defined definition.
Example
The following example defines a COS with one node row and one tg row:
appn class-of-service #SECURE
node-row 1 weight 5 congestion no no route-additional-resistance 0 255
tg-row 1 weight 30 byte 0 255 time 0 255 capacity 0 255 delay 0 255 security 200 255 user1
0 255 user2 0 255 user3 0 255
Related Commands
node-row
show appn class-of-service
tg-row
transmission-priority
appn connection-network
Use the appn connection-network global configuration command to specify the fully qualified network name for the connection network. Use the no form of this command to delete the definition. This command begins the APPN connection network configuration command mode.
appn connection-network netid.cnname
no appn connection-network netid.cnname
Syntax Description
netid.cnname
|
Fully qualified network name for the connection network. cnname is the name of the virtual network node in the connection network. A fully qualified name is a string of 1 to 8 characters, followed by a period, followed by a string of 1 to 8 characters. The following characters are acceptable: A - Z, a - z 0 - 9 $ # @ The first character of either string must not be a number.
|
Default
No default connection network name is assigned.
Command Mode
Global Configuration
Usage Guidelines
The connection network name must be the same on all nodes that define the connection network, and must be different from any other connection network, LU, or control point in the total network.
Example
The following example defines a connection network using APPN port TR0:
appn connection-network CISCO.CAPPN1
Related Commands
port (APPN connection network)
show appn connection-network
appn control-point
Use the appn control-point global configuration command to specify the fully qualified control point name for the node. Use the no form of this command to delete the name and clear all APPN definitions. This command begins the APPN control point configuration command mode.
appn control-point netid.cpname
no appn control point netid.cpname
Syntax Description
netid.cpname
|
Fully qualified control point name for the local node. A fully qualified name is a string of 1 to 8 characters, followed by a period, followed by a string of 1 to 8 characters. The following characters are acceptable: A - Z, a - z 0 - 9 $ # @ The first character of either string must not be a number.
|
Default
No default control point name is assigned.
Command Mode
Global configuration
Usage Guidelines
You must issue the appn control-point command to activate APPN routing. There can be only one control point definition in the system. The control point name must be unique in the network.
Example
The following example defines a control point named CISCO.APPN1:
appn control-point CISCO.APPN1
Related Commands
appn routing
appn start
appn stop
backup-dlus (APPN control point)
buffer-percent
dlur
dlus (APPN control point)
interrupt-switched
max-cached-entries
max-cached-trees
maximum-memory
route-additional-resistance
safe-store-cycle
safe-store-host
safe-store-interval
show appn node
xid-block-number
xid-id-number
appn link-station
Use the appn link-station global configuration command to assign the name of an adjacent link station. Use the no form of this command to delete the link station name. This command begins the APPN link station configuration command mode.
appn link-station linkname
no appn link-station linkname
Syntax Description
linkname
|
Name that identifies the link station. The name must be a Type A string. A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @
|
Default
No default link station name is assigned.
Command Mode
Global configuration
Usage Guidelines
A link represents a connection between a local link station and a link station in an adjacent node. The link can be considered a direct connection between two distinct Type 2.1 or Type 2.0 nodes. The link station provides a route over which local sessions or intermediate sessions can pass. Two link stations are required to build a link: one on each node.
A link station can be pre-defined with the appn link-station command, or dynamically defined. If you specify service-any in the associated appn port command, link-stations can be dynamically defined when a connect request is received. In this case, the appn link-station command would not be required. You must define an APPN link station if you intend this node to initiate the connection to the adjacent node.
Example
The following example defines a link station using port TR0:
lan-destination-address 0200.0000.0001
Related Commands
adjacent-cp-name
backup-dlus (APPN link station)
connect-at-startup
cost-per-byte (APPN link station)
cost-per-connect-time (APPN link station)
cp-cp-sessions-supported
dlur-dspu-name
dlus (APPN link station)
effective-capacity (APPN link station)
fr-dest-address
lan-dest-address
limited-resource (APPN link station)
link-queuing
port (APPN link station)
propagation-delay (APPN link station)
pu-type-20
retry-limit (APPN link station)
role (APPN link station)
sdlc-dest-address
security (APPN link station)
show appn link-station
tg-number
user-defined-1 (APPN link station)
user-defined-2 (APPN link station)
user-defined-3 (APPN link station)
verify-adjacent-node-type
x25-dest-address
appn mode
Use the appn mode global configuration command to specify a new mode or to change an IBM defined mode and identify the class of service associated with the mode name. Use the no form of this command to delete the previous definition.This command begins the APPN mode configuration command mode.
appn mode [modename]
no appn mode [modename]
Syntax Description
modename
|
Name of the mode. A Type A character string. A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @
|
Default
IBM defined [blank]
Command Mode
Global configuration
Usage Guidelines
The IBM defined modes are #BATCH, #BATCHSC, #INTER, #INTERSC, #CPSVCMG, #SNASVCMG, #CPSVRMG, and [blank]. These definitions can not be changed.
This command is required when LEN nodes are using this node for network services. The LEN node will issue a BIND containing this mode name; this command will be used to associate the mode name with a COS name.
Example
The following example changes the IBM defined mode #BATCH to use the #CONNECT class of service:
class-of-service #CONNECT
Related Commands
class-of-service
show appn mode
appn partner-lu-location
Use the appn partner-lu-location global configuration command to specify an LU that would be the destination LU for an LU-LU session request from an LU using this node for network services. Use the no form of this command to delete the previous definition. This command begins the APPN partner LU configuration command mode.
appn partner-lu-location netid.luname
no appn partner-lu-location netid.luname
Syntax Description
NETID.LUNAME
|
Fully qualified name of the partner LU. A fully qualified name is a string of 1 to 8 characters, followed by a period, followed by a string of 1 to 8 characters. The following characters are acceptable: A - Z, a - z 0 - 9 $ # @ The first character of either string must not be a number.
|
Default
No default NETID.LUNAME is specified. You must supply a value; otherwise the configuration will fail.
Command Mode
Global configuration
Usage Guidelines
Use this command to define an entry in the directory database. This command improves network performance by allowing directed LOCATE (because the partner name is known), instead of a broadcast. The disadvantage is that definitions must be created. Alternatively, partner names can be discovered dynamically and added to the database as they are learned. This process, however, requires either prior sessions to the node or broadcast traffic (which causes additional network traffic) sent to locate the node.
Example
The following example defines the location of an LU named CISCO.LU21:
appn partner-lu-location CISCO.LU21
Related Commands
owning-cp
serving-nn
show appn directory
wildcard
appn port
Use the appn port global configuration command to define an APPN port and relate it to a previously defined interface.
appn port portname {type number | rsrb}
no appn port portname
Syntax Description
portname
|
Port name to be associated with the interface.
|
type number
|
Previously defined interface type and number with which the port name is to be associated.
|
rsrb
|
Specify rsrb instead of an interface if this port will utilize RSRB as a transport protocol.
|
Default
No default port name is specified. No default interface is provide. Both must be provided or the configuration will fail.
Command Mode
Global configuration
Usage Guidelines
At least one APPN port must be defined for each interface that will participate in APPN routing. If more that one service access point (SAP) will be used over a particular port, then a port must be defined for each SAP.
Example
The following example associates an APPN port named FDDI0 with FDDI interface 0:
Related Commands
A dagger (†) indicates that the command is documented in another chapter.
appn start port
appn stop port
cost-per-byte (APPN port)
cost-per-connect-time (APPN port)
desired-max-send-btu-size
effective-capacity (APPN port)
interface †
limited-resource (APPN port)
local-sap
max-link-stations
max-rcv-btu-size
propagation-delay (APPN port)
reserved-inbound
reserved-outbound
retry-limit (APPN port)
role (APPN port)
rsrb-virtual-station
security (APPN port)
service-any
sdlc-sec-addr
show appn port
user-defined-1 (APPN port)
user-defined-2 (APPN port)
user-defined-3 (APPN port)
x25-subaddress
appn routing
Use the appn routing global configuration command to indicate that APPN routing should be activated. Use the no form to deactivate APPN routing.
appn routing
no appn routing
Syntax Description
This command has no arguments or keywords.
Default
The default state is no appn routing.
Command Mode
Global configuration
Usage Guidelines
For appn routing to complete successfully, an APPN control point must be configured using the appn control-point global configuration command.
Example
The following example specifies that APPN routing should be started:
Related Commands
appn control-point
appn start
appn stop
appn start
Use the appn start EXEC command to activate the APPN subsystem in this node.
appn start
Syntax Description
This command has no arguments or keywords.
Default
This command has no default state.
Command Mode
EXEC
Example
The following example activates APPN:
Related Commands
appn stop
appn routing
appn start link-station
Use appn start link-station to activate a logical APPN link.
appn start link-station linkname
Syntax Description
linkname
|
The name of the link-station. Must be a Type A character string. A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @
|
Default
No default is provided for linkname.
Command Mode
EXEC
Example
The following example activates an APPN link station:
appn start link-station TR0
Related Commands
appn link-station
appn stop link-station
show appn link-station
appn start port
Use the appn start port EXEC command to activate APPN routing over a particular port.
appn start port portname
Syntax Description
portname
|
The name of the port. Must be a Type A character string. A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @
|
Default
No default is provided for portname.
Command Mode
EXEC
Usage Guidelines
This command is also used when the APPN subsystem is already started and a port is added or a characteristic is changed by subcommand.
Example
The following example activates APPN routing over port TR0:
Related Commands
appn port
appn stop port
show appn port
appn stop
This command will deactivate APPN routing without affecting the current configuration.
appn stop
Syntax Description
This command has no arguments or keywords.
Default
This command has no default state.
Command Mode
EXEC
Example
The following command deactivates APPN routing:
Related Commands
appn control-point
appn routing
appn start
appn stop link-station
Use the appn stop link-station EXEC command to deactivate an APPN connection between the local node and an adjacent node.
appn stop link-station linkname
Syntax Description
linkname
|
The name of the link station. The name must be a Type A character string. A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @
|
Default
There is no default provided for linkname.
Command Mode
EXEC
Example
The following command deactivates an APPN link between the local node and an adjacent node:
appn stop link-station APPN1
Related Commands
appn link-station
appn start link-station
appn stop port
Use appn stop port to deactivate APPN routing over a specified port.
appn stop port portname
Syntax Description
portname
|
The name of the port. Must be a Type A character string A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @.
|
Default
No default is provided for portname.
Command Mode
EXEC
Usage Guidelines
For a port deactivation to be successful, no APPN link station can be active on that port.
Example
The following example deactivates APPN routing over port TR0:
Related Commands
appn port
appn start port
backup-dlus (APPN control point)
Use the backup dlus APPN control point configuration command to specify the name of the default backup DLUS, which performs SSCP services for downstream PUs if the default DLUS is unable to provide the services. Use the no form of this command to delete the definition.
backup-dlus NETID.CPNAME
no backup-dlus
Syntax Description
NETID.CPNAME
|
Fully qualified network name. A fully qualified name is a string of 1 to 8 characters, followed by a period, followed by a string of 1 to 8 characters. The following characters are acceptable: A - Z, a - z 0 - 9 $ # @ The first character of either string must not be a number.
|
Default
This default state is no backup-dlus.
Command Mode
APPN control point configuration
Usage Guidelines
You must specify dlur and dlus (control-point) before you can specify backup-dlus. You can use the backup-dlus link station configuration command to override this command for a particular link station.
Example
The following example defines an APPN control point with a backup DLUS:
appn control-point CISCO.ROUTER
Related Commands
appn control-point
backup-dlus (APPN link station)
backup-dlus (APPN control point)
backup-dlus (APPN link station)
Use the backup-dlus APPN link station configuration command to specify the default backup DLUS node that provides SSCP services to the downstream PUs of the link in the event that the DLUS is unable to provide the DLUR function. Use the no form of this command to delete the definition.
backup-dlus NETID.CPNAME
no backup-dlus
Syntax Description
NETID.CPNAME
|
Fully qualified network name. A fully qualified name is a string of 1 to 8 characters, followed by a period, followed by a string of 1 to 8 characters. The following characters are acceptable: A - Z, a - z 0 - 9 $ # @ The first character of either string must not be a number.
|
Default
The default state is no backup-dlus.
Command Mode
APPN link station configuration
Usage Guidelines
You must specify the dlur and dlus APPN control point commands before you can specify backup-dlus. You can use the backup-dlus link station configuration command on the link station to override this command for that particular link station.
Example
The following example specifies the backup DLUS node for a link station:
appn link-station CISCO.HOST
lan-dest-address 0200.0000.1234
Related Commands
appn link-station
backup-dlus (APPN control point)
dlus (APPN control point)
dlus (APPN link station)
buffer-percent
Use the buffer-percent APPN control point configuration command to specify the percent of buffers that are reserved for use by APPN. Use the no form of this command to cancel the buffer reservation.
buffer-percent number
no buffer-percent
Syntax Description
number
|
The maximum percentage of I/O memory that APPN is allowed to allocate for buffers. The valid range is 1 to 100 percent.
|
Default
The default is 100 percent.
Command Mode
APPN control point configuration
Usage Guidelines
Use the buffer-percent command to ensure that APPN will not monopolize the router's buffers. If other protocols are to be routed through the local node, this command can be utilized to reserve buffers for protocols other than APPN.
Example
The following example limits APPN's buffer usage to 25% of the router's buffers:
appn control-point CISCO.ROUTER
Related Commands
A dagger (†) indicates that the command is documented in another chapter.
appn control-point
show buffers †
show memory †
class-of-service
Use the class-of-service APPN mode configuration command to specify the class of service that maps to a particular mode name. Use the no form of this command to delete the definition.
class-of-service cosname
no class-of-service
Syntax Description
cosname
|
The name of the class of service. Must be a Type A character string. A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @
|
Default
The default class-of-service name is #CONNECT.
Command Mode
APPN mode configuration
Usage Guidelines
LEN nodes use this node for network services. The mode name is passed in the BIND and this command is used to correlate the mode name to a class-of-service name.
Example
The following example defines a mode with class of service #INTER:
Related Command
appn mode
connect-at-startup
Use the connect-at-startup APPN link station configuration command to specify that the link will call out to the partner and attempt to bring up the link when the link's definition is complete. Use the no form of this command to delete the definition.
connect-at-startup
no connect-at-startup
Syntax Description
This command has no arguments or keywords.
Default
The default state is connect-at-startup.
Command Mode
APPN link station configuration
Usage Guidelines
Example
The following example deactivates call out for APPN link station ETHER12:
appn link-station ETHER12
lan-dest-address 0200.0000.4321
Related Command
appn link-station
cost-per-byte (APPN link station)
Use the cost-per-byte APPN link station configuration command to specify the cost-per-byte of transmitting a byte of data over this connection. Use the no form of this command to delete the definition.
cost-per-byte cost
no cost-per-byte
Syntax Description
cost
|
Number in the range 0 to 255.
|
Default
The default value specified in the appn port command.
Command Mode
APPN link station configuration
Usage Guidelines
Use this command to specify the relative cost to transmit a byte over the link. The relative cost per byte is used in route selection. Cost per byte may be specified at the port level, in which case it applies to all link stations that connect through the port. Cost per byte specified at the link station level overrides the cost per byte specified at the port level, and relates to the defined link station only. This value is compared to the values specified for a class of service to determine if this link can be used to support the class of service.
Example
The following example sets the cost per byte value to 10:
lan-dest-address 1000.2020.0211
Related Commands
appn link-station
cost-per-byte (APPN port)
show appn link-station
cost-per-byte (APPN port)
Use the cost-per-byte APPN port configuration command to specify the cost per byte of transmitting a byte of data through this port. Use the no form of this command to delete the definition.
cost-per-byte cost
no cost-per-byte
Syntax Description
cost
|
Number in the range 0 to 255.
|
Default
The default cost is 0.
Command Mode
APPN port configuration
Usage Guidelines
Specifying cost-per-byte at the port level applies to all link stations accessed through this port, unless cost-per-byte is specified on an individual appn link-station command. Specifying this on the appn link-station command overrides the port value. The cost is used in route selection for a particular class of service. Cost per byte specified at the link station level overrides the cost per byte specified at the port level, and relates to the defined link station only. This value is compared to the values specified for a class of service to determine if this link can be used to support the class of service.
Example
The following example sets the cost per byte value to 10:
Related Commands
appn port
cost-per-byte (APPN link station)
show appn port
cost-per-connect-time (APPN link station)
Use the cost-per-connect-tine APPN link station configuration command to specify the relative cost of the link. Use the no form of this command to delete the definition.
cost-per-connect-tine cost
no cost-per-connect-tine
Syntax Description
cost
|
Number in the range 0 to 255.
|
Default
The default value specified in the appn port command.
Command Mode
APPN link station configuration
Usage Guidelines
The relative cost of the link, which typically reflects the tariff of the transmission facility, is used in route selection. Cost per connect time may be specified at the port level, in which case it applies to all link stations that connect through the port. Cost per connect time specified at the link station level overrides the cost per connect time specified at the port level, and relates to the defined link station only. This value is compared to the values specified for a class of service to determine if this link can be used to support the class of service.
Example
The following example sets the cost per connect time to 100:
cost-per-connect-time 100
Related Commands
appn link-station
cost-per-connect-time (APPN port)
show appn link-station
cost-per-connect-time (APPN port)
Use the cost-per-connect-time APPN port configuration command to specify the cost per connect time. Use the no form of this command to delete the definition.
cost-per-connect-time cost
no cost-per-connect-time
Syntax Description
cost
|
Number in the range 0 to 255.
|
Default
The default cost is 0.
Command Mode
APPN port configuration
Usage Guidelines
Specifying cost-per-connect-time at the port level applies to all link stations accessed through this port, unless cost-per-connect-time is specified on an individual appn link-station command. Specifying this on the appn link-station command overrides the port value. The cost is used in route selection for a particular class of service. Cost per connect time specified at the link station level overrides the cost per connect time specified at the port level, and relates to the defined link station only. This value is compared to the values specified for a class of service to determine if this link can be used to support the class of service.
Example
The following example sets the cost per connect time to 100:
cost-per-connect-time 100
Related Commands
appn port
cost-per-connect-time (APPN link station)
show appn port
cp-cp-sessions-supported
Use the cp-cp-sessions-supported APPN link station configuration command to specify that a CP - CP session can be established over this connection. Use the no form of this command to specify that a CP - CP session can not be established over this link.
cp-cp-sessions-supported
no cp-cp-sessions-supported
Syntax Description
This command has no arguments or keywords.
Default
CP - CP sessions are supported.
Command Mode
APPN link station configuration
Usage Guidelines
The no form of this command must be specified for a link to a LEN node.
CP sessions to additional NNs are optional. Having fewer CP - CP sessions reduces the number of topology update messages and memory required, while increasing convergence time (the time required to update all network nodes).
Example
The following example specifies that no CP - CP sessions are supported:
lan-dest-address 0400.0000.2323
no cp-cp-sessions-supported
Related Commands
appn link-station
show appn link-station
verify-adjacent-node-type
desired-max-send-btu-size
Use the desired-max-send-btu-size APPN port configuration command to specify the maximum BTU size on this link. Use the no form of this command to delete the definition.
desired-max-send-btu-size size
no desired-max-send-btu-size
Syntax Description
size
|
Number in the range 99 to 32767.
|
Default
The default size is 1024 bytes.
Command Mode
APPN port configuration
Usage Guidelines
The MTU size must be big enough to accommodate the configured size of the BTU.
Example
The following example sets the maximum BTU size to 4000:
appn port TR0 TokenRing0/0
desired-max-send-btu-size 4000
Related Commands
A dagger (†) indicates the command is documented in another chapter.
appn port
mtu †
show appn port
dlur
Use the dlur APPN control point configuration command to specify that the Dependent LU Requestor (DLUR) function is supported on this CP. Use the no form of this command to delete the definition.
dlur
no dlur
Syntax Description
This command has no arguments or keywords.
Default
DLUR is not specified.
Command Mode
APPN control point configuration
Example
The following example specifies the DLUR function on the CP:
appn control-point CISCO.ROUTER
Related Commands
appn control-point
dlus (APPN control point)
show appn dlur-lu
show appn dlur-pu
show appn dlus
dlur-dspu-name
Use the dlur-dspu-name APPN link station configuration command to specify the name of the downstream PU connected by this link. Use the no form of this command to delete the definition.
dlur-dspu-name puname
no dlur-dspu-name
Syntax Description
puname
|
Type A character string. A Type A character string is a string of 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @
|
Default
No default name is specified.
Command Mode
APPN link station configuration
Usage Guidelines
The DLUR function requires the specification of the DSPU name for a PU2.0 node. Specification is also required when the DLUR function must activate the link to a PU2.1 or PU2.0 node, when driven by a host-initiated PU activation, and when the link to the PU is not active.
Example
The following example specifies the DSPU name of a downstream node:
lan-dest-address 1000.2020.0211
Related Commands
appn link-station
dlur
dlus (APPN link station)
dlus (APPN control point)
Use the dlus APPN control point configuration command to specify the name of the default Dependent LU Server (DLUS) that provides SSCP services to the downstream PUs. Use the no form of this command to delete the definition.
dlus netid.cpname
no dlus
Syntax Description
netid.cpname
|
Fully qualified CP name. A fully qualified name is a string of 1 to 8 characters, followed by a period, followed by a string of 1 to 8 characters. The following characters are acceptable: A - Z, a - z 0 - 9 $ # @ The first character of either string must not be a number
|
Default
No default DLUS is defined.
Command Mode
APPN control point configuration
Usage Guidelines
dlur must be specified in the CP command if dlus is specified. The name of the node-default DLUS should be specified when supporting downstream PUs that request or require ACTPUs, DLUR does not currently have an active session with the DLUS, and when no DLUS or back-up DLUS name has been provided on the APPN link station definition.
Example
The following example defines the DLUS:
appn control-point CISCO.ROUTER1
Related Commands
appn control-point
dlur
dlus (APPN link station))
show appn dlur-lu
dlus (APPN link station)
Use the dlus APPN link station configuration command to specify the name of the default Dependent LU Server (DLUS) node that provides SSCP services to the downstream PUs of this link station. Use the no form of this command to delete the definition.
dlus netid.cpname
no dlus
Syntax Description
netid.cpname
|
Fully qualified CP name. A fully qualified name is a string of 1 to 8 characters, followed by a period, followed by a string of 1 to 8 characters. The following characters are acceptable: A - Z, a - z 0 - 9 $ # @ The first character of either string must not be a number
|
Default
The default state is no dlus.
Command Mode
APPN link station configuration
Usage Guidelines
The dlus command is used to override the value of dlus specified in the control point definition.
Example
The following example specifies the DLUS for a specific APPN link station:
lan-dest-address 0200.0000.5678
Related Commands
appn control-point
dlur
dlus (APPN control point)
show appn dlus
effective-capacity (APPN link station)
Use the effective-capacity APPN link station configuration command to specify the bit rate for the connection. Use the no form of this command to delete the definition.
effective-capacity number
no effective-capacity
Syntax Description
number
|
Number in the range 0 to 100000000, specifying bits per second.
|
Default
The value specified in the appn port command.
Command Mode
APPN link station configuration
Usage Guidelines
The bit rate is compared to the class of service requirements when selecting routes. This can be specified on the link station command to identify the bit rate for this link station only. This value overrides the value specified on the port command. Effective capacity is used by the node to determine the least cost route for APPN intermediate sessions.
Example
The following example defines the effective capacity:
appn link-station FRLINK44
effective-capacity 4000000
Related Commands
appn link-station
effective-capacity (APPN port)
show appn link-station
effective-capacity (APPN port)
Use the effective-capacity APPN port configuration command to specify the effective capacity of a link. Use the no form of this command to delete the definition.
effective-capacity capacity
no effective-capacity
Syntax Description
capacity
|
Number in the range 0 to 100000000 specifying bits per second (bps).
|
Default
The default is media dependent:
Ethernet
|
10,000,000 bps
|
FDDI
|
100,000,000 bps
|
Frame Relay
|
56,000 bps
|
QLLC
|
56,000 bps
|
RSRB
|
56,000 bps
|
SDLC
|
56,000 bps
|
Token Ring
|
16,000,000 bps
|
Command Mode
APPN port configuration
Usage Guidelines
Specifying this command at the port level identifies the capacity for all link stations accessed through this port. Specifying this command on the link station command overrides the port value. This command also specifies the value for dynamically created transmission groups. The cost is used in route selection for a particular class of service.
Example
The following example defines the effective capacity:
effective-capacity 2000000
Related Commands
appn port
effective-capacity (APPN link station)
show appn port
fr-dest-address
Use the fr-dest-address APPN link station configuration command to specify the address of the partner node for Frame Relay links. Use the no form of this command to delete the definition.
fr-dest-address dlci [sap]
no fr-dest-address
Syntax Description
dlci
|
Number in the range 16 to 1007 that represents the DLCI, or virtual circuit, for a Frame Relay connection.
|
sap
|
1-byte hexadecimal number in the range 04 to ec, and divisible by 4.
|
Default
No default DLCI is provided.
The default SAP is 04 (hexadecimal)
Command Mode
APPN link station configuration
Usage Guidelines
The command should be specified only if the APPN port used by the link station is a Frame Relay port.
Example
The following example specifies DLCI 100:
appn link-station FRLNK100
Related Commands
appn link-station
lan-dest-address
sdlc-dest-address
show appn link-station
interrupt-switched
Use the interrupt-switched APPN control point configuration command to specify that ISR should be processed at the interrupt level.
interrupt-switched
no interrupt-switched
Syntax Description
This command has no arguments or keywords.
Default
The default state is no interrupt-switched.
Command Mode
APPN control point
Usage Guidelines
This command improves the performance of ISR routing. The command can be used only if segment size is the same on all nodes in the message path. Re-segmenting cannot be accomplished at the interrupt level. In addition, this command should only be used when routing between interfaces with similar speeds. This is because no pacing is done in the node when interrupt-switched is specified.
Example
The following example specifies that ISR should be processed at the interrupt level:
appn control-point CISCO.APPN1
Related Commands
appn control-point
show appn intermediate-session
lan-dest-address
Use the lan-dest-address APPN link station configuration command to specify the MAC address of the partner node. Use the no form of this command to delete the definition.
lan-dest-address lan-addr [sap]
no lan-dest-address
Syntax Description
lan-addr
|
12-byte hexadecimal number in the form xxxx.xxxx.xxxx
|
sap
|
1-byte hexadecimal number in the range 04 to ec, and divisible by 4.
|
Defaults
No default lan-addr is specified.
The default SAP is 04 (hexadecimal).
Command Mode
APPN link station configuration
Usage Guidelines
This command is required for interface types Token Ring, Ethernet, or FDDI. It is not allowed for other interface types.
Example
The following example sets the MAC address and SAP for a link to a partner node:
appn link-station LINK0001
lan-dest-address 1234.cfe0.9745 08
Related Commands
appn link-station
fr-dest-address
sdlc-dest-address
show appn link-station
limited-resource (APPN link station)
Use the limited-resource APPN link station configuration command to specify that the connection is to be taken down when no sessions are using it. Use the no form of this command to specify that the connection will remain active when no sessions are using it.
limited-resource
no limited-resource
Syntax Description
This command has no arguments or keywords.
Default