|
|
This chapter explains the function and syntax of the TN3270 server commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Bridging and IBM Networking Command Reference, Volume 2, Release 12.1
To assign LUs to a pool, use the allocate lu listen-point PU configuration command. Use the no form of this command to remove LUs assigned to a pool.
allocate lu lu-address pool poolname clusters count
Syntax Description
lu-address Starting number of the LOCADDR to which a cluster of LUs are to be allocated. pool poolname Pool name to which you want to allocate LUs. The pool name cannot exceed 8 characters. clusters count Range of LUs in a cluster that are allocated to the specified pool. For example, if the lu keyword specifies the beginning of the LOCADDR number, the cluster keyword specifies the number of clusters to be included in the pool.
To add an IP subnet to a client subnet response-time group, use the client ip response-time configuration command. Use the no form of this command to remove an IP subnet from a client subnet response-time group.
client ip ip-address [ip-mask]
Syntax Description
ip-address IP subnet being added to the response-time group. ip-mask (Optional) Mask applied to a client IP address to determine the client's membership in a client subnet group. When the mask is applied to a connecting client's IP address and the resulting address is equal to the defined IP address, the client becomes a member of the client group. The default mask is 255.255.255.255.
To define a range of locaddrs to be reserved for remote devices, use the client ip lu TN3270 PU configuration mode command. Use the no form of this command to cancel this definition.
client [printer] ip ip-address [ip-mask] lu first-locaddr [last-locaddr]
Syntax Description
printer (Optional) Specifies that a client connection from the nailed IP addresses will be nailed to one of the specified LUs only if the client-session negotiates a model type of 328n, where n is any alphanumeric character. Moreover, it ensures that a printer matching the IP address condition can only use an LU nailed as a printer LU. If the printer keyword is not specified for any client statement that has this IP address set, all model types can use this range of LUs. ip-address Specifies remote client IP address. ip-mask (Optional) The mask applied to the remote device address. Multiple client IP addresses in the same subnet can be nailed to the same range of locaddrs. first-locaddr Defines a single locaddr to nail. last-locaddr (Optional) Defines the end range of inclusive locaddrs to be nailed from first-locaddr to last-locaddr.
To nail clients to pools, use the client ip pool listen-point configuration command. Use the no form of this command to remove clients from pools.
client ip ip-address [ip-mask] pool poolname
Syntax Description
ip-address Remote client IP address. ip-mask (Optional) Mask applied to the remote device address. The mask is part of the matching function that determines whether a client is governed by the nailing statement. The default is 255.255.255.255. Multiple client IP addresses in the same subnet can be nailed to the same range of LOCADDRS. poolname Specifies a unique pool name. The pool name cannot exceed 8 characters.
To limit the number of LU sessions that can be established from a client IP address, use the client lu maximum TN3270 server configuration command. Use the no form of this command to remove a single LU limit associated with a particular IP address.
client [ip [ip-mask]] lu maximum number
Syntax Description
ip (Optional) IP address of the client. The value for the ip argument is optional when setting the maximum number of LU sessions. If no IP address is specified then the limit is applied to all clients. ip-mask (Optional) IP network mask for the client. The default is 255.255.255.255 number (Optional) Maximum number of LU sessions. The allowed value is from 0 to 65535.
To enable the Systems Network Architecture (SNA) session switch function on the CMCC adapter, or to enter dependent logical unit requester (DLUR) configuration mode, use the dlur TN3270 server configuration command. Use the no form of this command to disable the SNA session switch function and discard all parameter values associated with the SNA session switch.
dlur [fq-cpname fq-dlusname]
Syntax Description
fq-cpname (Optional) Fully qualified control point (CP) name used by the SNA session switch and the logical unit (LU) name for the DLUR function. This name must be unique among APPN nodes in the network including other values for the fq-cpname argument specified on all other TN3270 servers running under the Cisco IOS software. fq-dlusname (Optional) Fully qualified name of the primary choice for the dependent LU server (DLUS). This is the name of an LU, usually a CP, in an APPN host. The value for the fq-dlusname argument can be repeated and shared across servers.
To specify a backup DLUS for the DLUR function, use the dlus-backup DLUR configuration command. Use the no form of this command to remove a backup DLUS name.
dlus-backup dlusname2
Syntax Description
dlusname2 Fully qualified name of the backup DLUS for the DLUR.
To specify whether or not leftover LUs will be made available to TN3270 sessions that do not request a specific LU or LU pool through TN3270E, use the generic-pool TN3270 server configuration command. Use the no form of this command to selectively remove the permit or deny condition of generic pool use.
generic-pool {permit | deny}
Syntax Description
permit Leftover LUs should be made available to TN3270 users wanting generic sessions. This value is the default. deny Leftover LUs should not be given to a generic pool. The physical unit (PU) is not automatically fully populated with 255 LOCADDR definitions. The default is the value configured in TN3270 server configuration mode.
To specify how many seconds of LU inactivity, from both host and client, before the TN3270 session is disconnected, use the idle-time TN3270 server configuration command. Use the no form of this command to cancel the idle time period and return to the default.
idle-time seconds
Syntax Description
seconds Idle time in seconds, from 0 to 65535. A value of 0 means the session is never disconnected.
To specify the precedence level for voice over IP traffic in the TN3270 server, use the ip precedence TN3270 server configuration command. Use the no form of this command to remove the precedence value.
ip precedence {screen | printer} value
Syntax Description
screen Specifies the precedence is for screen devices. printer Specifies the precedence is for printer devices. value Sets the precedence priority. A value between 0 and 7, with 7 being the highest priority. The default is 0.
To specify the Type of Service (TOS) level for IP traffic in the TN3270 server, use the ip tos TN3270 server configuration command. Use the no form of this command to remove the TOS value.
ip tos {screen | printer} value
Syntax Description
screen Specifies the TOS is for screen devices. printer Specifies the TOS is for printer devices. value Sets the TOS priority. A value between 0 and 15. The default is 0.
To specify how many seconds of inactivity elapse before the TN3270 server transmits a DO TIMING-MARK or Telnet no operation (nop) to the TN3270 client, use the keepalive TN3270 server configuration command. Use the no form of this command to cancel the keepalive period and return to the previously configured siftdown value or the default.
keepalive seconds [send {nop | timing-mark [max-response-time]}]
Syntax Description
seconds Number of elapsed seconds (from 0 to 65535) before the TN3270 server transmits a DO TIMING-MARK or Telnet nop command to the TN3270 client. A value of 0 means no keepalive signals are sent. The default is 1800 seconds (30 minutes). send nop (Optional) Sends the Telnet command for no operation to the TN3270 client to verify the physical connection. No response is required by the client. send timing-mark [max-response-time] (Optional) Number of seconds (from 0 to 32767) within which the TN3270 server expects a response to the DO TIMING-MARK from the TN3270 client. The default is 30 seconds if the keepalive interval is greater than or equal to 30 seconds. If the value of the keepalive interval is less than 30 seconds, then the default max-response-time is the value of the interval. The value of the max-response-time should be less than or equal to the interval.
To define and activate a link to a host, use the link DLUR SAP configuration command. Use the no form of this command to delete the link definition.
link name [rmac rmac] [rsap rsap]
Syntax Description
name Link name, from one to eight alphanumeric characters. The first character must be alphabetic. The name must be unique within the DLUR function. rmac rmac (Optional) Remote MAC address of the form xxxx.xxxx.xxxx in hexadecimal. If not specified, a loopback link to another SAP on the same internal LAN adapter is assumed. rsap rsap (Optional) Remote SAP address, 04 to FC in hexadecimal. The rsap value must be even and should be a multiple of 4, but this requirement is not enforced. The default value for the rsap argument is 04.
Syntax Description
ip-address IP address that the clients should use as the host IP address to map to LU sessions under this PU and listen point. tcp-port number (Optional) Port number used for the listen operation. The default value is 23.
To create a SAP in the SNA session switch, or to enter DLUR SAP configuration mode, use the lsap DLUR configuration command. Use the no form of this command to delete a SAP and all SNA session switch links using the internal LAN interface.
lsap type adapter-number [lsap]
Syntax Description
type Internal adapter type on the CIP card, which corresponds to the value specified in the lan internal LAN configuration command. The currently supported value for the type argument is token-adapter. adapter-number Internal adapter interface on the CIP card, which is the same value specified in the adapter internal LAN configuration command. lsap (Optional) Local SAP number, 04 to FC, in hexadecimal. The value must be even and should normally be a multiple of four. It must be unique within the internal adapter in that no other 802.2 clients of that adapter, in the router or in a host, should be allocated the same SAP. The default value is C0.
To specify whether the TN3270 server sends a REPLY-PSID poweroff request to VTAM to delete the corresponding LU when a client disconnects, use the lu deletion TN3270 server configuration command. Use the no form of this command to remove LU deletion from the current configuration scope.
lu deletion {always | normal | non-generic | never}
Syntax Description
always Always delete dynamic LUs upon disconnect. normal Delete screen LUs only upon disconnect. non-generic Delete only specified LUs upon disconnect. never Never delete LUs upon disconnect.
To specify whether a TERMSELF or UNBIND RU is sent by the TN3270 server when a client turns off his device or disconnects, use the lu termination TN3270 server configuration command. Use the no form of this command to remove LU termination from the current configuration scope.
lu termination {termself | unbind}
Syntax Description
termself Orders termination of all sessions and session requests associated with an LU upon disconnect. unbind Requests termination of the session by the application upon LU disconnect. This value is the default.
To limit the number of LU control blocks that will be allocated for the TN3270 server, use the maximum-lus TN3270 server configuration command. Use the no form of this command to restore the default value.
maximum-lus number
Syntax Description
number Maximum number of LU control blocks allowed. The allowed range is 0 to 32000. However, the practical upper limit for concurrently operating TN3270 sessions depends on the hardware and usage characteristics. The default is 2100.
To define pool names for the TN3270 server and specify the number of screens and printers in each logical cluster, use the pool TN3270 server configuration command. Use the no form of this command to remove a client IP pool.
pool poolname [cluster layout layout-spec-string]
Syntax Description
poolname Unique pool name which cannot exceed eight characters. Valid characters are (alphabetic characters are not case sensitive): cluster layout layout-spec-string (Optional) Name for the cluster and to indicate a cluster of LUs such as printers. The sum of the numbers must be less than or equal to 255. No spaces are used between the entries in the layout-spec-string. The default value is 1a.
To specify a preferred network node (NN) as server, use the preferred-nnserver DLUR configuration command. Use the no form of this command to remove the preference.
preferred-nnserver name
Syntax Description
name Fully qualified name of an NN.
To create a PU entity that has no direct link to a host or to enter PU configuration mode, use the pu DLUR configuration command. Use the no form of this command to remove the PU entity.
pu pu-name idblk-idnum ip-address
Syntax Description
pu-name Name that uniquely identifies this PU. idblk-idnum Value of this argument must match the IDBLK-IDNUM value defined at the host. The value must be unique within the subarea; however, the TN3270 server generally cannot tell which remote hosts are in which subareas, so the server only enforces uniqueness within the set of DLUR PUs. ip-address IP address that the clients should use as host IP address to map to LU sessions under this PU.
To create a PU entity that has a direct link to a host or to enter listen-point PU configuration mode, use the pu listen-point configuration command. Use the no form of this command to remove the PU entity.
pu pu-name idblk-idnum type adapter-number lsap [rmac rmac] [rsap rsap] [lu-seed lu-name-stem]
Syntax Description
pu-name Name that uniquely identifies this PU. idblk-idnum Value of this argument must match the IDBLK-IDNUM value defined at the host. The value must be unique within the subarea; however, the TN3270 server cannot tell which remote hosts are in which subareas and does not enforce the unique value requirement. type Internal adapter type on the CIP card, which corresponds to the value specified in the lan internal LAN configuration command. The currently supported type is token-adapter. adapter-number Internal adapter interface on the CIP card, which is the same value specified in the adapter internal LAN configuration command. lsap Local SAP number in hexadecimal, ranging from 04 to DE. The value must be even, and must be unique within the internal adapter so that no other 802.2 clients of that adapter, in the router or in a host, are allocated the same SAP. Other direct links from TN3270 server direct PUs may use the same value on the internal adapter as long as the remote MAC or SAP is different. rmac rmac (Optional) Remote MAC address. The remote MAC address in the form xxxx.xxxx.xxxx hexadecimal, specifying the MAC address of the remote host. If not specified, a loopback link to another SAP on the same internal LAN adapter is assumed. rsap rsap (Optional) Remote SAP address. The remote SAP address is a one- or two-character hexadecimal string, ranging from 04 to FC, that specifies the SAP address of the remote host. The default is 04. lu-seed lu-name-stem (Optional) LU name that the client uses when a specific LU name request is needed. The format is x...x## or x...x### where x...x is an alphanumeric string. When ## is specified, it is replaced with the LU LOCADDR in hexadecimal digits to form the complete LU name. When ### is specified, decimal digits are used, padded with leading zeroes to make three characters. The first x must be alphabetic and the entire string, including the # symbols, must not exceed 8 characters.
To create a PU entity that has its own direct link to a host, or to enter PU configuration mode, use the pu TN3270 server configuration command. Use the no form of this command to remove the PU entity.
pu pu-name idblk-idnum ip-address type adapter-number lsap [rmac rmac] [rsap rsap] [lu-seed lu-name-stem]
Syntax Description
pu-name Name that uniquely identifies this PU. idblk-idnum The value for this argument must match the IDBLK-IDNUM value defined at the host. The value must be unique within the subarea; however, the TN3270 Server cannot tell which remote hosts are in which subareas and does not enforce the unique value requirement. ip-address IP address that the clients should use as host IP address to map to LU sessions under this PU. type Internal adapter type on the CIP card, which corresponds to the value specified in the lan internal LAN configuration command. The currently supported type is token-adapter. adapter-number Internal adapter interface on the CIP card, which is the same value specified in the adapter internal LAN configuration command. lsap Local SAP number in hexadecimal, ranging from 04 to FC. The value must be even, and must be unique within the internal adapter so that no other 802.2 clients of that adapter, in the router or in a host, should be allocated the same SAP. Other direct links from TN3270 server direct PUs may use the same value on the internal adapter as long as the remote MAC or SAP is different. rmac rmac (Optional) Remote MAC address. The remote MAC address of the form xxxx.xxxx.xxxx hexadecimal, specifying the MAC address of the remote host. If not specified, a loopback link to another SAP on the same internal LAN adapter is assumed. rsap rsap (Optional) Remote SAP address. The remote SAP address is a one- or two-character hexadecimal string, ranging from 04 to FC, specifying the SAP address of the remote host. The default is 04. lu-seed lu-name-stem (Optional) Provides an LU name that the client can use when a specific LU name request is needed. The format can be x...x## or x...x### where x..x is an alphanumeric string. When ## is specified, it is replaced with the LU LOCADDR in hexadecimal digits to form the complete LU name. When ### is specified, decimal digits are used, padded with leading zeroes to make three characters. The first x must be alphabetic and the entire string, including the # symbols, must not exceed 8 characters.
Syntax Description
pu-name Name that uniquely identifies this PU. idblk-idnum Value for this argument must match the IDBLK-IDNUM value defined at the host. The value must be unique within the subarea; however, the TN3270 server generally cannot tell which remote hosts are in which subareas, so the server only enforces uniqueness within the set of DLUR PUs.
To configure a client subnet group for response-time measurements, use the response-time group TN3270 server configuration command. Use the no form of this command to remove a client subnet group from response-time measurements.
response-time group name [bucket boundaries t1 t2 t3 t4...] [multiplier m]
Syntax Description
name Alphanumeric string for the response-time group name. The maximum length of the name is 24 characters. Lower or uppercase letters can be used. bucket boundaries t1 t2 t3 t4 (Optional) Unsigned 32-bit quantity that defines a bucket boundary in tenths of seconds. For other types of client groups, the bucket boundaries and multiplier values are fixed to the following defaults: multiplier m (Optional) Number in the range of 1 to 5760, which when multiplied by the sample interval of 20 seconds, determines the collection interval.
To display current server configuration parameters and the status of the PUs defined for the TN3270 server, use the show extended channel tn3270-server EXEC command.
show extended channel slot/port tn3270-server
Syntax Description
slot Specifies a particular CMCC adapter in the router where slot is the slot number. port Port value for a TN3270 server will always be 2.
To display information about all clients at a specific IP address, use the show extended channel tn3270-server client-ip-address EXEC command.
show extended channel slot/port tn3270-server client-ip-address ip-address [disconnected | in-session | pending]
Syntax Description
slot Slot number. port Port number. ip-address IP address of the client. disconnected (Optional) Shows all clients with ip-address in disconnected state. Disconnected state refers to an LU session state of ACTIVE or INACTIVE. In this case, the ip-address refers to the client that last used the LU. in-session (Optional) Shows all clients with ip-address in active session state. Active session state refers to an LU session state of ACT/SESS. pending (Optional) Shows all clients with ip-address in pending state. Pending session state refers to an LU session state of P-SDT, P-ACTLU, P-NTF/AV, P-NTF/UA, P-RESET, P-PSID, P-BIND, P-UNBIND, WT-UNBND, WT-SDT or UNKNOWN.
To display information about the SNA session switch, use the show extended channel tn3270-server dlur EXEC command.
show extended channel slot/port tn3270-server dlur
Syntax Description
slot Slot number. port Port number.
To display information about the DLUR components, use the show extended channel tn3270-server dlurlink EXEC command.
show extended channel slot/port tn3270-server dlurlink name
Syntax Description
slot Specifies a particular CMCC adapter in the router where slot is the slot number. port Port number. name Name of the SNA session switch link to be displayed.
To display mappings between a nailed client IP address and nailed LUs, use the show extended channel tn3270-server nailed-ip EXEC command.
show extended channel slot/port tn3270-server nailed-ip ip-address
Syntax Description
slot Slot number. port Port number. ip-address Remote client IP address.
To display configuration parameters for a PU and all the LUs currently attached to the PU, including the LU cluster layout and pool name, use the show extended channel tn3270-server pu EXEC command.
show extended channel slot/virtual channel tn3270-server pu pu-name [cluster]
Syntax Description
slot Specifies a particular CMCC adapter in the router where slot is the slot number. virtual channel Virtual channel number. pu-name Name that uniquely identifies this PU. cluster (Optional) Display cluster information for the LUs within the pool.
To display information about the TN3270 server LUs running on CMCC adapter interface, use the show extended channel tn3270-server pu lu EXEC command.
show extended channel slot/port tn3270-server pu pu-name lu locaddr [history]
Syntax Description
slot Specifies a particular CMCC adapter in the router where slot is the slot number. The port value for a TN3270 server will always be 2. port Port value for a TN3270 server will always be 2. pu-name PU name that uniquely identifies this PU. locaddr LU LOCADDR that uniquely identifies the LU. history (Optional) Displays the LU trace history.
To display information for application client groups, use the show extended channel tn3270-server response-time application privileged EXEC command.
show extended channel slot/virtual channel tn3270-server response-time application [appl-name [detail]]
Syntax Description
slot Slot number. virtual channel Virtual channel number. appl-name (Optional) Display only the client group corresponding to the VTAM application name. detail (Optional) List client members and their response-time statistics following the client group entry.
To display information about the global client group, use the show extended channel tn3270-server response-time global privileged EXEC command.
show extended channel slot/virtual channel tn3270-server response-time global
Syntax Description
slot Slot number. virtual channel Virtual channel number.
To display information about host link client groups, use the show extended channel tn3270-server response-time link privileged EXEC command.
show extended channel slot/virtual channel tn3270-server response-time link [link-name]
Syntax Description
slot Slot number. virtual channel Port number. link-name (Optional) PU name for a direct PU or link name for a DLUR PU.
Syntax Description
slot Slot number. virtual channel Virtual channel number.
Syntax Description
slot Slot number. virtual channel Virtual channel number. ip-address (Optional) Subnet IP address. ip-mask (Optional) Subnet mask. detail (Optional) Each client group entry is followed by a list of its client members and their respective response-time statistics.
To shut down TN3270 entities, such as PU, DLUR, and DLUR SAP, use the shutdown command in one of the TN3270 server command modes. The shutdown TN3270 command shuts down the TN3270 entities according to which configuration mode you are in when the command is issued. Use the no form of this command to restart the interface or entity.
shutdownSyntax Description
This command has no arguments or keywords.
To override the default TCP port setting of 23, use the tcp-port TN3270 server configuration command. Use the no form of this command to restore the default.
tcp-port port-number
Syntax Description
port-number A valid TCP port number in the range of 0 to 65534. The default is 23, which is the IETF standard. The value 65535 is reserved by the TN3270 server.
To start the TN3270 server on a CMCC adapter or to enter TN3270 server configuration mode, use the tn3270-server interface configuration command. Use the no form of this command to remove the existing TN3270 server configuration.
tn3270-serverSyntax Description
This command has no arguments or keywords.
To select whether a WILL TIMING-MARK is transmitted when the host application needs an SNA response (definite or pacing response), use the timing-mark TN3270 server configuration command. Use the no form of this command to turn off WILL TIMING-MARK transmission except as used by the keepalive function.
timing-markSyntax Description
This command has no arguments or keywords.
To select what action to take when the TN3270 server receives an UNBIND request, use the unbind-action TN3270 server configuration command. Use the no form of this command to restore the default.
unbind-action {keep | disconnect}
Syntax Description
keep No automatic disconnect will be made by the server on receipt of an UNBIND. disconnect Session will be disconnected upon receipt of an UNBIND.
To tell the SNA session switch the connection network to which the internal adapter interface on the CMCC adapter belongs, use the vrn DLUR SAP configuration command. Use the no form of this command to remove a network name.
vrn vrn-name
Syntax Description
vrn-name Fully qualified name of the connection network.
Posted: Wed Jul 26 12:44:39 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.