|
|
This chapter describes the function and displays the syntax of each Advanced Peer-to-Peer Networking (APPN) command. For more information about defaults and usage guidelines, see the corresponding chapter of the Bridging and IBM Networking Command Reference.
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| netid.cpname | Fully qualified network name of the remote control point. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
| 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 $ # @ |
| 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, a period, and another 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. |
| netid.cpname | Fully qualified control point name for the local node. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
| linkname | Name that identifies the link station. The name must be a Type A string. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
| modename | Name of the mode. A Type A character string. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
| netid.luname | Fully qualified name of the partner LU. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
| portname | Port name to be associated with the interface. |
| interface | 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. |
| vdlc | Specify vdlc to allow link stations using this virtual port to connect over DLSw+, or any other higher-layer protocol that is CLSI-compliant, using the virtual data link control (VDLC) feature. |
Use the appn routing global configuration command to indicate that APPN routing should be activated. Use the no form to deactivate APPN routing.
appn routingUse the appn start EXEC command to activate the APPN subsystem in this node.
appn startUse the appn start link-station EXEC command to activate a logical APPN link.
appn start link-station linkname| linkname | Name of the link-station. Must be a Type A character string. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
Use the appn start port EXEC command to activate APPN routing over a particular port.
appn start port portname| portname | Name of the port. Must be a Type A character string. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
Use the appn stop EXEC command to deactivate APPN routing without affecting the current configuration.
appn stop| linkname | Name of the link station. The name must be a Type A character string. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
Use the appn stop port EXEC command to deactivate APPN routing over a specified port.
appn stop port portname| portname | Name of the port. Must be a Type A character string. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
| pvc | Permanent virtual circuit (PVC) of the remote node. Valid range is 1 to 4096. |
| netid.cpname | Fully qualified network name. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
| netid.cpname | Fully qualified network name. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
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| 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. |
| cosname | Name of the class of service. Must be a Type A character string. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
| cost | Number in the range 0 to 255. The default is the value specified in the appn port command. |
| cost | Number in the range 0 to 255. The default is 0. |
| cost | Number in the range 0 to 255. The default is the value specified in the appn port command. |
| cost | Number in the range 0 to 255. The default is 0. |
| size | BTU size (in bytes) on this link, in the range 99 to 5107. The default is 1024 bytes. |
| pu-name | Type A character string. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
| netid.cpname | Fully qualified CP name. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
| netid.cpname | Fully qualified CP name. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
| capacity | Number of bits per second in the range 0 to 100000000. The default is the value specified in the appn port command. |
| capacity | Number of bits per second in the range 0 to 100000000. The default is media dependent. |
| dlci | Number in the range 16 to 1007 that represents the DLCI, or virtual circuit, for a Frame Relay connection. |
| sap | (Optional) 1-byte hexadecimal number in the range 04 to EC, and divisible by 4. |
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| 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. |
Use the link-queuing APPN link station configuration command to specify queuing options and parameters for the link station. Use the no form of the command to cancel the option.
link-queuing {priority level | custom queue-number}| priority level | Priority level, indicated by one of the following keywords: high, medium, normal, low. |
| custom queue-number | Priority number used to specify custom queuing for the link station. The default is that no number is assigned. |
| sap | Hexadecimal number in the range 04 to EC, and divisible by 4. The default is 04. |
| number | Maximum number of cached directory entries. The valid range is 0 to 32767. The default is 255. |
| number | Maximum number of cached class of service routing trees. The valid range is 0 to 32767. The default is 20. |
Use the maximum-memory APPN control point configuration command to specify the maximum amount of memory available to APPN. Use the no form of the command to cancel the specification.
maximum-memory bytes| 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. |
| 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. |
| size | Maximum receive BTU (in bytes), in the range 99 to 5107. The default is 1024 bytes. |
| bytes | Maximum amount of memory (in bytes) available to APPN. The valid range is 1000000 to 64000000. The default is 1000000 bytes. |
| index | Specifies which row is being entered. The valid range is 1 to 8. |
| weight weight | Weight assigned to a node, given the characteristics identified in the remainder of the row. The weight of row n must be less than the weight of row n+1. The valid range is 0 to 255. |
| congestion | Minimum and maximum congestion tolerance for the node row. |
| yes yes | Only yes. Only congested transmission groups match this row. |
| no yes | Yes or no. Congestion does not affect class of service row. |
| no no | Only no. Only noncongested transmission groups match this row. The default is no no. |
| route-additional-resistance min max | Minimum and maximum additional resistance value for the row. The value is compared to the same parameter defined in the CP for each network node and exchanged on the topology database updates. The valid range for minimum and maximum is 0 to 255. The default range for minimum and maximum is 0 and 0. |
| netid.cpname | Fully qualified network name. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
| portname | Type A name. A Type A character string contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
| portname | Type A name. (Required when defining a new link station; optional on subsequent changes to the link station.) A Type A character contains 1 to 8 of the following characters: A - Z, a - z 0 - 9 $ # @ |
| sap | Service access point of the remote node. The default is 04 hexadecimal. |
| minimum | No delay. |
| lan | Less than 480 microseconds delay. |
| telephone | Between 480 and 49152 microseconds delay. |
| packet-switched | Between 49152 and 245760 microseconds delay. |
| satellite | Over 245760 microseconds delay. |
| maximum | Maximum delay allowed. |
| minimum | No delay. |
| lan | Less than 480 microseconds delay. |
| telephone | Between 480 and 49152 microseconds delay. |
| packet-switched | Between 49152 and 245760 microseconds delay. |
| satellite | Over 245760 microseconds delay. |
| maximum | Maximum delay allowed. |
| number | Number in the range 0 to 255. The default is 0. |
| number | Number in the range 0 to 255. The default is 0. |
| retries | Number of reactivation attempts. The valid range is 0 to 255 (0 equals infinite retries). The default is 5. |
| infinite | Infinite retries. |
| interval | (Optional) Amount of time allowed between reactivation attempts (in seconds). The valid range is 0 to 32767 seconds. The default is 30 seconds. |
| retries | Number of reactivation attempts. The valid range is 0 to 255 (0 equals infinite retries). The default is 5. |
| infinite | Infinite retries. |
| interval | (Optional) Amount of time allowed between reactivation attempts (in seconds). The default is 30 seconds. |
| negotiable | The link station can be the primary or secondary end of the link station connection. |
| primary | The link station is the primary end of the link station connection. |
| secondary | The link station is the secondary end of the link station connection. |
| negotiable | The link station can be the primary or secondary end of the link station connection. |
| primary | The link station is the primary end of the link station connection. |
| secondary | The link station is the secondary end of the link station connection. |
| number | Arbitrary value in the range of 0 to 255. The default is 128. |
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| mac-address | Virtual MAC address on which APPN resides. |
| local-ring | Virtual ring number on which the APPN station resides. The valid range is 1 to 255. |
| bridge-number | Bridge number connecting the local virtual ring and the RSRB target virtual ring. The valid range is 1 to 15. |
| target-ring | Target ring through which the local ring bridges data. The valid range is 1 to 255. |
| number | Number of cache instances to be saved. The valid range is 1 to 99. The default is 2. |
| ip-address address | Host IP address. |
| directory path | File path for safe store. |
| 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. |
| address | A 2-digit hexadecimal number in the range of 00 to FE. |
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| sdlc-address | SDLC secondary address. The valid range is 0 to FE (hexadecimal). The default is 00. |
| security-level | One of the following keywords: nonsecure, public-switched, underground-cable, secure-conduit, guarded-conduit, encrypted, guarded-radiation. The default is the value specified in the appn port command. |
| security-level | One of the following keywords: nonsecure, public-switched, underground-cable, secure-conduit, guarded-conduit, encrypted, guarded-radiation. The default is nonsecure. |
| netid.cpname | Fully qualified network name. A fully qualified name is a string of 1 to 8 characters, a period, and another 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. |
| brief | (Optional) A short display of APPN classes of service. |
| detail | (Optional) A long display of APPN classes of service. |
| brief | (Optional) A short display of APPN connection networks. |
| detail | (Optional) A long display of APPN connection networks. |
Use the show appn directory EXEC command to display the contents of the APPN directory database.
show appn directory [name cp-name] [brief | detail]| name cp-name | (Optional) Filter by fully qualified CP name. |
| brief | (Optional) A short display of the APPN directory database. |
| detail | (Optional) A long display of the APPN directory database. |
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]| pu pu-name | 8-character Type-A string of a specific PU. |
| brief | (Optional) A short display of the APPN directory database. |
| detailp | (Optional) A long display of the APPN directory database. |
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]| dlus dlus-name | (Optional) 17-character Type-A string of a specific DLUS. |
| brief | (Optional) A short display of the APPN directory database. |
| detail | (Optional) A long display of the APPN directory database. |
Use the show appn dlus EXEC command to display all LUs known to DLUR.
show appn dlus [brief | detail]| brief | (Optional) A short display of the APPN directory database. |
| detail | (Optional) A long display of the APPN directory database. |
| pcid pcid | (Optional) Filter by procedure correlation identifier (PCID). PCID is a 16-byte hexadecimal number. |
| name lu-name | (Optional) Filter by fully qualified LU name. |
| brief | (Optional) A short display of APPN intermediate session information. |
| detail | (Optional) A long display of APPN intermediate session information. |
| name link-station-name | (Optional) Filter by link station name. |
| port port-name | (Optional) Filter by port name. |
| brief | (Optional) A short display of active APPN links. Brief is the default display. |
| detail | (Optional) A long display of active APPN links with more information. |
Use the show appn mode EXEC command to display information about the APPN modes defined to the local node.
show appn modeUse the show appn node EXEC command to display information about the local APPN control point.
show appn nodeUse the show appn port EXEC command to display information about the APPN ports active on the local node.
show appn port [port port-name] [brief | detail]| port port-name | (Optional) Filter by port name. |
| brief | (Optional) A short display of APPN port definitions. |
| detail | (Optional) A long display of APPN port definitions. |
| pcid pcid | (Optional) Filter by PCID. PCID is a 16-byte hexadecimal number. |
| name lu-name | (Optional) Filter by fully qualified LU name. |
| brief | (Optional) A short display of APPN session information. |
| detail | (Optional) A long display of APPN session information. |
Use the show appn topology EXEC command to display the contents of the APPN topology database.
show appn topology [name cp-name] [brief | detail]| name cp-name | (Optional) Filter by fully qualified CP name. |
| brief | (Optional) A short display of APPN topology information. |
| detail | (Optional) A long display of APPN topology information. |
| smds-addr | 8-byte hexadecimal number in the form HD.DD.DD.HH. |
| sap | 1-byte hexadecimal number in the range 04 to EC, and divisible by 4. |
| number | Number in the range 0 to 255. The default is 0. |
| index | Specifies which row is being entered. The valid range is 1 to 8. |
| weight weight | Weight assigned to a transmission group, given the characteristics defined in the remainder of the row. |
| byte min max | Minimum and maximum cost-per-byte values, compared with the cost-per-byte command on the port or link station command. |
| time min max | Minimum and maximum cost-per-connect-time values, compared with the cost-per-connect-time command on the port or link station command. |
| capacity min max | Minimum and maximum capacity values, compared with the effective-capacity command on the port or link station command. |
| delay min max | Two values compared with the propagation-delay command. |
| security min max | Value compared with the security command. The minimum and maximum are specified with one the defined values, in ascending order: |
| user1 min max | Number in the range 1 to 255. |
| user2 min max | Number in the range 1 to 255. |
| user3 min max | Number in the range 1 to 255. |
| priority | One of the following keywords: network, high, medium, low. |
| value | Number in the range 0 to 255 used to specify the relative value. The default is the value specified in the appn port command. |
| value | Number in the range 0 to 255 used to specify the relative value. The default is 128. |
| value | Number in the range 0 to 255 used to specify the relative value. The default is the value specified in the appn port command. |
| value | Number in the range 0 to 255 used to specify the relative value. The default is 128. |
| value | Number in the range 0 to 255 used to specify the relative value. The default is the value specified in the appn port command. |
| value | Number in the range 0 to 255 used to specify the relative value. The default is 128. |
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. Use the no form of this command to delete the configuration.
vdlc ring-group [vmac vdlc-mac-address]| ring-group | Ring group number matching the number you specified with the source-bridge ring-group command. The valid range is 1 to 4095. |
| vmac vdlc-mac-address | (Optional) Virtual MAC address used as the local MAC address identifying this APPN port. |
| learn | Any adjacent node type is accepted. |
| len | Only LEN adjacent node type is accepted. |
| nn | Only NN adjacent node type is accepted. |
Use the x25-dest-address APPN link station configuration command to specify the local address of the partner node for QLLC. Use the no form of this command to delete the specification.
x25-dest-address [pvc | svc] address| pvc | (Optional) Uses X.25 permanent virtual circuit. |
| svc | (Optional) Use X.25 switch virtual circuit. |
| address | X.25 destination link station address. |
Use the x25-subaddress APPN port configuration command to configure APPN over QLLC. Use the no form of this command to delete the configuration.
x25-subaddress [pvc | svc] address| pvc | (Optional) Uses X.25 permanent virtual circuit. |
| svc | (Optional) Uses X.25 switch virtual circuit. |
| address | X.25 subaddress from which data is received. |
| number | Three-digit hexadecimal number in the range 000 to FFF. The default is 077. |
| number | Five-digit hexadecimal number in the range 00000 to FFFFF. |
|
|