-
Bridging and IBM Networking Command Reference
-
About The Cisco IOS Software Documentation
-
Transparent Bridging Commands
-
Source-Route Bridging Commands
-
Remote Source-Route Bridging Commands
-
DLSw+ Configuration Commands
-
STUN and BSTUN Commands
-
LLC2 and SDLC Commands
-
IBM Network Media Translation Commands
-
DSPU and SNA Service Point Support Commands
-
SNA Frame Relay Access Support Commands
-
APPN Configuration Commands
-
NCIA Server Configuration Commands
-
IBM Channel Attach Commands
-
Ethernet Type Codes
-
Table Of Contents
backup-dlus (APPN control point)
backup-dlus (APPN link station)
cost-per-byte (APPN link station)
cost-per-connect-time (APPN link station)
cost-per-connect-time (APPN port)
effective-capacity (APPN link station)
effective-capacity (APPN port)
limited-resource (APPN link station)
port (APPN connection network)
propagation-delay (APPN link station)
retry-limit (APPN link station)
show appn intermediate-session
user-defined-1 (APPN link station)
user-defined-2 (APPN link station)
user-defined-3 (APPN link station)
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 Advanced Peer-to-Peer Networking" chapter of the Bridging and IBM Networking Configuration Guide.
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-nameSyntax Description
Default
No partner nodes are specified.
Command Mode
APPN link station configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
If the name configured with this command does not match the remote node's control point (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:
appn link-station APPN1port TR0lan-dest-address 1000.C4C1.E5C5adjacent-cp-name CISCO.APPN1completeRelated Commands
appn link-station
show appn link-stationappn 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 cosnameSyntax Description
Defaults
There is no default class of service name.
If this command is not issued, an IBM default COS 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
This command first appeared in Cisco IOS Release 11.0.
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 #SECUREnode-row 1 weight 5 congestion no no route-additional-resistance 0 255tg-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 255completeRelated Commands
node-row
show appn class-of-service
tg-row
transmission-priorityappn 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.cnnameSyntax Description
Default
No default connection network name is assigned.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.CAPPN1port TR0completeRelated Commands
port (APPN connection network)
show appn connection-networkappn 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.cpnameSyntax Description
Default
No default control point name is assigned.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.APPN1completeRelated 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-numberappn 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 linknameSyntax Description
linkname
Name that identifies the link station. The name must be a Type A string. A Type A character string contains 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
This command first appeared in Cisco IOS Release 11.0.
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 predefined 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:
appn link-station CISCO1port TR0lan-destination-address 0200.0000.0001completeRelated Commands
adjacent-cp-name
atm-dest-address
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)
ppp-dest-address
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
smds-dest-address
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-addressappn 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 modenameSyntax Description
modename
Name of the mode. A Type A character string. A Type A character string contains 1 to 8 of the following characters:
A - Z, a - z
0 - 9
$ # @
Default
IBM-defined [blank] mode
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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:
appn mode #BATCHclass-of-service #CONNECTcompleteRelated Commands
class-of-service
show appn modeappn 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.lunameSyntax Description
Default
No default netid.luname is specified. You must supply a value; otherwise, the configuration will fail.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.LU21owning-cp CISCO.CP2completeRelated Commands
owning-cp
serving-nn
show appn directory
wildcardappn port
Use the appn port global configuration command to define an APPN port and relate it to a previously defined interface.
appn port portname {interface | rsrb | vdlc}
no appn port portnameSyntax Description
Defaults
No default port name is specified. No default interface is provided. You must provide the port name and interface, or the configuration will fail.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.
If you configure APPN to run over DLSw+, you specify vdlc, and must also use the vdlc APPN port configuration command to identify which ring group the APPN VDLC port uses and, optionally, which virtual MAC address is used as the local MAC address identifying this APPN port.
Examples
The following example associates an APPN port named FDDI0 with FDDI interface 0:
appn port FDDI0 fddi0completeIn the following example, the appn port vdlc command creates an APPN VDLC port named "vdlcport," and the vdlc APPN port configuration command identifies the ring group (100) and VDLC virtual MAC address (4000.3745.000):
appn port VDLCPORT vdlcvdlc 100 vmac 4000.3745.0000completeRelated Commands
A dagger (†) indicates that the command is documented outside this 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
sdlc-sec-addr
security (APPN port)
service-any
show appn port
user-defined-1 (APPN port)
user-defined-2 (APPN port)
user-defined-3 (APPN port)
vdlc
x25-subaddressappn 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 routingSyntax Description
This command has no arguments or keywords.
Default
APPN routing is disabled.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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 activates APPN routing:
appn routingRelated Commands
appn control-point
appn start
appn stopappn 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
The APPN subsystem is disabled.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example activates APPN:
appn startRelated Commands
appn start link-station
Use the appn start link-station EXEC command to activate a logical APPN link.
appn start link-station linkname
Syntax Description
linkname
Name of the link-station. Must be a Type A character string. A Type A character string contains 1 to 8 of the following characters:
A - Z, a - z
0 - 9
$ # @
Default
No logical APPN links are activated.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example activates an APPN link station:
appn start link-station TR0Related Commands
appn link-station
appn stop link-station
show appn link-stationappn start port
Use the appn start port EXEC command to activate APPN routing over a particular port.
appn start port portname
Syntax Description
portname
Name of the port. Must be a Type A character string.
A Type A character string contains 1 to 8 of the following characters:
A - Z, a - z
0 - 9
$ # @
Default
No APPN routing is activated.
Command Mode
EXEC
Usage Guideline
This command first appeared in Cisco IOS Release 11.0.
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:
appn start port TR0Related Commands
appn port
appn stop port
show appn portappn stop
Use the appn stop EXEC command to 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
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following command deactivates APPN routing:
appn stopRelated Commands
appn control-point
appn routing
appn startappn 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
Name of the link station. The name must be a Type A character string. A Type A character string contains 1 to 8 of the following characters:
A - Z, a - z
0 - 9
$ # @
Default
This command has no default state.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following command deactivates an APPN link between the local node and an adjacent node:
appn stop link-station APPN1Related Commands
appn link-station
appn start link-stationappn stop port
Use the appn stop port EXEC command to deactivate APPN routing over a specified port.
appn stop port portname
Syntax Description
portname
Name of the port. Must be a Type A character string. A Type A character string contains 1 to 8 of the following characters:
A - Z, a - z
0 - 9
$ # @
Default
This command has no default state.
Command Mode
EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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:
appn stop port TR0Related Commands
atm-dest-address
Use the atm-dest-address APPN link station configuration command to specify the address of the partner node for ATM links. Use the no form of this command to delete the definition.
atm-dest-address pvc
no atm-dest-addressSyntax Description
Defaults
No default PVC or SAP are provided.
Command Mode
APPN link station configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.1.
The command should be specified only if the APPN port used by the link station is an ATM port. Note that for the Cisco 4500, the default maximum number of PVCs allowed is 32.
Example
The following example specifies ATM destination address 1:
interface ATM2/0atm pvc 1 1 12 aal5nlpidmap-group atm-appn2!appn control-point NETA.APPN2complete!appn port ATM ATM2/0complete!appn link-station ATMLINKport ATMatm-dest-address 1completeRelated Commands
appn link-station
lan-dest-address
sdlc-dest-address
show appn link-stationbackup-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-dlusSyntax Description
Default
No backup DLUS is specified.
Command Mode
APPN control point configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
You must specify dlur and dlus 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.ROUTERdlur max-pus 100dlus CISCO.APPN1backup-dlus CISCO.APPN2completeRelated Commands
appn control-point
backup-dlus (APPN link station)
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-dlusSyntax Description
Default
The default state is no backup-dlus.
Command Mode
APPN link station configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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.HOSTport FDDI0lan-dest-address 0200.0000.1234dlus CISCO.APPN1backup-dlus CISCO.APPN3completeRelated 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-percentSyntax Description
number
Maximum percentage of I/O memory that APPN is allowed to allocate for buffers. The valid range is 1 to 100 percent. The default is 100 percent.
Default
100 percent
Command Mode
APPN control point configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Use the buffer-percent command to ensure that APPN will not monopolize the buffers. If other protocols are to be routed through the local node, this command can reserve buffers for protocols other than APPN.
Example
The following example limits APPN's buffer usage to 25 percent of the device's buffers:
appn control-point CISCO.ROUTERbuffer-percent 25completeRelated Commands
A dagger (†) indicates that the command is documented outside this chapter.
appn control-point
show buffers †
show memory †central-resource-registration
Use the central-resource-registration APPN control point configuration command to enable the central resource registration function. Use the no form of this command to disable the central resource registration function.
central-resource-registration
no central-resource-registrationSyntax Description
This command has no arguments or keywords.
Default
The central resource registration function is enabled.
Command Mode
APPN control point configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.2.
By default, the central resource registration function is enabled in the router so that registration of downstream resources in the central directory server will be attempted by the router when it receives a request from the control point that owns the resource. If there is unpredictable behavior related to the central resource registration or central directory server, use the no central-resource-registration command to disable the central resource registration function. In normal circumstances there should not be any reason to disable the central resource registration function.
Example
The following example disables the central resource registration function:
appn control-point neta.routerno central-resource-registrationcompleteRelated Command
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-serviceSyntax Description
cosname
Name of the class of service. Must be a Type A character string. A Type A character string contains 1 to 8 of the following characters:
A - Z, a - z
0 - 9
$ # @The default is #CONNECT.
Default
The default class-of-service name is #CONNECT.
Command Mode
APPN mode configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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:
appn mode MAPPN1class-of-service #INTERcompleteRelated Command
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-startupSyntax Description
This command has no arguments or keywords.
Default
Connect-at-startup is enabled.
Command Mode
APPN link station configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example deactivates call out for APPN link station ETHER12:
appn link-station ETHER12appn port ETHER1lan-dest-address 0200.0000.4321no connect-at-startupcompleteRelated Command
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-byteSyntax Description
Default
The default value specified in the appn port command.
Command Mode
APPN link station configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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:
appn link-station CISCO1port RSRB1lan-dest-address 1000.2020.0211cost-per-byte 10completeRelated Commands
appn link-station
cost-per-byte (APPN port)
show appn link-stationcost-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-byteSyntax Description
Default
The default cost is 0.
Command Mode
APPN port configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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 value 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:
appn port FR0 serial 0cost-per-byte 100completeRelated Commands
appn port
cost-per-byte (APPN link station)
show appn portcost-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-time cost
no cost-per-connect-timeSyntax Description
Default
The default value specified in the appn port command.
Command Mode
APPN link station configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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:
appn link-station CISCO4port FDDI0cost-per-connect-time 100completeRelated Commands
appn link-station
cost-per-connect-time (APPN port)
show appn link-stationcost-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-timeSyntax Description
Default
The default cost is 0.
Command Mode
APPN port configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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 value 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:
appn port SDLC0 Serial1cost-per-connect-time 100completeRelated Commands
appn port
cost-per-connect-time (APPN link station)
show appn portcp-cp-sessions-supported
Use the cp-cp-sessions-supported APPN link station configuration command to specify that a control point-control point (CP-CP) session can be established over this connection. Use the no form of this command to specify that a CP-CP session cannot be established over this link.
cp-cp-sessions-supported
no cp-cp-sessions-supportedSyntax Description
This command has no arguments or keywords.
Default
CP-CP sessions are supported.
Command Mode
APPN link station configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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:
appn link-station FDDI41port FDDI1lan-dest-address 0400.0000.2323no cp-cp-sessions-supportedcompleteRelated Commands
appn link-station
show appn link-station
verify-adjacent-node-typedesired-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-sizeSyntax Description
Default
The default size is 1024 bytes.
Command Mode
APPN port configuration
Usage Guideline
This command first appeared in Cisco IOS Release 11.0.
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 tokenring 0/0desired-max-send-btu-size 4000completeRelated Commands
A dagger (†) indicates the command is documented outside this chapter.
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 [max-pus number]
no dlurSyntax Description
Defaults
If the dlur command is not specified, the DLUR function is not supported on this CP. If max-pus is not specified, there is no limit on the number of PUs served by this DLUR.
Command Mode
APPN control point configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Example
The following example specifies the DLUR function on the CPand specifies that the maximum number of PUs served by this DLUR is 100:
appn control-point CISCO.ROUTERdlur max-pus 100dlus CISCO.HOSTcompleteRelated Commands
appn control-point
dlus (APPN control point)
show appn dlur-lu
show appn dlur-pu
show appn dlusdlur-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 pu-name
no dlur-dspu-nameSyntax Description
pu-name
Type A character string. A Type A character string contains 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
This command first appeared in Cisco IOS Release 11.0.
The DLUR function requires the specification of the DSPU name for a PU 2.0 node. Specification is also required when the DLUR function must activate the link to a PU 2.1 or PU 2.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:
appn link-station LINK4port TR1lan-dest-address 1000.2020.0211dlur-dspu-name PU003334pu-type-20completeRelated 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 dlusSyntax Description
Default
No default DLUS is defined.
Command Mode
APPN control point configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
The dlur command must be specified if dlus is specified. The name of the node-default DLUS should be specified when supporting downstream PUs that request or require ACTPUs, when 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.ROUTER1dlurdlus CISCO.APPN1completeRelated Commands
appn control-point
dlur
dlus (APPN link station)
show appn dlur-ludlus (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 dlusSyntax Description
Default
No default DLUS is specified.
Command Mode
APPN link station configuration
Usage Guideline
This command first appeared in Cisco IOS Release 11.0.
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:
appn link-station LINK5port TR1lan-dest-address 0200.0000.5678dlus CISCO.APPN1completeRelated Commands
appn control-point
dlur
dlus (APPN control point)
show appn dluseffective-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 capacity
no effective-capacitySyntax Description
capacity
Number of bits per second in the range 0 to 100000000. The default is the value specified in the appn port command.
Default
The value specified in the appn port command.
Command Mode
APPN link station configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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 FRLINK44port FR0fr-dest-address 44effective-capacity 4000000completeRelated Commands
appn link-station
effective-capacity (APPN port)
show appn link-stationeffective-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-capacitySyntax Description
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 bpsCommand Mode
APPN port configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
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:
appn port FR0 serial 1/1effective-capacity 2000000completeRelated Commands
appn port
effective-capacity (APPN link station)
show appn portfr-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-addressSyntax Description