Router Products Command Reference
APPN Configuration Commands

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:

appn link-station APPN1
port TR0
lan-dest-address 1000.C4C1.E5C5
adjacent-cp-name CISCO.APPN1
complete

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
complete

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
port TR0
complete

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
complete

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:

appn link-station CISCO1
port TR0
lan-destination-address 0200.0000.0001
complete

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:

appn mode #BATCH
class-of-service #CONNECT
complete

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
owning-cp CISCO.CP2
complete

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:

appn port FDDI0 fddi0
complete

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:

appn routing

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:

appn start

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:

appn start 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:

appn stop

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:

appn stop 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
dlur
dlus CISCO.APPN1
backup-dlus CISCO.APPN2
complete

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
port FDDI0
lan-dest-address 0200.0000.1234
dlus CISCO.APPN1
backup-dlus CISCO.APPN3
complete

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
buffer-percent 25
complete

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:

appn mode MAPPN1
class-of-service #INTER
complete

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
appn port ETHER1
lan-dest-address 0200.0000.4321
no connect-at-startup
complete

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:

appn link-station CISCO1
port RSRB1
lan-dest-address 1000.2020.0211
cost-per-byte 10
complete

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:

appn port FR0 Serial0
cost-per-byte 100
complete

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:

appn link-station CISCO4
port FDDI0
cost-per-connect-time 100
complete

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:

appn port SDLC0 Serial1
cost-per-connect-time 100
complete

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:

appn link-station FDDI41
port FDDI1
lan-dest-address 0400.0000.2323
no cp-cp-sessions-supported
complete

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
complete

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
dlur
dlus CISCO.HOST
complete

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:

appn link-station LINK4
port TR1
lan-dest-address 1000.2020.0211
dlur-dspu-name PU003334
pu-type-20
complete

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
dlur
dlus CISCO.APPN1
complete

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:

appn link-station LINK5
port TR1
lan-dest-address 0200.0000.5678
dlus CISCO.APPN1
complete

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
port FR0
fr-dest-address 44
effective-capacity 4000000
complete

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:

appn port FR0 Serial1/1
effective-capacity 2000000
complete

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
port FR0
fr-dest-address 100
complete

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
interrupt-switched
complete

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
port ETHER1
lan-dest-address 1234.cfe0.9745 08
complete

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