-
Cisco IOS Release 12.0 Bridging and IBM Networking Command Reference
-
About the Cisco IOS Software Documentation
-
Using Cisco IOS Software
- Part 1: Bridging
-
Part 2: IBM Networking
-
Remote Source-Route Bridging Commands
-
DLSw+ Commands
-
Serial Tunnel and Block Serial Tunnel Commands
-
LLC2 and SDLC Commands
-
IBM Network Media Translation Commands
-
DSPU and SNA Service Point Commands
-
SNA Frame Relay Access Commands
-
APPN Configuration Commands
-
Cisco Database Connection Commands
-
NCIA Server Configuration Commands
-
Cisco Mainframe Channel Connection Commands
-
Airline Product Set Commands
-
- Part 3: Appendix
-
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
Use the commands in this chapter 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-name
Syntax Description
Defaults
No partner nodes are specified.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
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.
Examples
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
Assigns the name of an adjacent link station.
Displays information about the APPN link stations active on or defined to the local node.
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 return to the default. 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 (COS) name not among IBM default names. COS names 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
$ # @
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 Modes
Global configuration
Command History
Usage Guidelines
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.
Examples
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
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
Defaults
No default connection network name is assigned.
Command Modes
Global configuration
Command History
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.
Examples
The following example defines a connection network using APPN port TR0:
appn connection-network CISCO.CAPPN1port TR0completeRelated Commands
Specifies the ports that have visibility to the connection network.
Displays the APPN connection networks defined to the local node.
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
Defaults
No default control point name is assigned.
Command Modes
Global configuration
Command History
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.
Examples
The following example defines a control point named CISCO.APPN1:
appn control-point CISCO.APPN1completeRelated Commands
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 contains 1 to 8 of the following characters:
•
A-Z, a-z
•
•
Defaults
No default link station name is assigned.
Command Modes
Global configuration
Command History
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 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.
Examples
The following example defines a link station using port TR0:
appn link-station CISCO1port TR0lan-destination-address 0200.0000.0001completeRelated Commands
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 contains 1 to 8 of the following characters:
•
•
•
Defaults
IBM-defined [blank] mode
Command Modes
Global configuration
Command History
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.
Examples
The following example changes the IBM-defined mode #BATCH to use the #CONNECT class of service:
appn mode #BATCHclass-of-service #CONNECTcompleteRelated Commands
Specifies the class of service that maps to a particular mode name.
Displays information about the APPN modes defined to the local node.
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
Defaults
No default netid.luname is specified. You must supply a value; otherwise, the configuration will fail.
Command Modes
Global configuration
Command History
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.
Examples
The following example defines the location of an LU named CISCO.LU21:
appn partner-lu-location CISCO.LU21owning-cp CISCO.CP2completeRelated Commands
appn path-switch connection
Use the appn path-switch connection EXEC command to manually initiate a path switch if a better path exists.
appn path-switch connection rtp-connection-id
Syntax Description
Command Modes
EXEC
Command History
Examples
The following example initiates a path switch:
appn path-switch connection 8000000000A06278Related Commands
appn port
Use the appn port global configuration command to define an APPN port and relate it to a previously defined interface. Use the no form of this command to cancel the APPN port definition.
appn port portname {interface | rsrb | vdlc}
no appn port portname
Syntax 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 Modes
Global configuration
Command History
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.
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 fddi0completIn 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
appn routing
Use the appn routing global configuration command to indicate that APPN routing should be activated. Use the no form of this command to deactivate APPN routing.
appn routing
no appn routing
Syntax Description
This command has no arguments or keywords.
Defaults
APPN routing is disabled.
Command Modes
Global configuration
Command History
Usage Guidelines
For appn routing to complete successfully, an APPN control point must be configured using the appn control-point global configuration command.
Examples
The following example activates APPN routing:
appn routingRelated Commands
Specifies the fully qualified control point name for the node.
Activates the APPN subsystem in this node.
Deactivates APPN routing without affecting the current configuration.
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.
Defaults
The APPN subsystem is disabled.
Command Modes
EXEC
Command History
Examples
The following example activates APPN:
appn startRelated Commands
Indicates that APPN routing should be activated.
Deactivates APPN routing without affecting the current configuration.
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:
•
•
•
Defaults
No logical APPN links are activated.
Command Modes
EXEC
Command History
Examples
The following example activates an APPN link station:
appn start link-station TR0Related Commands
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
Name of the port. Must be a Type A character string.
A Type A character string contains 1 to 8 of the following characters:
•
•
•
Defaults
No APPN routing is activated.
Command Modes
EXEC
Command History
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.
Examples
The following example activates APPN routing over port TR0:
appn start port TR0Related Commands
appn 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.
Defaults
This command has no default state.
Command Modes
EXEC
Command History
Examples
The following example deactivates APPN routing:
appn stopRelated Commands
Specifies the fully qualified control point name for the node.
Indicates that APPN routing should be activated.
Activates the APPN subsystem in this node.
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
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:
•
•
•
Defaults
This command has no default state.
Command Modes
EXEC
Command History
Examples
The following example deactivates an APPN link between the local node and an adjacent node:
appn stop link-station APPN1Related Commands
appn 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:
•
•
•
Defaults
This command has no default state.
Command Modes
EXEC
Command History
Usage Guidelines
For a port deactivation to be successful, no APPN link station can be active on that port.
Examples
The following example deactivates APPN routing over port TR0:
appn stop port TR0Related Commands
Defines an APPN port and relates it to a previously defined interface.
Activates APPN routing over a particular port.
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 return to the default.
atm-dest-address pvc
no atm-dest-address
Syntax Description
Defaults
No default PVC or SAP are provided.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
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.
Examples
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
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
Defaults
No backup DLUS is specified.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
You must specify dlur and dlus APPN 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.
Examples
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
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 return to the default.
backup-dlus netid.cpname
no backup-dlus
Syntax Description
Defaults
The default state is no backup-dlus.
Command Modes
APPN link station configuration
Command History
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.
Examples
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
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
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.
Defaults
100 percent
Command Modes
APPN control point configuration
Command History
Usage Guidelines
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.
Examples
The following example limits APPN's buffer usage to 25 percent of the device's buffers:
appn control-point CISCO.ROUTERbuffer-percent 25completeRelated Commands
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-registration
Syntax Description
This command has no arguments or keywords.
Defaults
The central resource registration function is enabled.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
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.
Examples
The following example disables the central resource registration function:
appn control-point neta.routerno central-resource-registrationcompleteRelated Commands
Displays negative cache entries and the remaining time and threshold-count values.
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 return to the default.
class-of-service cosname
no class-of-service
Syntax 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:
•
•
•
The default is #CONNECT.
Defaults
The default class-of-service name is #CONNECT.
Command Modes
APPN mode configuration
Command History
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.
Examples
The following example defines a mode with class of service #INTER:
appn mode MAPPN1class-of-service #INTERcompleteRelated Commands
Specifies a new mode or changes an IBM-defined mode and identifies the class of service associated with the mode name.
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 return to the default.
connect-at-startup
no connect-at-startup
Syntax Description
This command has no arguments or keywords.
Defaults
Connect-at-startup is enabled.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
This command first appeared in Cisco IOS Release 11.0.
Examples
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 Commands
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 return to the default.
cost-per-byte cost
no cost-per-byte
Syntax Description
Defaults
The value specified in the appn port command.
Command Modes
APPN link station configuration
Command History
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.
Examples
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
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 return to the default.
cost-per-byte cost
no cost-per-byte
Syntax Description
Defaults
The default cost is 0.
Command Modes
APPN port configuration
Command History
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 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.
Examples
The following example sets the cost per byte value to 10:
appn port FR0 serial 0cost-per-byte 100completeRelated Commands
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 return to the default.
cost-per-connect-time cost
no cost-per-connect-time
Syntax Description
Defaults
The value specified in the appn port command.
Command Modes
APPN link station configuration
Command History
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.
Examples
The following example sets the cost per connect time to 100:
appn link-station CISCO4port FDDI0cost-per-connect-time 100completeRelated Commands
Assigns the name of an adjacent link station.
Specifies the cost per connect time.
Displays information about the APPN link stations active on or defined to the local node.
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 return to the default.
cost-per-connect-time cost
no cost-per-connect-time
Syntax Description
Defaults
The default cost is 0.
Command Modes
APPN port configuration
Command History
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 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.
Examples
The following example sets the cost per connect time to 100:
appn port SDLC0 Serial1cost-per-connect-time 100completeRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Specifies the relative cost of the link.
Displays information about the APPN ports active on the local node.
cp-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-supported
Syntax Description
This command has no arguments or keywords.
Defaults
CP-CP sessions are supported.
Command Modes
APPN link station configuration
Command History
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).
Examples
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
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 return to the default.
desired-max-send-btu-size size
no desired-max-send-btu-size
Syntax Description
Defaults
The default size is 1024 bytes.
Command Modes
APPN port configuration
Command History
Usage Guidelines
The MTU size must be big enough to accommodate the configured size of the BTU.
Examples
The following example sets the maximum BTU size to 4000:
appn port TR0 tokenring 0/0desired-max-send-btu-size 4000completeRelated Commands
dlur (appn)
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 return to the default.
dlur [max-pus number]
no dlur
Syntax 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 Modes
APPN control point configuration
Command History
Examples
The following example specifies the DLUR function on the CP and specifies that the maximum number of PUs served by this DLUR is 100:
appn control-point CISCO.ROUTERdlur max-pus 100dlus CISCO.HOSTcompleteRelated Commands
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 pu-name
no dlur-dspu-name
Syntax Description
pu-name
Type A character string. A Type A character string contains 1 to 8 of the following characters:
•
•
•
Defaults
No default name is specified.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
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.
Examples
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
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
Defaults
No default DLUS is defined.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
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.
Examples
The following example defines the DLUS:
appn control-point CISCO.ROUTER1dlurdlus CISCO.APPN1completeRelated Commands
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
Defaults
No default DLUS is specified.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
The dlus command is used to override the value of netid.cpname specified in the control point definition.
Examples
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
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 return to the default.
effective-capacity capacity
no effective-capacity
Syntax Description
capacity
Number of bits per second in the range 0 to 100000000. The default is the value specified in the appn port command.
Defaults
The value specified in the appn port command.
Command Modes
APPN link station configuration
Command History
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.
Examples
The following example defines the effective capacity:
appn link-station FRLINK44port FR0fr-dest-address 44effective-capacity 4000000completeRelated Commands
Assigns the name of an adjacent link station.
Specifies the effective capacity of a link.
Displays information about the APPN link stations active on or defined to the local node.
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 return to the default.
effective-capacity capacity
no effective-capacity
Syntax Description
Defaults
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 Modes
APPN port configuration
Command History
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.
Examples
The following example defines the effective capacity:
appn port FR0 serial 1/1effective-capacity 2000000completeRelated Commands
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 return to the default.
fr-dest-address dlci [sap]
no fr-dest-address
Syntax Description
Defaults
No default DLCI is provided.
The default SAP value is 04 (hexadecimal).
Command Modes
APPN link station configuration
Command History
Usage Guidelines
The command should be specified only if the APPN port used by the link station is a Frame Relay port.
Examples
The following example specifies DLCI 100:
appn link-station FRLNK100port FR0fr-dest-address 100completeRelated Commands
hpr (APPN control point)
Use the hpr APPN control point configuration command to specify that HPR is supported in this router. Use the no form of this command to disable HPR in this router.
hpr
no hpr
Syntax Description
This command has no arguments or keywords.
Defaults
HPR is not enabled.
Command Modes
APPN control point configuration
Command History
Examples
The following example enables HPR support for this router:
hprRelated Commands
Displays information about the local APPN control point.
Displays information about the RTP connections.
hpr (APPN link station)
Use the hpr APPN link station configuration command to specify that HPR is supported over the indicated link station. Use the no form of this command to disable HPR over the link station.
hpr
no hpr
Syntax Description
This command has no arguments or keywords.
Defaults
If the hpr command is not specified at the link station, then the default is the value configured for the corresponding port definition.
Command Modes
APPN link station configuration
Command History
Examples
The following example disables HPR support on the link station:
no hprRelated Commands
hpr (APPN port)
Use the hpr APPN port configuration command to specify that HPR is supported over the indicated port. Use the no form of this command to disable HPR over the link station.
hpr
no hpr
Syntax Description
This command has no arguments or keywords.
Defaults
If this command is not specified for a port, the default is the value configured for the control point definition.
Command Modes
APPN port configuration
Command History
Examples
The following example disables HPR support on port:
no hprRelated Commands
hpr max-sessions
Use the hpr max-sessions APPN control point configuration command to specify the maximum number of sessions allowed over an RTP connection. Use the no form of this command to cancel the specification.
hpr max-sessions num-sessions
no hpr max-sessions
Syntax Description
num-sessions
Maximum number of sessions allowed over an RTP connection. The valid range is 1 to 65535. The default is 65535.
Defaults
The default maximum number of sessions allowed is 65535.
Command Modes
APPN control point configuration
Command History
Examples
The following example sets the maximum number of sessions allowed over an RTP session to 32:
hpr max-sessions 32Related Commands
Displays information about the local APPN control point.
Displays information about the RTP connections.
hpr retries
Use the hpr retries APPN control point configuration command to specify the number of times to retry sending a packet before initiating a path switch of the RTP connection. Use the no form of this command to cancel the specification.
hpr retries low-retries medium-retries high-retries network-retries
no hpr retries
Syntax Description
Defaults
The default for all four retry values is 6.
Command Modes
APPN control point configuration
Command History
Examples
The following example sets the HPR retry values:
hpr retries 10 6 4 2Related Commands
hpr sap
Use the hpr sap APPN port configuration command to specify the SAP for automatic network routing frames. Use the no form of this command to cancel the SAP specification and revert to the default SAP.
hpr sap sap
no hpr sap
Syntax Description
sap
SAP value, in hexadecimal, used for automatic network routing frames. Valid hexadecimal values are even numbers in the range 0x02 to 0xFE. The default SAP value is 0xc8.
Defaults
The default SAP value is 0xc8.
Command Modes
APPN port configuration
Command History
Usage Guidelines
The SAP value is configured on the port and is used by all link stations that use that port.
Examples
The following example specifies a SAP value of 0x02:
hpr sap 0x02Related Commands
Displays information about the APPN ports active on the local node.
Displays information about the RTP connections.
hpr timers liveness
Use the hpr timers liveness APPN control point configuration command to specify how many seconds to wait for a packet to be received before initiating a path switch. Use the no form of this command to cancel the timers.
hpr timers liveness low-time medium-time high-time network-time
no hpr timers liveness
Syntax Description
Defaults
The default for each of the four time values is 45 seconds.
Command Modes
APPN control point configuration
Command History
Examples
The following example sets the HPR liveness timers:
hpr timers liveness 180 120 60 30Related Commands
hpr timers path-switch
Use the hpr timers path-switch APPN control point configuration command to specify the amount of time allowed to attempt a path switch for an RTP connection. Use the no form of this command to cancel the specification.
hpr timers path-switch low-time medium-time high-time network-time
no hpr timers
Syntax Description
Defaults
The default time allowed to attempt a low-priority RTP connection is 480 seconds.
The default time allowed to attempt a medium-priority RTP connection is 240 seconds.
The default time allowed to attempt a high-priority RTP connection is 120 seconds.
The default time allowed to attempt a network-priority connection is 60 seconds.
Command Modes
APPN control point configuration
Command History
Examples
The following example sets the HPR path switch timers:
hpr timers path-switch 1200 600 300 120interrupt-switched
Use the interrupt-switched APPN control point configuration command to specify that ISR should be processed at the interrupt level. Us the no form of this command to cancel the specification.
interrupt-switched
no interrupt-switched
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
APPN control point
Command History
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.
Examples
The following example specifies that ISR should be processed at the interrupt level:
appn control-point CISCO.APPN1interrupt-switchedcompleteRelated Commands
Specifies the fully qualified control point name for the node.
Displays information about the SNA sessions that are currently being routed through the local node.
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 return to the default.
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
(Optional) 1-byte hexadecimal number in the range 04 to EC, and divisible by 4. The default SAP value is 04 (hexadecimal).
Defaults
No default lan-addr is specified.
The default SAP value is 04 (hexadecimal).
Command Modes
APPN link station configuration
Command History
Usage Guidelines
This command is required for interface types Token Ring, Ethernet, or FDDI. It is not allowed for other interface types.
Examples
The following example sets the MAC address and SAP for a link to a partner node:
appn link-station LINK0001port ETHER1lan-dest-address 1234.cfe0.9745 08completeRelated Commands
limited-resource (APPN link station)
Use the limited-resource APPN link station configuration command to specify that the connection 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.
Defaults
The value specified in the appn port command.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
This command identifies a link that has a higher cost or is a switched connection and should not remain active if no resource is using the link. The limited-resource command issued at the APPN link station level overrides the same command issued at the APPN port level.
Examples
The following example specifies that the link be taken down when no sessions are active:
appn link-station FRLINK34port FR1fr-dest-address 34limited-resourcecompleteRelated Commands
limited-resource (APPN port)
Use the limited-resource APPN link station configuration command to specify that the link be taken down when no sessions are using the link. Use the no form of this command to specify that the link will remain active when no sessions are using the link.
limited-resource
no limited-resource
Syntax Description
This command has no arguments or keywords.
Defaults
The default is no limited resource.
Command Modes
APPN port configuration
Command History
Usage Guidelines
This command identifies a link that has a higher cost or is a switched connection and should not remain active if no resource is using the link. This command applies to all link stations accessed through this port. Specifying limited resource at the link station level overrides this command.
Examples
The following example activates limited resource:
appn port FR0 serial 0/2limited-resourcecompleteRelated Commands
link-queuing
Use the link-queuing APPN link station configuration command to specify queuing options and parameters for the link station. Use the no form of this command to cancel the option.
link-queuing {priority level | custom queue-number}
no link-queuing
Syntax Description
Defaults
No default priority number is assigned.
Command Modes
APPN link station configuration
Command History
Examples
The following example specifies medium priority level queuing for the link station:
link-queuing mediumRelated Commands
Displays information about the APPN link stations active on or defined to the local node.
local-sap
Use the local-sap APPN port configuration command to specify the local service access point (SAP) to activate on the interface. Use the no form of this command to return to the default.
local-sap sap
no local-sap
Syntax Description
Defaults
The default local SAP is 04 (hexadecimal).
Command Modes
APPN port configuration
Command History
Examples
The following example specifies the local SAP:
appn port TR0 tokenring 0local-sap 44completeRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
locate-queuing
Use the locate-queuing APPN control point configuration command to enable the locate throttling feature on this control point and prevent multiple broadcast locate searches to the same destination LU. Use the no form of this command to disable the locate throttling feature.
locate-queuing
no locate-queuing
Syntax Description
This command has no arguments or keywords.
Defaults
Locate queuing is disabled.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
When the locate-queuing command is enabled, it is applied at the network node server only for locate search requests from its end node.
Examples
The following example enables the locate throttling feature:
locate-queuingRelated Commands
max-cached-entries
Use the max-cached-entries APPN control point configuration command to specify the maximum number of cached directory entries. Use the no form of this command to return to the default.
max-cached-entries number
no max-cached-entries
Syntax Description
number
Maximum number of cached directory entries. The valid range is 0 to 32767. The default is 255.
Defaults
255 cached directory entries
Command Modes
APPN control point configuration
Command History
Usage Guidelines
This command enables you to balance memory usage and performance. A large number requires more memory, but reduces the number of network broadcasts. Cached directory entries are created as nodes learn locations of other network resources. This command affects cached entries only. A value of zero still allows location of node, but broadcasts are required.
Examples
The following example specifies the maximum number of cached directory entries:
appn control-point CISCO.ROUTERmax-cached-entries 100completeRelated Commands
Specifies the fully qualified control point name for the node.
Displays information about the local APPN control point.
max-cached-trees
Use the max-cached-trees APPN control point configuration command to specify the maximum number of cached class of service routing trees. Use the no form of this command to return to the default.
max-cached-trees numbe
no max-cached-trees
Syntax Description
number
Maximum number of cached class of service routing trees. The valid range is 0 to 32767. The default is 20.
Defaults
20 class of service routing trees
Command Modes
APPN control point configuration
Command History
Usage Guidelines
This command allows you to balance memory usage and performance. Each cached tree represents all paths through the network for a class of service. If you specify a lower number, fewer will be caches and longer processing time may be required to calculate the paths through the network and select a route.
Examples
The following example specifies the maximum number of cached topology trees:
appn control-point CISCO.ROUTERmax-cached-trees 5completeRelated Commands
Specifies the fully qualified control point name for the node.
Displays information about the local APPN control point.
maximum-memory
Use the maximum-memory APPN control point configuration command to specify the maximum amount of memory available to APPN. Use the no form of this command to cancel the specification.
maximum-memory bytes
no maximum-memory
Syntax Description
bytes
Maximum amount of memory (in bytes) available to APPN. The valid range is 3000000 to 64000000 bytes. The default is that APPN has access to all memory.
Defaults
The default is that APPN has access to all memory.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
This command ensures that APPN will not monopolize the memory of the device and that other protocols being routed will have memory available.
Examples
The following example specifies the maximum amount of memory available to APPN as 16000000 bytes (16 MB):
appn control-point CISCO.APPN1maximum-memory 16000000completeRelated Commands
max-link-stations
Use the max-link-stations APPN port configuration command to specify the maximum number of active link stations allowed on this port. Use the no form of this command to return to the default.
max-link-stations number
no max-link-stations
Syntax Description
number
Number in the range 1 to 255. Must be greater than or equal to the sum of reserved-inbound and reserved-outbound. The default is media dependent.
Defaults
The default is media dependent:
Ethernet—255
FDDI—255
Frame Relay—255
QLLC—1
RSRB—255
SDLC—1
Token Ring—255
Command Modes
APPN port configuration
Command History
Usage Guidelines
For leased negotiable lines, the maximum value is 1.
For leased primary lines, not multidrop, the maximum value is 1 and inbound is 0.
For leased secondary lines and switched lines the maximum value is 1.
Examples
The following example sets the maximum link stations:
appn port TR01 tokenring 0/1max-link-stations 10completeRelated Commands
max-rcv-btu-size
Use the max-rcv-btu-size APPN port configuration command to specify the desired maximum receive BTU. Use the no form of this command to return to the default.
max-rcv-btu-size size
no max-rcv-btu-size
Syntax Description
Defaults
1024 bytes
Command Modes
APPN port configuration
Command History
Usage Guidelines
The BTU specifies a maximum message size at the physical layer, similar to the MTU in TCP/IP. Do not confuse BTU with MAXRU, which is session related.
Examples
The following example sets the maximum BTU value to 500:
appn port TR11 tokenring1/1max-rcv-btu-size 500completeRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
minimum-memory
Use the minimum-memory APPN control point configuration command to specify the minimum amount of memory available to APPN. Use the no form of the command to cancel the specification.
minimum-memory bytes
no minimum-memory
Syntax Description
bytes
Maximum amount of memory (in bytes) available to APPN. The valid range is 1000000 to 64000000. The default is 1000000 bytes.
Defaults
The default is 1000000 bytes.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
This command ensures that APPN will always have a specified amount of memory. Memory that is dedicated to APPN will not be available for other processing.
Examples
The following example reserves 10000000 bytes (10 MB) of memory for APPN:
appn control-point CISCO.APPN1minimum-memory 10000000completeRelated Commands
Specifies the fully qualified control point name for the node.
Specifies the maximum amount of memory available to APPN.
negative-caching
Use the negative-caching APPN control point configuration command to specify that the negative caching feature is enabled on this control point. Use the no form of this command to disable the negative caching feature.
negative-caching [time] time [threshold] threshold-value
no negative-caching
Syntax Description
Defaults
Negative caching is disabled.
The default time is 60 seconds.
The default threshold is 20 locate searches.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
When negative caching is enabled, it is applied at the network node server only for locate search requests from its end node.
Examples
The following example configures the negative caching feature to specify that requests for unreachable resources will be retained in the directory database for 30 seconds or until 10 locate search requests have been made:
negative-caching time 30 threshold 10Related Commands
node-row
Use the node-row APPN class of service configuration command to specify a node description or node row, and associated weights defined for this class of service. Use the no form of this command to delete a previous node row description.
node-row index weight weight congestion {yes | no} {yes | no} route-additional-resistance min max
no node-row index
Syntax Description
Defaults
No default node row is specified.
No default weight is specified.
The default congestion tolerance is no no.
The default route additional resistance is 0 0.
Command Modes
APPN class of service configuration
Command History
Usage Guidelines
You can define up to eight rows. Each row represents the characteristics of a node that meets the requirements for this class of service and defines a weight for the node that will be used in calculating the cost of a total route.
If the congestion maximum is set to "no," the congestion minimum must also be set to "no."
Examples
The following example defines an APPN class of service with one node 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
Defines an APPN class of service that is not an IBM-supplied default.
Displays the APPN classes of service defined to the local node.
null-xid-poll
Use the null-xid-poll APPN port configuration command to specify that the null XID should be used to poll the remote node associated with this APPN port. Use the no form of the command to cancel the specification.
null-xid-poll
no null-xid-poll
Syntax Description
This command has no arguments or keywords.
Defaults
XID3 negotiation is used to poll remote devices.
Command Modes
APPN port configuration
Command History
Usage Guidelines
The null-xid-poll command permits PU 2.0 devices that connect in with XID0 to build a dynamic link station. It is no longer necessary to configure a link definition. When this command is used, the router expects its partner to reveal its identity first by responding with either XID3 or XID0.
This feature works in a mixed environment of PU 2.0 and PU 2.1 devices where the same APPN port is shared by both types of devices. By default, XID3 is used to poll the devices. When a PU 2.0 device responds with XID0, the link is created and established dynamically. PU 2.1 devices are not affected by this change, and go through the XID3 negotiation as usual.
Some care must be exercised when configuring null-xid-poll: If two Cisco APPN network node routers connect across ports configured with null-xid-poll, the APPN connection will fail because both routers expect the other to respond first using either XID0 or XID3. Similar behavior may occur when a port configured with null-xid-poll attempts communication with a front-end processor configured for XID polling. You only need to configure null-xid-poll when dealing with a PU 2.0 device that does not respond gracefully to the XID3 poll.
Examples
The following example specifies that null XID should be used to poll the remote nodes associated with the APPN port FDDI0:
appn port FDDI0 fddi 0null-xid-pollcompleteRelated Commands
owning-cp
Use the owning-cp APPN partner LU location configuration command to specify the name of the CP that owns the partner LU. Use the no form of this command to delete the definition.
owning-cp netid.cpname
no owning-cp
Syntax Description
Defaults
No default name is assigned.
Command Modes
APPN partner LU location configuration
Command History
Usage Guidelines
The netid.cpname argument must be unique in the network and must match the name specified as control point on the specific node.
Examples
The following example sets the owning CP name:
appn partner-lu-location CISCO.LU000012owning-cp CISCO.CP00001completeRelated Commands
port (APPN connection network)
Use the port APPN connection network configuration command to specify the ports that have visibility to the connection network. Use the no form of this command to delete the definition.
port portname
no port portname
Syntax Description
portname
Type A name. A Type A character string contains 1 to 8 of the following characters:
•
•
•
Defaults
No default port name is assigned.
Command Modes
APPN connection network configuration
Command History
Usage Guidelines
Up to five ports can be specified by repeating the command. Port names must be previously defined by the appn port command.
Examples
The following example specifies an APPN connection network with one port:
appn connection-network CISCO.CN1port TR0completeRelated Commands
port (APPN link station)
Use the port APPN link station configuration command to specify the port that can be used to access the link station. Use the no form of this command to delete the definition.
port portname
no port
Syntax Description
Defaults
No default port is specified.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
The portname argument must be a value defined in a previous appn port command. The port command is required to define an APPN link station.
Examples
The following example defines the port:
appn link-station FDDILINKport FDDI0lan-dest-address 0200.0000.cfbdcompleteRelated Commands
ppp-dest-address
Use the ppp-dest-address APPN link station configuration command to specify the remote SAP of a node across a PPP interface. Use the no form of this command to return to the default.
ppp-dest-address sap
no ppp-dest-address
Syntax Description
Defaults
The default SAP is 04 hexadecimal.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
The command should be specified only if the APPN port used by the link station is a PPP port.
Related Commands
Assigns the name of an adjacent link station.
Displays information about the APPN link stations active on or defined to the local node.
propagation-delay (APPN link station)
Use the propagation-delay APPN link station configuration command to specify the amount of inherent delay of the connection. Use the no form of this command to return to the default.
propagation-delay {minimum | lan | telephone | packet-switched | satellite | maximum}
no propagation-delay
Syntax Description
Defaults
The value specified in the appn port command.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
The inherent delay is used in route selection by comparing this value to the value requested for a particular class of service. This value supersedes any value specified on the appn port command. Propagation delay is used by the node to determine the least cost route for APPN intermediate sessions.
Examples
The following example specifies a delay of less than 480 microseconds:
appn link-station FRLINK12port FR1propagation-delay lancompleteRelated Commands
Assigns the name of an adjacent link station.
Displays information about the APPN link stations active on or defined to the local node.
propagation-delay (APPN port)
Use the propagation-delay APPN port configuration command to specify the propagation delay of the link. Use the no form of this command to return to the default.
propagation-delay {minimum | lan | telephone | packet-switched | satellite | maximum}
no propagation-delay
Syntax Description
Defaults
The default is media dependent:
Ethernet—lan
FDDI—lan
Frame Relay—packet-switched
QLLC—packet-switched\
RSRB—packet-switched
SDLC—telephone
Token Ring—lan
Command Modes
APPN port configuration
Command History
Usage Guidelines
This command applies to all link stations accessed through this port. Specifying propagation delay at the link station level overrides this command. The value of propagation delay is used by the node to determine the least cost route for APPN intermediate sessions.
Examples
The following example specifies a delay of less than 480 microseconds:
appn port FR1 Serial1/1propagation-delay lancompleteRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
pu-type-20
Use the pu-type-20 APPN link station configuration command to indicate that the downstream PU whose dependent LU request is propagated through the link is a PU type 2.0. Use the no form of this command or omit this command to indicate that the downstream PU is a type 2.1.
pu-type-20
no pu-type-20
Syntax Description
This command has no arguments or keywords.
Defaults
The downstream PU is defined as a PU type 2.1.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
This command is normally used in conjunction with the dlur-dspu-name link-station configuration command.
Examples
The following example indicates that the downstream PU is a PU type 2.0:
appn link-station LINK0001port TR0lan-dest-address 1000.4521.9812pu-type-20dlur-dspu-name PU009812completeRelated Commands
reserved-inbound
Use the reserved-inbound APPN port configuration command to specify the number of link stations (out of max-link-stations) to be reserved for inbound links (partner initiates). Use the no form of this command to return to the default.
reserved-inbound number
no reserved-inbound
Syntax Description
Defaults
No link stations are reserved for inbound links.
Command Modes
APPN port configuration
Command History
Usage Guidelines
The total of reserved-inbound plus reserved-outbound must be less than or equal to the maximum number of link station allowed on the port. This value is configured using the max-link-stations command.
Examples
The following example sets the number of link stations reserved for inbound links to 50:
appn port TR0 tokenring 0reserved-inbound 50completeRelated Commands
reserved-outbound
Used the reserved-outbound APPN port configuration command to specify the number of link stations (of max-link-stations) to be reserved for outbound link stations where this node initiates the connection. Use the no form of this command to return to the default.
reserved-outbound number
no reserved-outbound
Syntax Description
Defaults
No link stations are reserved for outbound links.
Command Modes
APPN port configuration
Command History
Usage Guidelines
The total of reserved-inbound plus reserved-outbound must be less than or equal to the maximum number of link station allowed on the port. This value is configured using the max-link-stations command.
Examples
The following example sets the number of link stations reserved for outbound links to 50:
appn port TR1 tokenring 1reserved-outbound 50completeRelated Commands
retry-limit (APPN link station)
Use the retry-limit APPN link station configuration command to specify the number of times a link station attempts reactivation after failure. Use the no form of this command to specify the default.
retry-limit {retries | infinite [interval]}
no retry-limit
Syntax Description
Defaults
The default number of retries is 5.
The default amount of time is 30 seconds.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
This value supersedes any value specified in the appn port command.
Examples
The following example specifies 25 retries for APPN link station LINK12:
appn link-station LINK12port FDDI1lan-dest-address 4000.0211.4567retry-limit 25completeRelated Commands
Assigns the name of an adjacent link station.
Displays information about the APPN link stations active on or defined to the local node.
retry-limit (APPN port)
Use the retry-limit APPN port configuration command to specify how many times a line will attempt reactivation after failure. Use the no form of this command to delete the previous definition.
retry-limit {retries | infinite} [interval]
no retry-limit
Syntax Description
Defaults
The default number of retries is 5.
The default amount of time is 30 seconds.
Command Modes
APPN port configuration
Command History
Usage Guidelines
This command applies to all link stations accessed through this port. Specifying a retry limit at the link station level overrides this command.
Examples
The following example specifies 25 retries:
appn port ETHER0 ethernet 0retry-limit 25completeRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
role (APPN link station)
Use the role APPN link station configuration command to specify the link station role used in XID negotiations. Use the no form of this command to return to the default.
role {negotiable | primary | secondary}
no role
Syntax Description
Defaults
The value specified in the appn port command.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
This command overrides the value specified on the port definition.
Examples
The following example sets the role to primary:
appn link-station LINK44port ETHER1lan-dest-address 0200.98ab.de23role primarycompleteRelated Commands
Assigns the name of an adjacent link station.
Displays information about the APPN link stations active on or defined to the local node.
role (APPN port)
Use the role APPN port configuration command to specify the link station role used in XID negotiations for all link stations defined through this port. Use the no form of this command to return to the default.
role {negotiable | primary | secondary}
no role
Syntax Description
Defaults
The default role is negotiable.
Command Modes
APPN port configuration
Command History
Usage Guidelines
This command applies to all link stations accessed through this port. Specifying a role at the link station overrides this command.
Examples
The following example sets the role to primary:
appn port FDDI0 fddi 0role primarycompleteRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
route-additional-resistance
Use the route-additional-resistance APPN control point configuration command to specify an arbitrary value for the local node. Use the no form of this command to return to the default.
route-additional-resistance number
no route-additional-resistance
Syntax Description
Defaults
The default resistance value is 128.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
The route additional resistance value is included in topology updates and is used by network nodes to select a least-cost path associated with a particular class of service. You use this command to assign an arbitrary value and to indicate preference or nonpreference for particular nodes in route paths.
Examples
The following example specifies a route additional resistance value of 200:
appn control-point CISCO.ROUTERroute-additional-resistance 200completeRelated Commands
Specifies the fully qualified control point name for the node.
Displays information about the local APPN control point.
rsrb-virtual-station
Use the rsrb-virtual-station APPN port configuration command to configure APPN for remote source-route bridging. Use the no form of this command to delete the configuration.
rsrb-virtual-station mac-address local-ring bridge-number target-ring
no rsrb-virtual-station
Syntax Description
Defaults
No defaults are defined.
Command Modes
APPN port configuration
Command History
Examples
The following example defines an APPN port that uses RSRB as a transport protocol:
appn port rsrbrsrb-virtual-station 1234.1234.1234 50 1 60completeRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
safe-store-cycle
Use the safe-store-cycle APPN control point configuration command to specify the number of cache instances to be saved. Use the no form of this command to delete the previous definition.
safe-store-cycle number
no safe-store-cycle
Syntax Description
Defaults
The default is 2.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
The file naming convention used for the cache instances is
control-point-name.dnnwhere nn is a number in the range from 00 to the cycle number specified. The files that will be generated in the example are:
APPN1.d00APPN1.d01APPN1.d02APPN1.d03Examples
The following example specifies that three cache instances will be saved:
appn control-point CISCO.APPN1safe-store-host ip-address 171.69.44.1 directory appnsafesafe-store-cycle 3completeRelated Commands
safe-store-host
Use the safe-store-host APPN control point configuration command to specify the IP host address and the file path for safe store. Use the no form of this command to delete the previous definition.
safe-store-host ip-address address directory path
no safe-store-host
Syntax Description
Defaults
No defaults are assigned.
Command Modes
APPN control point configuration
Command History
Usage Guidelines
Some TFTP hosts might require you to create the file entries in advance. Refer to the safe-store-cycle command reference entry for the file naming convention.
Examples
The following example specifies that the IP host address and the file path where the database will be stored:
appn control-point CISCO.APPN1safe-store-host ip-address 171.69.44.1 directory appnsafesafe-store-cycle 3completeRelated Commands
safe-store-interval
Use the safe-store-interval APPN control point configuration command to specify how often the directory database is stored to permanent media. Use the no form of this command to delete the previous definition.
safe-store-interval interval
no safe-store-interval
Syntax Description
interval
Interval in minutes between storage of the directory database to permanent media. The valid range is 0 to 32767 minutes. The default is 20 minutes.
Defaults
20 minutes
Command Modes
APPN control point configuration
Command History
Usage Guidelines
This command allows you to balance processor usage with potential performance savings. A longer interval reduces the processor cycles used to save data, but potentially reduces the validity of the data due to less frequent updates.
Examples
The following example specifies that the database will be stored to permanent media every 30 minutes:
appn control-point CISCO.APPN1safe-store-host ip-address 171.69.44.1 directory appnsafesafe-store-interval 30completeRelated Commands
sdlc-dest-address
Use the sdlc-dest-address APPN link station configuration command to specify the local address of the partner node for nonswitched SDLC. Use the no form of this command to return to the default.
sdlc-dest-address address
no sdlc-dest-address address
Syntax Description
Defaults
No default address is assigned.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
This command is optional if the interface type is switched SDLC. It is not allowed for other interface types.
Examples
The following example assigns address F1:
appn link-station LINK12port SDLC1sdlc-dest-address f1completeRelated Commands
Assigns the name of an adjacent link station.
Displays information about the APPN link stations active on or defined to the local node.
sdlc-sec-addr
Use the sdlc-sec-addr command to configure APPN for SDLC. Use the no form of this command to delete the configuration.
sdlc-sec-addr sdlc-address
no sdlc-sec-addr
Syntax Description
Defaults
The default address is 00.
Command Modes
APPN port configuration
Command History
Examples
The following example defines a port with a local SDLC address of 2.
appn port serial 1sdlc-sec-addr 2completeRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
security (APPN link station)
Use the security APPN link station configuration command to specify the security level of the connection. Use the no form of this command to delete the previous definition.
security security-level
no security
Syntax Description
Defaults
The default value specified in the appn port command.
Command Modes
APPN link station configuration
Command History
Usage Guidelines
The security level is used in route selection.
Examples
The following example sets the security level to encrypted:
appn link-station LINK12security encryptedcompleteRelated Commands
Assigns the name of an adjacent link station.
Displays information about the APPN link stations active on or defined to the local node.
security (APPN port)
Use the security APPN port configuration command to specify security level of the connection. Use the no form of this command to delete the previous definition.
security security-level
no security
Syntax Description
security-level
One of the following keywords:
•
•
•
•
•
•
•
The default is nonsecure.
Defaults
The default security is nonsecure.
Command Modes
APPN port configuration
Command History
Usage Guidelines
The command applies to all link stations accessed through this port. Specifying security at the link station level overrides this command.
Examples
The following command sets the security level to encrypted:
appn port TR0 tokenring 0security encryptedcompleteRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
service-any
Use the service-any APPN port configuration command to specify that this port will create dynamic transmission groups for outbound or inbound links. Use the no form of this command to specify that the link station must be defined through configuration commands.
service-any
no service-any
Syntax Description
This command has no arguments or keywords.
Defaults
The default state is service-any.
Command Modes
APPN port configuration
Command History
Usage Guidelines
Specifying no service-any serves as a security mechanism to control who may or may not connect to the local node.
Examples
The following example deactivates service any:
appn port FDDI0 fddi0no service-anycompleteRelated Commands
Defines an APPN port and relates it to a previously defined interface.
Displays information about the APPN ports active on the local node.
serving-nn
Use the serving-nn APPN partner LU location configuration command to specify the name of the network node server servicing the partner LU. Use the no form of this command to return to the default.
serving-nn netid.cpname
no serving-nn
Syntax Description
Defaults
The CP name of the local network node.
Command Modes
APPN partner LU location configuration
Command History
Usage Guidelines
The serving-nn may be specified as null if the LU name is specified as null. This specification indicates a wildcard definition for all LUs.
Examples
The following example specifies the name of the network node server for the partner LU CISCO.APPN1:
appn partner-lu-location CISCO.LU000012serving-nn CISCO.APPN1completeRelated Commands
show appn class-of-service
Use the show appn class-of-service EXEC command to display the APPN classes of service defined to the local node.
show appn class-of-service [brief | detail]
Syntax Description
brief
(Optional) Short display of APPN classes of service.
detail
(Optional) Long display of APPN classes of service.
Command Modes
EXEC
Command History
Examples
The following is sample output from the show appn class-of-service command:
Router# show appn class-of-serviceNumber of class of service definitions 7APPN Classes of ServiceName Trans. Pri. Node Rows TG Rows-------- ----------- --------- -------1> #CONNECT Medium 8 82> CPSVCMG Network 8 83> SNASVCMG Network 8 84> #INTER High 8 85> #INTERSC High 8 86> #BATCH Low 8 87> #BATCHSC Low 8 8The following is sample output from the show appn class-of-service detail command. This example shows just one part of one table. There could be up to 8 node rows and 8 TGs and multiple tables. This shows, however, the correspondence between the configuration commands and show commands.
Router# show appn class-of-service detailNumber of class of service definitions 81> Class of service name #connectTransmission priority MediumNumber of node rows 8Number of TG rows 81.1> Node row weight 5Congestion min noCongestion max noRoute additional resistance min 0Route additional resistance max 31. .1.1>TG row weight 30Cost per connect time min 0Cost per connect time max 0Cost per byte min 0Cost per byte max 0Security min NonsecureSecurity max Maximum securityPropagation delay min 0 microseconds (minimum)Propagation delay max 384 microseconds (local area network)Effective capacity min 4 megabits per secondEffective capacity max 604 gigabits per secondUser defined parameter 1 min 0User defined parameter 1 max 255User defined parameter 2 min 0User defined parameter 2 max 255User defined parameter 3 min 0User defined parameter 3 max 255Table 44 describes significant fields shown in the display.
Related Commands
Defines an APPN class of service that is not an IBM-supplied default.
Specifies the class of service that maps to a particular mode name.
show appn connection-network
Use the show appn connection-network EXEC command to display the APPN connection networks defined to the local node.
show appn connection-network [brief | detail]
Syntax Description
brief
(Optional) Short display of APPN connection networks.
detail
(Optional) Long display of APPN connection networks.
Command Modes
EXEC
Command History
Examples
The following is sample output from the show appn connection-network brief command:
Router# show appn connection-network briefConnection network definitions 2APPN Connection NetworksResource Name Attached Ports First Port Name----------------- -------------- ---------------1> NETA.CN 2 TR0ABCDEFGH2> NETADDDD.WWWWEEEE 1 TR0The following is sample output from the show appn connection-network detail command:
Router# show appn connection-network detailConnection network definitions 11>Connection network name NETA.CONNECTEffective capacity 15974400 bits per secondCost per connect time 0Cost per byte 0Propagation delay 384 microseconds (local area network)User defined parameter 1 128User defined parameter 2 128User defined parameter 3 128Security NonsecureAttached ports 11.1>Port name TR0Table 45 describes significant fields shown in the display
.
Related Commands
show appn directory
Use the show appn directory EXEC command to display negative cache entries and the remaining time and threshold-count values.
show appn directoryy
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show appn directory command:
Router1# show appn directoryTotal directory entries 4APPN Directory EntriesResource Name Owning CP Name NN Server Entry Type----------------- ----------------- ----------------- ----------1> NETA.ROUTER1 NETA.ROUTER1 NETA.ROUTER1 Home2> NETA.EN1 NETA.EN1 NETA.ROUTER1 Register3> NETA.EN2 NETA.EN2 NETA.ROUTER2 NCache4> NETA.EN3 NCacheThe following is sample output from the show appn directory detail command:
Router2# show appn directory detailTotal directory entries 41>LU name NETA.ROUTER1Owning CP name NETA.ROUTER1Network node CP name NETA.ROUTER1LU entry type HomeRegister Resource No2>LU name NETA.EN1Owning CP name NETA.EN1Network node CP name NETA.ROUTER1LU entry type RegisterRegister Resource No3>LU name NETA.EN2Owning CP name NETA.EN2Network node CP name NETA.ROUTER2LU entry type NCacheRegister Resource NoNCache time Remaining 2NCache count Remaining 54>LU name NETA.EN3Owning CP nameNetwork node CP nameLU entry type NCacheRegister Resource NoNCache time Remaining 0NCache count Remaining 10In these examples, two negative cache entry type entries are found in the directory database table. Notice that the NETA.EN2 resource was entered as a cache entry previously, so its Owning CP Name and NN Server information are known. On the other hand, NETA.EN3 was not found on the APPN network during a previous locate search, so the corresponding information for that resource is empty.
Related Commands
Specifies an LU that would be the destination LU for an LU-LU session request from an LU using this node for network services.
Enables the central resource registration function.
show appn dlur-lu
Use the show appn dlur-lu EXEC command to display all active SSCP dependent LUs known to DLUR.
show appn dlur-lu [pu pu-name] [brief | detail]
Syntax Description
pu pu-name
8-character Type-A string of a specific PU.
brief
(Optional) Short display of the APPN directory database.
detail
(Optional) Long display of the APPN directory database.
Command Modes
EXEC
Command History
Examples
The following is sample output from the show appn dlur-lu command:
Router# show appn dlur-luAPPN DLUR-LU:LU Name PU Name DLUS Name PLU Name------- ------- --------- ----------1> SJDRLU11 BEAGLE NETA.CPAC NETA.TSO0005The following is sample output from the show appn dlur-lu detail command:
Router# show appn dlur-lu detailLU name SJDRLU11PU name BEAGLEDependent LU Server Name NETA.CPACLU location RemoteNAU address 2PLU name NETA.TSO0005Table 46 describes the fields in this output.
Related Commands
show appn dlur-pu
Use the show appn dlur-pu EXEC command to display all active SSCP dependent PUs known to DLUR.
show appn dlur-pu [dlus dlus-name] [brief | detail]
Syntax Description
dlus dlus-name
(Optional) 17-character Type-A string of a specific DLUS.
brief
(Optional) Short display of the APPN directory database.
detail
(Optional) Long display of the APPN directory database.
Command Modes
EXEC
Command History
Examples
The following is sample output from the show appn dlur-pu command:
Router# show appn dlur-puAPPN DLUR-PU:PU Name Active DLUS Defined DLUS Backup DLUS-------- ----------- ------------ -----------1> BEAGLE NETA.CPACThe following is sample output from the show appn dlur-pu detail command:
Router# show appn dlur-pu detailPU name BEAGLEDefined DLUS nameBackup DLUS namePhysical unit (PU) Node ID