|
|
The LU pool configuration is an option to the LU nailing feature that allows clients to be nailed to LUs. The LU pooling feature allows you to configure clients in the router and nail clients into groups of LUs. These groups of LUs are called clusters. Each cluster is given a unique pool name. An LU pool consists of one or more LU clusters that are related to each other. This allows logically related clients to connect to LUs that have the same logical relationship with the host. A cluster can contain screen LUs and their associated printer LUs. LU nailing is supported for LU pools.
The pool name can be used instead of a device name on a CONNECT request. The pool name must be eight characters or less in length and must comply with VTAM naming rules, which allow the following characters (alphabetic characters are not case sensitive):
These naming rules are enforced by the TN3270 server when configuring a pool name and when processing the name received on a CONNECT request from the client. The TN3270 server rejects an invalid name and truncates the name received in the CONNECT request from the client to eight characters or at an invalid character (whichever comes first) when processing the CONNECT request.
Figure 1 provides an overview of clusters configured within PUs.
If the client sends an ASSOCIATE request for a resource name to the TN3270 server, the server provides the client with a resource LU name.
In Figure 2, the client requests an LU from unixpool and is granted an LU from the specified pool. The client then initiates a new process by requesting the printer device associated with the given resource LU name.
The client requests a printer LU associated with termabc and the server grants the printer LU associated with termabc. Based on the configuration in the router that specifies the clusters of printer and screen LUs for pools, the TN3270 server assigns and allows the client to use the printer LU associated with its terminal LU.
Figure 3 shows the client request for a specific LU termxyz and then a request for a printer LU associated with the LU termxyz. The TN3270 server grants the screen LU and connects the printer associated with termxyz.
If SNMP is enabled on the router, an NMS system or users can use well-known and router-configured client group names to obtain response-time statistics. Response-time data collection is always enabled for all in-session clients. Table 1 shows the types of client groups that are monitored:
| Type | Description | Client Group Name |
|---|---|---|
Client Subnet | All clients belonging to one or more IP subnets, where the IP subnets and client group name are configured on the router. | User defined. |
Other | All clients not belonging to an IP subnet configured for a Client Subnet-type group. | CLIENT SUBNET OTHER |
Global | All in-session clients. | CLIENT GLOBAL |
Application | All clients in session with a specific VTAM APPL ID. | APPL VTAM-application-name |
Host Link | All clients using a specific host link in use by a PU configured on the router. | DIRECT LINK pu-name DLUR LINK link-name |
Listening Point | All clients connected to a specific listening point configured on the router. | LP ip-address: tcp-port |
In Cisco IOS release 12.0(5)T, traps are not generated by the MIB.
Response-time data is collected using the following methods:
Response-time buckets contain counts of transactions with total response times that fall into a set of specified ranges. Response-time data gathered into a set of five buckets is suitable for verifying service-level agreements or for identifying performance problems through a network management application. The total response times collected in the buckets is governed by whether IP network transit times are included in the totals.
In Figure 4, four bucket boundaries are specified for a response-time collection, which results in five buckets.
The first response-time bucket counts transactions with total response times that are less than or equal to boundary 1 (B-1), the second bucket counts transactions with response times greater than B-1 but less than or equal to B-2, and so on. The fifth bucket is unbounded, and it counts all transactions with response times greater than boundary 4.
The four bucket boundaries have default values of 1 second, 2 seconds, 5 seconds, and 10 seconds, respectively.
For a detailed explanation of response-time buckets, refer to the TN3270E-RT-MIB.
If you use an UNBIND request for session termination with CICS, VTAM security problems can arise. When CICS terminates a session from an UNBIND request, the application may reestablish a previous user's session with a new user, who is now assigned to the same freed LU.
In the TN3270 server configuration, the keepalive command enables you to specify the maximum time allowed between keepalive marks before the server disconnects. This command is enhanced to allow control over how the keepalive timing marks are generated and how the keepalive responses are handled by the CMCC adapter.
TN3270 configuration modes supported in the Cisco IOS release 12.0(5)T are:
Figure 5 shows TN3270 configuration modes supported in the Cisco IOS release 12.0(5)T.
(cfg-tn3270)#
(tn3270-lpoint)#
The following prompt appears when the PU is configured:
(tn3270-lpoint-pu)#
From listen-point configuration mode, the pu command to create a new PU for DLUR is:
pu pu-name idblk-idnum dlurThe pu command puts you in the PU configuration mode and the following prompt appears:
(tn3270-lpoint-pu)#
(tn3270-dlur)#
(tn3270-dlur-lsap)#
(tn3270-resp-time)#
From the TN3270 server configuration mode, the pu command puts you in PU configuration mode. The following prompt appears:
(tn3270-pu)#
For details on the host server configuration and optional commands used with the TN3270 server, refer to the following documents:
For details on SNMP configuration, refer to the Cisco IOS Configuration Fundamentals Guide.
For information about configuring CMPC or CSNA, refer to the Cisco IOS Bridging and IBM Networking Configuration Guide.
To use the response-time MIB, SNMP must be enabled on the router. For details on configuring SNMP, refer to the Cisco IOS Configuration Fundamentals Guide.
For descriptions of supported MIBs and how to use MIBs, see Cisco's MIB web site on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
ASSOCIATE request---A feature of the TN3270 server that allows a client to connect to a printer LU that is attached to a terminal LU pool or a single terminal LU.
Cluster---Logical grouping of screens and printers of a defined layout in an LU pool.
LU pool---A group of LUs that can contain logical clusters to establish relationships between screen and printer LUs.
LU termination---A feature of the TN3270 server in Cisco IOS release 12.0(5)T that supports SNA's TERMSELF RU, which allows the TN3270 server to order termination of all sessions and session requests associated with an LU when users turn off their device or disconnect from the server.
TERMSELF RU---An SNA request/response unit that forces termination of all sessions and session requests associated with an LU.
The following sections describe how to configure LU pooling and response-time client groups, and use the new or modified TN3270 server configuration commands:
Refer to the "Configuration Examples" section for examples.
tn3270-server
keepalive 300
listen-point 10.10.10.1 tcp-port 40
pu PU1 94223456 tok 1 08
keepalive 10 send timing-mark 5
pu PU2 94223457 tok 2 12
In this example the keepalive command is first configured in TN3270 server configuration mode, which applies to all PUs supported by the TN3270 server. The keepalive command is specified again under the listen-point PU configuration mode for PU1, which overrides the previously specified keepalive 300 value, for PU1 only. PU2 continues to use the value of the keepalive command in the TN3270 server configuration level.
Table 2 provides a list of the TN3270 siftdown commands and the associated configuration modes in which they are supported. An X in the column indicates that the command is supported. A "-" indicates that the command is not supported.
| Siftdown Command | TN3270 Server (cfg-tn3270)# | Listen-point (tn3270-lpoint)# | Listen-point PU (tn3270-lpoint-PU)# | PU (tn3270-pu)# |
|---|---|---|---|---|
generic-pool | X | X | X | X |
idle-time | X | X | X | X |
ip precedence | X | X | - | X |
ip tos | X | X | - | X |
keepalive | X | X | X | X |
lu deletion | X | X | X | X |
lu termination | X | X | X | X |
tcp-port | X | - | - | X |
unbind-action | X | X | X | X |
To configure LU pools on the TN3270 server on a CMCC adapter, perform the following steps:
When configured, the pool becomes one of the several criteria used by the TN3270 server to assign an LU to a client. When a client requests a connection, the TN3270 server determines the authorized capabilities of the client. For example, the TN3270 server attempts to determine whether LU nailing definitions exist for the client.
Client preferences are taken into consideration. Examples of client preferences are:
When the client criteria is processed, the TN3270 server assigns the first available LU in the group to the client. If an appropriate LU is not found, the TN3270 connection is closed.
The first client in a cluster is given an LU in a cluster that currently has no LUs assigned to clients. Subsequent clients in the cluster are given suitable LUs from within the cluster.
To establish a TN3270 server on the internal LAN interface on the CMCC adapter and configure LU pooling, use the following commands beginning in global configuration mode:
When you use the listen-point command, you enter listen-point configuration mode and can use all other commands in this task list. Values that you enter for siftdown commands in listen-point configuration mode will override values that you previously entered in TN3270 server configuration mode.
| Step | Command | Purpose | ||
|---|---|---|---|---|
| Router(cfg-tn3270)#listen-point | Specifies the IP address and TCP port number to create a listen point. The default TCP port number is 23. This command changes the configuration mode from TN3270 to listen-point. | ||
| Router(tn3270-lpoint)#client | (Optional) Nails clients to pools. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies the idle time for server disconnect. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies the following keepalive parameters:
| ||
| Router(tn3270-lpoint)# | (Optional) Specifies the precedence level for IP traffic in the TN3270 server. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies the TOS level for IP traffic in the TN3270 server. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies whether the TN3270 session will disconnect when an UNBIND request is received. | ||
| Router(tn3270-lpoint)# | (Optional) Selects whether "left-over" LUs can be used from a generic LU pool. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies the type of termination request that is sent by the TN3270 server when a client turns off or disconnects a device. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies whether the TN3270 server sends a REPLY-PSID poweroff request to VTAM to delete the corresponding LU when a client disconnects. |
When you use the pu command, you enter listen-point PU configuration mode and can use all other commands in this task list. Values that you enter for siftdown commands in listen-point PU configuration mode will override values that you previously entered in listen-point configuration mode.
| Step | Command | Purpose | ||
|---|---|---|---|---|
| Router(tn3270-lpoint)#pu | Creates a PU. This command changes the configuration mode from listen-point to listen-point PU. | ||
| Router(tn3270-lpoint-pu)#allocate | (Optional) Assigns LUs to the pool. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies the idle time for server disconnect. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies the following keepalive parameters:
| ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies whether the TN3270 session will disconnect when an UNBIND request is received. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Selects whether "left-over" LUs can be used from a generic LU pool. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies the type of termination request that is sent by the TN3270 server when a client turns off his device or disconnects. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies whether the TN3270 server sends a REPLY-PSID poweroff request to VTAM to delete the corresponding LU when a client disconnects. |
This section provides the following procedures:
To establish a TN3270 server on the internal LAN interface on the CMCC adapter and configure LU pooling, use the following commands beginning in global configuration mode. When you use the tn3270-server command, you enter TN3270 server configuration mode and can use all other commands in the task list.
| Step | Command | Purpose | ||
|---|---|---|---|---|
| Router(config)#interface channel slot/port | Selects the channel attach internal LAN interface and enters interface configuration mode. | ||
| Router(config-if)#tn3270-server | Specifies a TN3270 server on the internal LAN interface and enters TN3270 server configuration mode. | ||
| Router(cfg-tn3270)# | Enters pool configuration mode. Defines clusters of LUs, and allocates LOCADDRs. | ||
| Router(cfg-tn3270)# | (Optional) Specifies the idle time for server disconnect. | ||
| Router(cfg-tn3270)# | (Optional) Specifies the following keepalive parameters:
| ||
| Router(cfg-tn3270)# | (Optional) Specifies the precedence level for IP traffic in the TN3270 server. | ||
| Router(cfg-tn3270)# | (Optional) Specifies the TOS level for IP traffic in the TN3270 server. | ||
| Router(cfg-tn3270)# | (Optional) Specifies whether the TN3270 session will disconnect when an UNBIND request is received. | ||
| Router(cfg-tn3270)# | (Optional) Selects whether "left-over" LUs can be used from a generic LU pool. | ||
| Router(cfg-tn3270)# | (Optional) Specifies the type of termination request that is sent by the TN3270 server when a client turns off or disconnects a device. | ||
| Router(cfg-tn3270)# | (Optional) Specifies whether the TN3270 server sends a REPLY-PSID poweroff request to VTAM to delete the corresponding LU when a client disconnects. | ||
| Router(cfg-tn3270)# | Creates a DLUR function in the TN3270 server and enters DLUR configuration mode. | ||
| Router(tn3270-dlur)# | Creates a SAP function under DLUR and enters DLUR SAP configuration mode. |
When you use the listen-point command, you enter listen-point configuration mode and can use all other commands in this task list. Values that you enter for siftdown commands in listen-point configuration mode will override values that you previously entered in TN3270 server configuration mode.
| Step | Command | Purpose | ||
|---|---|---|---|---|
| Router(cfg-tn3270)#listen-point | Specifies the IP address and TCP port number to create a listen point. The default TCP port number is 23. This command changes the configuration mode from TN3270 to listen-point. | ||
| Router(tn3270-lpoint)#client | (Optional) Nails clients to pools. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies the idle time for server disconnect. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies the following keepalive parameters:
| ||
| Router(tn3270-lpoint)# | (Optional) Specifies the precedence level for IP traffic in the TN3270 server. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies the TOS level for IP traffic in the TN3270 server. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies whether the TN3270 session will disconnect when an UNBIND request is received. | ||
| Router(tn3270-lpoint)# | (Optional) Selects whether "left-over" LUs can be used from a generic LU pool. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies the type of termination request that is sent by the TN3270 server when a client turns off or disconnects a device. | ||
| Router(tn3270-lpoint)# | (Optional) Specifies whether the TN3270 server sends a REPLY-PSID poweroff request to VTAM to delete the corresponding LU when a client disconnects. |
When you use the pu command, you enter listen-point PU configuration mode and can use all other commands in this task list. Values that you enter for siftdown commands in listen-point PU configuration mode will override values that you previously entered in listen-point configuration mode.
| Step | Command | Purpose | ||
|---|---|---|---|---|
| Router(tn3270-lpoint)#pu | Creates a DLUR PU. This command changes the configuration mode from listen-point to listen-point PU. | ||
| Router(tn3270-lpoint-pu)#allocate | (Optional) Assigns LUs to the pool. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies the idle time for server disconnect. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies the following keepalive parameters:
| ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies whether the TN3270 session will disconnect when an UNBIND request is received. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Selects whether "left-over" LUs can be used from a generic LU pool. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies the type of termination request that is sent by the TN3270 server when a client turns off or disconnects a device. | ||
| Router(tn3270-lpoint-pu)# | (Optional) Specifies whether the TN3270 server sends a REPLY-PSID poweroff request to VTAM to delete the corresponding LU when a client disconnects. |
For detailed examples of configuration verification procedures for specific TN3270 server scenarios, see the Cisco TN3270 Design and Implementation Guide.
To verify a TN3270 server configuration that uses LU pooling, perform the following steps:
Step 1 To display the current router configuration, enter the show run command:
router#show run
Building configuration...
interface Channel6/1
no ip address
no keepalive
csna E160 40
!
interface Channel6/2
ip address 172.18.4.17 255.255.255.248
no keepalive
lan TokenRing 15
source-bridge 15 1 500
adapter 15 4000.b0ca.0015
lan TokenRing 16
source-bridge 16 1 500
adapter 16 4000.b0ca.0016
tn3270-server
pool PCPOOL cluster layout 4s1p
pool SIMPLE cluster layout 1a
pool UNIXPOOL cluster layout 49s1p
dlur NETA.SHEK NETA.MVSD
lsap token-adapter 15 04
link SHE1 rmac 4000.b0ca.0016
listen-point 172.18.4.18 tcp-port 23
pu PU1 91903315 dlur
allocate lu 1 pool PCPOOL clusters 10
allocate lu 51 pool UNIXPOOL clusters 2
allocate lu 200 pool SIMPLE clusters 50
listen-point 172.18.4.19 tcp-port 2023
pu PU2 91913315 token-adapter 16 08
allocate lu 1 pool UNIXPOOL clusters 2
allocate lu 101 pool SIMPLE clusters 100
allocate lu 201 pool PCPOOL clusters 10
Step 2 To display information about the client LUs associated with a specific PU including the cluster layout and pool name, enter the show extended channel tn3270-server pu command:
Router#show extended channel 6/2 tn3270-server pu pu1 cluster name(index) ip:tcp xid state link destination r-lsap PU1(1) 172.18.4.18:23 91903315 ACTIVE dlur NETA.SHPU1 idle-time 0 keepalive 1800 unbind-act discon generic-pool perm ip-preced-screen 0 ip-preced-printer 0 ip-tos-screen 0 ip-tos-printer 0 bytes 27489 in, 74761 out; frames 1164 in, 884 out; NegRsp 0 in, 0 out actlus 5, dactlus 0, binds 5 Note: if state is ACT/NA then the client is disconnected lu name client-ip:tcp nail state cluster pool count 1 SHED1001 161.44.100.162:1538 N ACT/SESS 1/4s1p PCPOOL 1/5 51 SHED1051 161.44.100.162:1539 N ACT/SESS 1/49s1p UNIXPOOL 1/50 151 SHED1151 161.44.100.162:1536 N ACT/SESS 1/1a :GENERIC 1/1 152 SHED1152 161.44.100.162:1537 N ACT/SESS 1/1a :GENERIC 1/1 200 SHED1200 161.44.100.162:1557 N ACT/SESS 1/1a SIMPLE 1/1
Step 3 To verify the VTAM configuration and display the status of the switched major node and its associated PUs and LUs, enter the following command at the host. The following command shows the command for the switched major node labeled cbswn6:
D NET,ID=CBSWN6,E
| Command | Purpose |
|---|---|
Router(tn3270-resp-time)#response-time | Configures the client subnet response-time group. |
Router(tn3270-resp-time)#client | Specifies the IP address of the subnet being added to this client group. |
Router#show extended channel 3/2 tn3270-server response-time subnet group SUBNETGROUP1 subnet 10.10.10.0 255.255.255.192 aggregate NO excludeip NO dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100 group SUBNETGROUP2 subnet 10.10.10.128 255.255.255.192 subnet 10.10.10.192 255.255.255.192 aggregate NO exclude ip NO dynamic definite response NO sample period multiplier 40 bucket boundaries 20 30 60 120 group CLIENT SUBNET OTHER aggregate NO exclude ip NO dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100
Router#show extended channel 3/2 tn3270-server response-time subnet
10.10.10.0 255.255.255.192 detail
group SUBNETGROUP1
subnet 10.10.10.0 255.255.255.192
aggregate NO excludeip NO dynamic definite response NO
sample period multiplier 30
bucket boundaries 10 20 50 100
client 10.10.10.129:23
buckets 5 8 11 9 4
average total response time 33 average IP response time 24
number of transactions 37
client 10.10.10.130:23
buckets 6 9 10 10 2
average total response time 32 average IP response time 25
number of transactions 37
client 10.10.10.131:23
buckets 11 14 10 8 7
average total response time 27 average IP response time 19
number of transactions 50
Use the following commands in privileged EXEC mode to monitor the TN3270 server:
| Command | Purpose |
|---|---|
Router#show extended channel slot/virtual channel tn3270 pu pu-name [cluster] | Displays information about the client LUs associated with a specified PU including the cluster layout and pool name. |
Router#show extended channel slot/virtual channel tn3270 response-time application [appl-name [detail]] | Displays information about each client group application for the specified VTAM appl name. List each member of the client group with its individual response-time statistics. |
Router#show extended channel slot/virtual channel tn3270 response-time global | Displays information about the global client groups. |
Router#show extended channel slot/virtual/channel tn3270 response-time link [link-name] | Displays information about the specified per-host-link client group. |
Router#show extended channel slot/virtual channel tn3270 response-time listen-point | Displays information about listen-point type client groups. |
Router#show extended channel slot/virtual channel tn3270 response-time subnet [ip-mask [detail]] | Displays information about the specified client group. |
tn3270-server pu PU1 94223456 10.10.10.1 tok 1 08 tcp-port 40 keepalive 10
The following example shows the same router with TN3270 server configuration that replaces the existing configuration and uses the listen-point command to accomplish LU pooling. The listen-point command was first introduced in Cisco IOS release 11.2(18)BC.
tn3270-server listen-point 10.10.10.1 tcp-port 40 pu PU1 94223456 tok 1 08 keepalive 10
Note that in the new configuration, the IP address is not configured in the PU. Instead, the IP address is configured as a listen point and the PU is configured within the scope of the listen point. The tcp-port command is not configured within the scope of the PU, instead it is specified with the listen-point command.
tn3270-server pu PU1 94201231 10.10.10.2 tok 1 10 pu PU2 94201232 10.10.10.3 tok 1 12 pu PU3 94201234 10.10.10.3 tok 1 14 pu PU4 94201235 10.10.10.4 tok 1 16 tcp-port 40 pu PU5 94201236 10.10.10.4 tok 2 08
The following example shows the same router replaced with a configuration that uses the listen-point command introduced in Cisco IOS release 11.2(18)BC:
tn3270-server listen-point 10.10.10.2 pu PU1 94201231 tok 1 10 listen-point 10.10.10.3 pu PU2 94201232 tok 1 12 pu PU3 94201234 tok 1 14 listen-point 10.10.10.4 pu PU5 94201236 tok 2 08 listen-point 10.10.10.4 tcp-port 40 pu PU4 94201235 tok 1 16
In this example, PU2 and PU3 are grouped into one listen point because they have the same IP address. Note that even though PU4's IP address is identical to PU5's IP address, they are not configured within the same listen point because the listen point indicates a unique IP address and TCP port pair. If you do not specify the TCP port, the default port value is 23.
The following example shows a router with an existing configuration for DLUR:
tn3270-server dlur NETA.RTR1 NETA.HOST dlus-backup NETA.HOST lsap token-adapter 15 08 link MVS2TN rmac 4000.b0ca.0016 pu PU1 017ABCDE 10.10.10.6
The following example shows the same router replaced with a configuration that uses the new listen-point command introduced in Cisco IOS release 11.2(18)BC:
tn3270-server dlur NETA.RTR1 NETA.HOST dlus-backup NETA.HOST lsap token-adapter 15 08 link MVS2TN rmac 4000.b0ca.0016 listen-point 10.10.10.6 pu PU1 017ABCDE dlur
In this example, the PU is not configured within the scope of DLUR. Instead the PU is configured within the listen-point scope. The keyword dlur differentiates the listen-point direct PU from the listen-point DLUR PU. Note that the DLUR configuration must be completed before PU1 is configured.
Any siftdown commands configured within the scope of listen point are automatically inherited by the PUs that are configured within the scope of that listen point. To override the siftdown configurations, you can explicitly configure the siftdown configuration commands within the scope of the listen-point PU.
Figure 6 shows a router running the TN3270 server (with DLUR and direct PU) and its LU pooling configuration.
The following router configuration shows an example of commands used to define the TN3270 server with LU pools.
interface Channel6/1
no ip address
no keepalive
csna E160 40
!
interface Channel6/2
ip address 172.18.4.17 255.255.255.248
no keepalive
lan TokenRing 15
source-bridge 15 1 500
adapter 15 4000.b0ca.0015
lan TokenRing 16
source-bridge 16 1 500
adapter 16 4000.b0ca.0016
tn3270-server
pool NEREGION cluster layout 1a
pool PCPOOL cluster layout 4s1p
pool UNIXPOOL cluster layout 49s1p
dlur NETA.SHEK NETA.MVSD
lsap token-adapter 15 04
link SHE1 rmac 4000.b0ca.0016
listen-point 172.18.4.18
client ip 10.20.20.30 pool UNIXPOOL
client ip 10.20.40.0 255.255.255.0 pool PCPOOL
client ip 10.20.30.0 255.255.255.128 pool NEREGION
pu PU1 91903315 dlur
allocate lu 1 pool PCPOOL clusters 10
allocate lu 51 pool UNIXPOOL clusters 2
allocate lu 200 pool NEREGION clusters 50
listen-point 172.18.4.19
client ip 20.30.40.40 pool UNIXPOOL
client ip 20.40.34.0 255.255.255.0 pool PCPOOL
client ip 20.40.50.0 255.255.255.128 pool NEREGION
pu PU2 91913315 dlur
allocate lu 1 pool UNIXPOOL clusters 2
allocate lu 101 pool NEREGION clusters 100
allocate lu 201 pool PCPOOL clusters 10
Figure 7 shows cluster layouts for PU1 in the TN3270 server.
Figure 8 shows cluster layouts for PU2 in the TN3270 server.
This section documents new and modified commands. All other commands used with this feature are documented in the Cisco IOS release 12.0 Bridging and IBM Networking Command Reference.
In Cisco IOS release 12.0(1)T or later, you can search and filter the output for show and more commands. This functionality is useful when you need to sort through large amounts of output, or if you want to exclude output that you do not need to see.
To use this functionality, enter a show or more command followed by the "pipe" character (|), one of the keywords begin, include, or exclude, and an expression that you want to search or filter on:
command | {begin | include | exclude} regular-expression
Following is an example of the show atm vc command in which you want the command output to begin with the first line where the expression "PeakRate" appears:
show atm vc | begin PeakRate
For more information on the search and filter functionality, refer to the Cisco IOS Release 12.0(1)T feature module titled CLI String Search.
lu-address | Starting number of the LOCADDR to which a cluster of LUs are to be allocated. |
poolname | Pool name to which you want to allocate LUs. The pool name cannot exceed 8 characters. |
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. |
This command has no defaults.
Listen-point PU configuration
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
The following guidelines apply to the allocate lu command:
In the following example, the starting LOCADDR is 10. Each cluster has 10 LOCADDRs, therefore 50 LOCADDRs are allocated to the pool name LOT1.
interface channel 0/2
tn3270-server
pool LOT1 cluster layout 4s1p
listen-point 10.20.30.40
pu PU1
allocate lu 10 pool LOT1 clusters 5
As a result of this configuration, the following LOCADDRs are created in each cluster:
Cluster 1
Cluster 2
All of the LUs in these clusters are allocated to pool LOT1.
| Command | Description |
Defines pool names for the TN3270 server and specifies the number of screens and printers in each logical cluster. | |
tn3270-server | Starts the TN3270 server on a CMCC adapter and enters TN3270 configuration mode. |
Creates a PU entity that has a direct link to a host or enters listen-point PU configuration mode. | |
Creates a PU entity that has no direct link to a host or enters listen-point PU configuration mode. |
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. |
This command has no defaults.
Response-time configuration
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
Following is an example of the client ip command:
tn3270-server response-time group acctg client ip 10.1.2.3 255.0.0.0
| Command | Description |
Configures a client subnet group for response-time measurements. | |
show extended channel tn3270-server response-time application | Displays information for application client groups. |
Displays information about the global client group. | |
Displays information about host link client groups. | |
show extended channel tn3270-server response-time listen-point | Displays information about listen-point client groups. |
Displays information about subnet client groups. | |
tn3270-server | Starts the TN3270 server on a CMCC adapter and enters TN3270 configuration mode. |
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 | Specify a unique pool name. The pool name cannot exceed 8 characters. |
This command has no defaults.
Listen-point configuration
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
If the pool is configured while LUs are in use, existing clients are allowed to complete their sessions. A pool name can be identical to an LU name. When assigning an LU, the TN3270 server searches the LU name space first for specific requests, such as connections that specify a device name on CONNECT or LU name in the terminal type negotiation. The request is assumed to be directed to the specific LU rather than to the pool. Make sure the name spaces do not clash.
The following is an example of the client ip pool command that nails the client at IP address 10.1.2.3 with an IP mask of 255.255.255.0 to the pool named OMAHA:
tn3270-server pool OMAHA cluster layout 10s1p listen-point 172.18.4.18 client ip 10.1.2.3 255.255.255.0 pool OMAHA
| Command | Description |
Defines an IP address for the TN3270 server. | |
Defines pool names for the TN3270 server and specifies the number of screens and printers in each logical cluster. | |
Creates a PU entity that has no direct link to a host or enters listen-point PU configuration mode. | |
Creates a PU that has a direct link to a host or enters listen-point PU configuration mode. | |
tn3270-server | Starts the TN3270 server on a CMCC adapter or enters TN3270 configuration mode. |
Use the keepalive TN3270 configuration command 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 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]}]
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. |
The default behavior is to send timing-mark with a keepalive interval of 1800 seconds (30 minutes). If you specify only the keepalive interval, the TN3270 server sends timing-marks.
The default value of the send timing-mark max-response-time 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.
TN3270 server configuration---The keepalive command at this level applies to all PUs supported by the TN3270 server.
Listen-point configuration---The keepalive command at this level applies to all PUs defined at the listen point.
Listen-point PU configuration---The keepalive command at this level applies only to the specified PU.
PU configuration---The keepalive command at this level applies only to the specified PU.
| Release | Modification |
|---|---|
11.2 | This command was first introduced. |
12.0(5)T | The send {nop | timing-mark [max-response-time]} keywords were added. |
The keepalive command is valid only on the virtual channel interface. This command can be entered in one of four command modes (TN3270 configuration, Listen-point configuration, Listen-point PU configuration, or PU configuration mode). A value entered in TN3270 mode applies to all PUs for that TN3270 server, except as overridden by values entered in the other supported configuration modes. A no keepalive command entered in a subsequent configuration mode will restore the keepalive value entered in the previous command mode.
In Cisco IOS releases prior to 12.0(5)T in which the keepalive command is supported, you cannot specify the period of time in which the client must respond to the DO TIMING-MARK before the TN3270 server disconnects the session. By default in prior releases, if the client does not reply within 30 minutes of the transmission of the DO TIMING-MARK, the TN3270 server disconnects the TN3270 session. (The DO TIMING-MARK is a Telnet protocol operation that does not affect the client operation.)
With the addition of the send timing-mark max-response-time keywords in Cisco IOS release 12.0(5)T, you can specify the period of time in which the client must respond to the DO TIMING-MARK before being disconnected by the server. If you do not specify the max-response-time, the default value is determined by the size of the keepalive interval. 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.
If the IP path to the client is broken, the TCP layer will detect the failure to acknowledge the DO TIMING-MARK and initiate disconnection. This action usually takes much less than 30 seconds.
The keepalive command affects currently active and future TN3270 sessions. For example, reducing the keepalive interval to a smaller nonzero value causes an immediate burst of DO TIMING-MARKs on those sessions that have been inactive for a period of time greater than the new, smaller value.
Use the keepalive send nop command when you are using older TN3270 clients that do not support TIMING-MARK or are DOS-based clients. When you use the keepalive send nop command to monitor the client connection, no response is required by the client to the TN3270 server. However, the TCP/IP stack can detect that the physical connection still exists. This command is useful for those clients that can be swapped out when a DO TIMING-MARK has been sent by the TN3270 server. If the client is swapped out and cannot respond to the DO TIMING-MARK from the TN3270 server, the session is disconnected. However, if the client is swapped out and the Telnet nop command is sent by the server, the physical connection is still verifiable by the TCP/IP stack and the client remains connected to the server.
If your client supports the use of timing-marks and is not subject to being swapped out, then using timing-marks is preferable to the Telnet nop command for keepalive monitoring. The required response by TN3270 clients to timing-marks sent by the server provides a better indication of the health of the client-server connection.
The following example specifies that the TN3270 server transmits a DO TIMING-MARK in 15-minute (900-second) intervals and the client must respond within 30 seconds (the default for the timing-mark max-response-time when not specified):
keepalive 900
The following example entered in TN3270 configuration mode specifies that the TN3270 server transmits a DO TIMING-MARK in 30-minute (1800-second) intervals (the default interval) and the client must respond within 30 seconds (the default for the timing-mark max-response-time when not specified):
no keepalive
The following example specifies that the TN3270 server transmits a DO TIMING-MARK in 40-minute (2400-second) intervals and the client must respond within 1 minute (60 seconds):
keepalive 2400 send timing-mark 60
Consider the following example in which the keepalive command is configured in more than one command mode. In this example the keepalive command is first configured in TN3270 server configuration mode, followed by Listen-point PU configuration mode. The keepalive command values specified under the listen-point PU overrides the keepalive 300 value specified under the tn3270-server for PU1. In this example, all other PUs except PU1 use the value of the keepalive 300 command specified in TN3270 configuration mode.
tn3270-server
keepalive 300
listen-point 10.10.10.1 tcp-port 40
pu PU1 94223456 tok 1 08
keepalive 10 send timing-mark 5
pu PU2 94223457 tok 2 12
| Command | Description |
idle-time | Specifies the number of seconds of LU inactivity, from both host and client, before the TN3270 session is disconnected. |
timing-mark | Selects whether a WILL TIMING-MARK is transmitted when the host application needs an SNA response (definite or pacing response). |
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. |
This command has no defaults.
TN3270 server configuration
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
Use the listen-point command to create a unique listen point for every IP address and TCP-port pair. In this mode, the IP address and the TCP port are no longer configured in the PU. Configure the PUs under the appropriate listen point. The other siftdown configuration commands remain the same.
For example, in the old configuration the following statements were used to configure the IP address and TCP port in the PU:
tn3270-server pu PU1 94223456 10.10.10.1 tok 1 08 tcp-port 40 keepalive 10
In the new listen-point configuration, the following statements are used to configure the IP address and TCP port at the listen point:
tn3270-server
listen-point 10.10.10.1 tcp-port 40
pu PU1 94223456 tok 1 08
keepalive 10
You can also use the listen-point configuration to assign the same IP address to multiple PUs. In the old configuration the following statements were used:
tn3270-server pu PU1 94201231 10.10.10.2 tok 1 10 pu PU2 94201232 10.10.10.3 tok 1 12 pu PU3 94201234 10.10.10.3 tok 1 14 pu PU4 94201235 10.10.10.4 tok 1 16 tcp-port 40 pu PU5 94201236 10.10.10.4 tok 2 08
In the new listen point configuration, the old statements are replaced by the following configuration commands. In this example, PU2 and PU3 are grouped into one listen point because they have the same IP address. Note that even though PU4's IP address is identical to PU5's IP address, they are not configured within the same listen point because the listen point indicates a unique IP address and TCP port pair. If you do not specify the TCP port, the default port value is 23.
tn3270-server listen-point 10.10.10.2 pu PU1 94201231 tok 1 10 listen-point 10.10.10.3 pu PU2 94201232 tok 1 12 pu PU3 94201234 tok 1 14 listen-point 10.10.10.4 pu PU5 94201236 tok 2 08 listen-point 10.10.10.4 tcp-port 40 pu PU4 94201235 tok 1 16
The next example shows how the configuration changes for a DLUR PU. In this mode, the DLUR PU is no longer configured under DLUR, but is configured in the listen point.
In the old configuration, the following statements were used:
tn3270-server dlur NETA.RTR1 NETA.HOST dlus-backup NETA.HOST lsap token-adapter 15 08 link MVS2TN rmac 4000.b0ca.0016 pu PU1 017ABCDE 10.10.10.6
These statements are replaced by the following statements in the new listen-point configuration. The keyword dlur differentiates the listen-point direct PU from the listen point DLUR PU. The DLUR configuration must be completed before configuring the PU in the listen-point. Any siftdown commands configured within the scope of the listen point are automatically inherited by the PUs that are configured within the scope of that listen point. To override the siftdown configurations, you can explicitly configure the siftdown configuration commands within the scope of the listen-point PU.
tn3270-server dlur NETA.RTR1 NETA.HOST dlus-backup NETA.HOST lsap token-adapter 15 08 link MVS2TN rmac 4000.b0ca.0016 listen-point 10.10.10.6 pu PU1 017ABCDE dlur
Following is an example of the listen-point command showing PU7 grouped into the listen point at IP address 10.10.10.1 and TCP port 40:
tn3270-server listen-point 10.10.10.1 tcp-port 40 pu PU7 94201237 tok 1 17
| Command | Description |
tn3270-server | Starts the TN3270 server on a CMCC adapter and enters TN3270 configuration mode. |
unbind-action keep | Selects what action to take when the TN3270 server receives an UNBIND. |
Creates a PU entity that has no direct link to a host or enters listen-point PU configuration mode. | |
Creates a PU entity that has a direct link to a host or enters listen-point PU configuration mode. |
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. |
The default keyword is never.
TN3270 server configuration---The lu deletion command at this level applies to all PUs supported by the TN3270 server.
Listen-point configuration---The lu deletion command at this level applies to all PUs defined at the listen point.
Listen-point PU configuration---The lu deletion command at this level applies only to the specified PU.
PU configuration---The lu deletion command at this level applies only to the specified PU.
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
Use the always mode of LU deletion when you have only screen LUs, but they are all of different sizes. This prevents screen LUs from attaching to a previously used LU with an incompatible screen size designated by a previous session.
Use the normal mode of LU deletion when you have both screen and printer LUs. This is important because printers are acquired by the host application and are not logged on manually. If VTAM deletes the LU, then there is nothing for a host application (such as CICS) to acquire.
Use the never mode of LU deletion when you have only screen LUs and they all use the same screen size.
Following is an example of the lu deletion command specifying that the TN3270 server sends a REPLY-PSID poweroff request to delete only screen LUs upon session disconnect for any PUs supported by the TN3270 server:
tn3270-server lu deletion normal
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. |
Unbind is the default.
TN3270 server configuration---The lu termination command at this level applies to all PUs supported by the TN3270 server.
Listen-point configuration---The lu termination command at this level applies to all PUs defined at the listen point.
Listen-point PU configuration---The lu termination command at this level applies only to the specified PU.
PU configuration---The lu termination command at this level applies only to the specified PU.
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
Use the termself keyword when you want to be sure that the application terminates the session when the LU disconnects. This is important for certain applications such as CICS.
If you use the unbind keyword for session termination with applications such as CICS, VTAM security problems can arise. When CICS terminates a session from an UNBIND request, the application may reestablish a previous user's session with a new user, who is now assigned to the same freed LU.
Following is an example of the lu termination configuration command to force termination of the session when an LU disconnects for any PUs supported by the TN3270 server:
tn3270-server lu termination termself
poolname | Unique pool name which cannot exceed eight characters. Valid characters are (alphabetic characters are not case sensitive): · 1st character---Alphabetic (A-Z) and national characters `@', `#', and `$' · 2nd-8th characters---Alphabetic (A-Z), numeric (0-9), and national characters `@', `#', and `$' |
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" for the layout-spec-string.
TN3270 server configuration
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
The pool and allocate lu commands enable the TN3270 server to know the relationships between screen and printer LUs. These commands are an alternative to the LU nailing feature that allows clients to be nailed to LUs.
The pool command is configured in the TN3270 scope. The pool command provides the pool names and the definitions of the number of screens and printers in one logical cluster. Each pool statement must have a unique pool name.
The TN3270 server validates pool names when configuring a pool name and when processing the name received on a CONNECT request from the client. The TN3270 server rejects an invalid name and truncates the name received in the CONNECT request from the client to eight characters or at an invalid character (whichever comes first) when processing the CONNECT request.
When using a pool command to create a cluster, a combination of the following values is used in the layout-spec-string:
Use the following format to define the layout-spec-string, where decimal_num is a decimal number between 1 and 255:
pool poolname cluster layout {decimal_nums}{decimal_nump}{decimal_numa}
The total 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 is 1a, which defines 1 screen or 1 printer. A screen, printer, or a wildcard definition cannot be followed by a definition of the same type. A screen definition can only be followed by a printer or wildcard. Similarly, a printer definition can be followed only by a wildcard or a screen definition.
The following are examples of invalid layout-spec-string values, and the corresponding corrected specification:
The combination of a screen, printer, and wildcard constitute a group. The layout-spec-string can support a maximum of 4 groups.
Consider the following example:
pool CISCO cluster layout 2s3p4a5s6a7s8p9s
There are 4 groups in this definition: 2s3p4a, 5s6a, 7s8p and 9s.
Pools must be defined before any pool references under the listening points are defined. Also, pools must be defined before they are referenced by other statements in the configuration. Failure to define the pool before it is referenced will cause the referencing configuration to be rejected.
Pools that are deleted (using the no form of the command) will cause all statements referencing the pool to be deleted.
The following criteria apply to the creation of pool names and LOCADDRs:
The following example uses the pool command to create two pools, pcpool and unixpool:
tn3270-server pool pcpool cluster layout 4s1p pool unixpool cluster layout 49s1p listen-point 10.20.30.40 client ip 10.10.10.2 pool pcpool pu PU1 91903315 dlur allocate lu 1 pool pcpool clusters 50 pu PU2 91903345 dlur allocate lu 1 pool unixpool clusters 5
In this example, the pcpool contains a cluster of 4 screens and 1 printer per cluster. The total number of devices in a cluster cannot exceed 255, therefore the pcpool contains a total of 50 clusters with each cluster containing 5 LUs. Note that the remaining 5 LUs automatically go to the generic pool.
The unixpool contains 49 screens and 1 printer per cluster. The total number of devices in a cluster cannot exceed 255, therefore the unixpool contains a total of 5 clusters with each cluster containing 50 LUs. Again, note that the last 5 LUs automatically go to the generic pool.
| Command | Description |
tn3270-server | Starts the TN3270 server on a CMCC adapter and enters TN3270 configuration mode. |
pu-name | Name that uniquely identifies this PU. |
idblk-idnum | Value that matches 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. |
The default remote SAP address is 04 (hexadecimal).
Listen-point configuration
| Release | Modification |
|---|---|
11.2 | This command was first introduced. |
11.2(18)BC | Listen-point PU configuration was added. |
12.0(5)T | None. |
The pu pu-name command is valid only on the virtual channel interface. If the PU is already created, the pu pu-name command with no arguments puts you in listen-point PU configuration mode, where you can modify an existing PU entity.
The pu listen-point command uses values that are defined in two other commands: the lan internal LAN configuration command and the adapter internal LAN configuration command. The lan type and adapter adapter-number values configured on the CIP internal LAN interface are used in the pu command.
For a link via a channel on this CMCC adapter, the TN3270 server and the hosts should open different adapters. Using different adapters avoids contention for SAP numbers and is also necessary if you configure duplicate MAC addresses for fallback CSNA or CMPC access to the host.
The following example configures the TN3270 server to be active and has one PU, CAPPU1, trying to connect. An LU seed using hexadecimal digits is defined.
tn3270-server pu CAPPU1 05D18101 token-adapter 3 04 rmac 4000.0501.0001 lu-seed CAP01L##
The following example shows different adapter numbers configured on the same internal LAN to avoid SAP contention. The host uses SAP 4 on Token Ring adapter 0.
lan tokenring 0 adapter 0 4000.0000.0001 adapter 1 4000.0000.0002 tn3270-server listen-point 10.20.30.40 pu PU1 05d00001 token-adapter 1 8 rmac 4000.0000.0001 rsap 4
| Command | Description |
adapter | Configures internal adapters. |
lan | Configures an internal LAN on a CMCC adapter interface and enters the internal LAN configuration mode. |
Defines an IP address for the TN3270 server. | |
show extended channel tn3270-server | Displays current server configuration parameters and the status of the PUs defined for the TN3270 server. |
pu-name | Name that uniquely identifies this PU. |
idblk-idnum | Value that 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. |
No PU is defined.
Listen-point configuration
| Release | Modification |
|---|---|
11.2 | This command was first introduced. |
11.2(18)BC | Listen-point PU configuration was added. |
12.0(5)T | None. |
If the PU is already created, the pu dlur command without any arguments starts listen-point PU configuration mode. In this mode you can modify an existing listen-point DLUR PU entity.
You should define the DLUR before you configure the listen-point DLUR PU.
A typical usage for the IP address is to reserve an IP address for each application. For example, clients wanting to connect to TSO specify an IP address that is defined with PUs that have LOGAPPL=TSO.
The following example defines three PUs in the listen point with an IP address of 172.18.4.18:
tn3270-server listen-point 172.18.4.18 pu p0 05D99001 dlur pu p1 05D99002 dlur pu p2 05D99003 dlur
| Command | Description |
dlur | Enables the Systems Network Architecture (SNA) session switch function on the CMCC adapter or enters dependent logical unit requester (DLUR) configuration mode. |
Defines an IP address for the TN3270 server. |
response-time group name [bucket boundaries t1 t2 t3 t4...] [multiplier m]
no response-time group name
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 | 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: · Bucket boundaries---10, 20, 50, 100 · Multiplier---30 |
multiplier m | Number in the range of 1 to 5760, which when multiplied by the sample interval of 20 seconds, determines the collection interval. |
Bucket boundaries and the multiplier value are fixed to the following defaults:
TN3270 server configuration
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
Multiple response-time groups can be configured within the scope of available memory. When using this command, up to 1024 IP subnets can be defined per response-time group with the client ip command. All TN3270 clients belonging to subnets configured within a specific response-time group are added to the response-time group when they connect as clients.
If the IP address and mask combination already exists within any response-time group, the following error message is displayed:
Subnet 10.1.1.0 255.255.255.248 already exists in client group MYSUBNET
In the following example, the response-time group MYSUBNET is configured:
tn3270-server response-time group MYSUBNET bucket boundaries 15 25 60 120 multiplier 35 client ip 10.1.1.0 255.255.255.248 client ip 10.1.2.0 255.255.255.248
| Command | Description |
Adds an IP subnet to a client subnet response-time group. | |
show extended channel tn3270-server response-time application | Displays information for application client groups. |
Displays information about the global client group. | |
Displays information about host link client groups. | |
show extended channel tn3270-server response-time listen-point | Displays information about listen-point client groups. |
Displays information about subnet client groups. |
Use the show extended channel tn3270-server EXEC command to display current server configuration parameters and the status of the PUs defined for the TN3270 server.
show extended channel slot/port tn3270-server
slot | Specifies a particular CMCC adapter in the router where slot is the slot number. |
port | The port value for a TN3270 server will always be 2. |
This command has no defaults.
EXEC
| Release | Modification |
|---|---|
11.2 | This command was first introduced. |
12.0(5)T | The lu-termination and lu-deletion fields were added to the output display. |
The following is sample output from the show extended channel tn3270-server command:
Router#show extended channel 3/2 tn3270-server <current stats> < connection stats > <response time(ms)> server-ip:tcp lu in-use connect disconn fail host tcp 172.28.1.106:23 510 1 12 11 0 54 40 172.28.1.107:23 511 0 0 0 0 0 0 172.28.1.108:23 255 0 0 0 0 0 0 total 1276 1 configured max_lu 20000 idle-time 0 keepalive 1800 unbind-action disconnect tcp-port 23 generic-pool permit no timing-mark lu-termination unbind lu-deletion never dlur MPX.GOANCP status SHUT dlus MPX.NGMVMPC name(index) ip:tcp xid state link destination r-lsap EXT2(1) 172.28.1.106:23 05D18092 ACTIVE tok 0 4000.7470.00e7 08 04 PUS10(2) 172.28.1.107:23 05D19010 ACTIVE tok 0 4000.7470.00e7 08 2C PUS11(3) 172.28.1.107:23 05D19011 ACTIVE tok 0 4000.7470.00e7 08 28 PUS12(4) 172.28.1.108:23 05D19012 ACTIVE tok 0 4000.7470.00e7 08 24 PUS9(5) 172.28.1.109:23 05D18509 SHUT tok 0 4001.3745.1088 04 40 SDTF(7) 172.28.1.107:23 12345678 ACTIVE tok 0 0800.5a4b.1cbc 04 08 TEST(8) 172.28.1.106:23 05D18091 ACTIVE tok 0 4000.7470.00e7 08 30 INT1(6) 172.28.1.106:23 05D18091 SHUT dlur
Table 3 provides descriptions for the new lu-termination and lu-deletion output fields.
| Field | Description |
|---|---|
lu-termination | Displays the value configured for the lu termination siftdown command for the PUs supported by the TN3270 server. The lu termination command specifies whether a TERMSELF or UNBIND RU is sent by the TN3270 server when a client turns off the device or disconnects. The possible values are:
|
lu-deletion | Displays the value configured for the lu deletion siftdown command for the PUs supported by the TN3270 server. The lu deletion command specifies whether the TN3270 server sends a REPLY-PSID poweroff request to VTAM to delete the corresponding LU when a client disconnects. The possible values are:
|
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. |
This command has no defaults.
Privileged EXEC
| Release | Modification |
|---|---|
11.2 | This command was first introduced. |
11.2(18)BC | The cluster keyword was added. |
12.0(5)T | The lu-termination and lu-deletion fields were added to the output display. |
The output for the show extended channel tn3270-server pu command varies by whether you are using the optional cluster keyword. Without the cluster keyword, the output column headings for the LU information appear as "model," "frames in out," and "idle for."
When you use the cluster keyword, the output column headings for the LU information appear as "cluster," "pool," and "count." The cluster heading lists the specific cluster within the pool to which the LU belongs along with the specific cluster layout after the slash.
The pool heading identifies the corresponding pool name, and the count heading identifies the cluster number out of the total number of clusters in the pool.
This example shows a sample router configuration and the corresponding output using the show extended channel tn3270-server pu command.
interface Channel6/1
no ip address
no keepalive
csna E160 40
!
interface Channel6/2
ip address 172.18.4.17 255.255.255.248
no keepalive
lan TokenRing 15
source-bridge 15 1 500
adapter 15 4000.b0ca.0015
lan TokenRing 16
source-bridge 16 1 500
adapter 16 4000.b0ca.0016
tn3270-server
pool PCPOOL cluster layout 4s1p
pool SIMPLE cluster layout 1a
pool UNIXPOOL cluster layout 49s1p
dlur NETA.SHEK NETA.MVSD
lsap token-adapter 15 04
link SHE1 rmac 4000.b0ca.0016
listen-point 172.18.4.18 tcp-port 23
pu PU1 91903315 dlur
allocate lu 1 pool PCPOOL clusters 10
allocate lu 51 pool UNIXPOOL clusters 2
allocate lu 200 pool SIMPLE clusters 50
listen-point 172.18.4.19 tcp-port 2023
pu PU2 91913315 token-adapter 16 08
allocate lu 1 pool UNIXPOOL clusters 2
allocate lu 101 pool SIMPLE clusters 100
allocate lu 201 pool PCPOOL clusters 10
Following is an example of output for the show extended channel tn3270-server pu command without the cluster keyword for a PU named PU1:
Router#show extended channel 6/2 tn3270-server pu pu1 name(index) ip:tcp xid state link destination r-lsap PU1(1) 172.18.4.18:23 91903315 ACTIVE dlur NETA.SHPU1 idle-time 0 keepalive 1800 unbind-act discon generic-poolperm ip-preced-screen 0 ip-preced-printer 0 ip-tos-screen 0 ip-tos-printer 0 lu-termination unbind lu-deletion never bytes 27019 in, 73751 out; frames 1144 in, 869 out; NegRsp 0 in, 0 out actlus 5, dactlus 0, binds 5 Note: if state is ACT/NA then the client is disconnected lu name client-ip:tcp nail state model frames in out idle for 1 SHED1001 161.44.100.162:1538 N ACT/SESS 3278S2E 228 172 0:0:2 51 SHED1051 161.44.100.162:1539 N ACT/SESS 3278S2E 240 181 0:0:2 151 SHED1151 161.44.100.162:1536 N ACT/SESS 327802E 212 160 0:0:5 152 SHED1152 161.44.100.162:1537 N ACT/SESS 3278S2E 220 166 0:0:4 200 SHED1200 161.44.100.162:1557 N ACT/SESS 3278S2E 244 184 0:0:2
Following is an example of output for the show extended channel tn3270-server pu command with the cluster keyword for a PU named PU1. In the example below, 1/1a identifies cluster 1 with a layout of 1a, which contains 1 LU of any type.
Router#show extended channel 6/2 tn3270-server pu pu1 cluster name(index) ip:tcp xid state link destination r-lsap PU1(1) 172.18.4.18:23 91903315 ACTIVE dlur NETA.SHPU1 idle-time 0 keepalive 1800 unbind-act discon generic-poolperm ip-preced-screen 0 ip-preced-printer 0 ip-tos-screen 0 ip-tos-printer 0 lu-termination unbind lu-deletion never bytes 27489 in, 74761 out; frames 1164 in, 884 out; NegRsp 0 in, 0 out actlus 5, dactlus 0, binds 5 Note: if state is ACT/NA then the client is disconnected lu name client-ip:tcp nail state cluster pool count 1 SHED1001 161.44.100.162:1538 N ACT/SESS 1/4s1p PCPOOL 1/5 51 SHED1051 161.44.100.162:1539 N ACT/SESS 1/49s1p UNIXPOOL 1/50 151 SHED1151 161.44.100.162:1536 N ACT/SESS 1/1a :GENERIC 1/1 152 SHED1152 161.44.100.162:1537 N ACT/SESS 1/1a :GENERIC 1/1 200 SHED1200 161.44.100.162:1557 N ACT/SESS 1/1a SIMPLE 1/1
Table 4 provides descriptions for the new lu-termination and lu-deletion output fields.
| Field | Description |
|---|---|
lu-termination | Displays the value configured in the PU for the lu termination siftdown command. The lu termination command specifies whether a TERMSELF or UNBIND RU is sent by the TN3270 server when a client turns off the device or disconnects. The possible values are:
|
lu-deletion | Displays the value configured in the PU for the lu deletion siftdown command. The lu deletion command specifies whether the TN3270 server sends a REPLY-PSID poweroff request to VTAM to delete the corresponding LU when a client disconnects. The possible values are:
|
| Command | Description |
Assigns LUs to a pool. |
Use the show extended channel tn3270-server pu lu privileged EXEC command to display information about the TN3270 server LUs running on a CMCC adapter interface.
show extended channel slot/port tn3270-server pu pu-name lu locaddr [history]
slot | Specifies a particular CMCC adapter in the router where slot is the slot number. |
port | Port value for a TN3270 server is always 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. |
This command has no defaults.
Privileged EXEC
| Release | Modification |
|---|---|
11.2 | This command was first introduced. |
11.2(18)BC | The response time buckets, average total response time, average IP response time, and the number of transactions fields were added to the output display. |
12.0(5)T | None. |
The show extended channel tn3270-server pu lu command is valid only on the virtual channel interface.
This example shows the response-time information using the show extended channel tn3270-server pu lu command for the LU at LOCADDR 1 associated with the PU named vincdpu.
sydney#show extended channel 1/2 tn3270-server pu vincdpu lu 1 Note: if state is ACT/NA then the client is disconnected lu name client-ip:tcp nail state model frames in out idle for 1 VINDG001 161.44.100.210:1315 N ACT/NA 3278S2E 12 11 0:0:18 pu is VINCDPU, lu is DYNAMIC unbound, negotiated TN3270E bytes 253 in, 954 out; RuSize 0 in, 0 out; NegRsp 1 in, 0 out pacing window 0 in, 1 out; credits 0 in, queue-size 0 in, 0 out response time buckets 14 31 15 3 1 average total response time 19 average IP response time 8 number of transactions 64
Table 5 provides descriptions for the new response-time output fields.
| Field | Description |
|---|---|
response time buckets | Displays the number of transactions in each response-time "bucket" for the specified LU. The bucket boundaries are defined using the response-time group command. |
average total response time | Displays the average response time (in tenths of seconds) for the total number of response-time transactions. |
average IP response time | Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions. |
number of transactions | Displays the total number of response-time transactions across all response-time buckets. |
| Command | Description |
Configures a client subnet group for response-time measurements. |
slot | Slot number. |
virtual channel | Virtual channel number. |
appl-name | Display only the client group corresponding to the VTAM application name. |
detail | List client members and their response-time statistics following the client group entry. |
This command has no defaults.
Privileged EXEC
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
If optional keywords are not used for the show extended channel tn3270-server response-time application command, a complete list of currently existing per-application client groups is displayed along with their collection control parameters. If you specify the appl-name keyword, only the client group corresponding to that application is displayed. If you specify the detail keyword, the client group entry is followed by a list of its client members and their response-time statistics.
Following is an example of output for the show extended channel tn3270-server response-time application:
Router#show extended channel 3/2 tn3270-server response-time application MYAPPL group APPL MYAPPL aggregate NO excludeip NO dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100
Table 6 provides descriptions of the output fields for the show extended channel tn3270-server response-time application command.
| Field | Description |
|---|---|
aggregate | Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to NO by the TN3270 server for application client response-time groups. |
excludeip | Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the SNA component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to NO by the TN3270 server for application client response-time groups. |
dynamic definite response | Displays whether the server adds a Definite Response request to the First-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups. |
sample period multiplier | Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group. |
response time buckets | Displays the number of transactions in each response-time "bucket" for the specified application group. The bucket boundaries are defined using the response-time group command. |
average total response time | Displays the average response time (in tenths of seconds) for the total number of response-time transactions. |
average IP response time | Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions. |
number of transactions | Displays the total number of response-time transactions across all response-time buckets. |
| Command | Description |
Configures a client subnet group for response-time measurements. | |
Displays information about the global client group. | |
Displays information about host link client groups. | |
show extended channel tn3270-server response-time listen-point | Displays information about listen-point client groups. |
Displays information about subnet client groups. |
slot | Slot number. |
virtual channel | Virtual channel number. |
This command has no defaults.
Privileged EXEC
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
The show extended channel tn3270-server response-time global command displays collection control parameters for the global client group.
Following is an example of output for the show extended channel tn3270-server response-time global command:
Router#show extended channel 3/2 tn3270-server response-time global group CLIENT GLOBAL aggregate YES excludeip NO dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100 buckets 105 118 211 109 104 average total response time 33 average IP response time 24 number of transactions 647
Table 7 provides descriptions of the output fields for the show extended channel tn3270-server response-time global command.
| Field | Description |
|---|---|
aggregate | Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to YES by the TN3270 server for global client response-time groups. |
excludeip | Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the SNA component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to NO by the TN3270 server for global client response-time groups. |
dynamic definite response | Displays whether the server adds a Definite Response request to the First-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups. |
sample period multiplier | Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group. |
bucket boundaries | Displays the value of the response-time bucket boundaries in tenths of seconds. The bucket boundaries are defined using the response-time group command. |
buckets | Displays the number of transactions in each response-time bucket for the specified application group. |
average total response time | Displays the average response time (in tenths of seconds) for the total number of response-time transactions. |
average IP response time | Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions. |
number of transactions | Displays the total number of response-time transactions across all response-time buckets. |
| Command | Description |
Configures a client subnet group for response-time measurements. | |
show extended channel tn3270-server response-time application | Displays information for application client groups. |
Displays information about host link client groups. | |
show extended channel tn3270-server response-time listen-point | Displays information about listen-point client groups. |
Displays information about subnet client groups. |
slot | Slot number. |
virtual channel | Port number. |
link-name | PU name for a direct PU or link name for a DLUR PU. |
This command has no defaults.
Privileged EXEC
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
This command displays information clients groups by host link. If no optional keywords are specified, a complete list of currently existing client groups by host link is displayed along with their collection control parameters and aggregate response-time statistics. If link-name is specified, only the client group corresponding to that link is displayed.
Following is an example of the output for the show extended channel tn3270-server response-time link command without optional keywords, which shows all current client groups by host link:
Router#show extended channel 3/2 tn3270-server response-time link group DIRECT LINK MYLINK aggregate YES excludeip YES dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100 buckets 10 18 21 10 10 average total response time 37 average IP response time 23 number of transactions 69 group DLUR LINK HISLINK aggregate YES excludeip YES dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100 buckets 14 31 15 3 1 average total response time 19 average IP response time 8 number of transactions 64
Following is an example of the output for the show extended channel tn3270-server response-time link command for the link named DIRECT LINK MYLINK:
Router#show extended channel 3/2 tn3270-server response-time link direct link mylink group DIRECT LINK MYLINK aggregate YES excludeip YES dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100 buckets 10 18 21 10 10 average total response time 37 average IP response time 23 number of transactions 69
Table 8 provides descriptions of the output fields for the show extended channel tn3270-server response-time link command.
| Field | Description |
|---|---|
aggregate | Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to YES by the TN3270 server for link client response-time groups. |
excludeip | Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the SNA component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to YES by the TN3270 server for link client response-time groups. |
dynamic definite response | Displays whether the server adds a Definite Response request to the First-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups. |
sample period multiplier | Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group. |
bucket boundaries | Displays the value of the response-time bucket boundaries in tenths of seconds. The bucket boundaries are defined using the response-time group command. |
buckets | Displays the number of transactions in each response-time bucket for the specified application group. |
average total response time | Displays the average response time (in tenths of seconds) for the total number of response-time transactions. |
average IP response time | Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions. |
number of transactions | Displays the total number of response-time transactions across all response-time buckets. |
| Command | Description |
Configures a client subnet group for response-time measurements. | |
show extended channel tn3270-server response-time application | Displays information for application client groups. |
Displays information about the global client group. | |
show extended channel tn3270-server response-time listen-point | Displays information about listen-point client groups. |
Displays information about subnet client groups. |
slot | Slot number. |
virtual channel | Virtual channel number. |
This command has no defaults.
Privileged EXEC
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
The show extended channel tn3270-server response-time listen-point command displays information about groups of clients summarized by listen point. A complete list of currently existing listen-point client groups is displayed along with their collection control parameters and aggregate response-time statistics.
Following is an example of the output for the show extended channel tn3270-server listen-point command:
Router#show extended channel 3/2 tn3270-server response-time listen-point group LP 10.20.30.40:23 aggregate YES excludeip NO dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100 buckets 10 18 21 10 10 average total response time 37 average IP response time 23 number of transactions 69 group LP 50.60.70.80:23 aggregate YES excludeip NO dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100 buckets 310 418 521 510 210 average total response time 27 average IP response time 20 number of transactions 1969
Table 9 provides descriptions of the output fields for the show extended channel tn3270-server response-time listen-point command.
| Field | Description |
|---|---|
aggregate | Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to YES by the TN3270 server for link client response-time groups. |
excludeip | Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the SNA component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to NO by the TN3270 server for link client response-time groups. |
dynamic definite response | Displays whether the server adds a Definite Response request to the First-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups. |
sample period multiplier | Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group. |
bucket boundaries | Displays the value of the response-time bucket boundaries in tenths of seconds. The bucket boundaries are defined using the response-time group command. |
buckets | Displays the number of transactions in each response-time bucket for the specified application group. |
average total response time | Displays the average response time (in tenths of seconds) for the total number of response-time transactions. |
average IP response time | Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions. |
number of transactions | Displays the total number of response-time transactions across all response-time buckets. |
| Command | Description |
Configures a client subnet group for response-time measurements. | |
show extended channel tn3270-server response-time application | Displays information for application client groups. |
Displays information about the global client group. | |
Displays information about host link client groups. | |
Displays information about subnet client groups. |
slot | Slot number. |
virtual channel | Virtual channel number. |
ip-address | Subnet IP address. |
ip-mask | Subnet mask. |
detail | Each client group entry is followed by a list of its client members and their respective response-time statistics. |
This command has no defaults.
Privileged EXEC
| Release | Modification |
|---|---|
11.2(18)BC | This command was first introduced. |
12.0(5)T | None. |
This command shows information about client subnet client groups. This includes all configured groups plus the CLIENT SUBNET OTHER group. If no optional parameters are specified, a complete list of client subnet client groups is displayed along with their collection control parameters. If you specify the ip-address and ip-mask, only client groups containing that subnet are displayed. If you specify the detail keyword, each client group entry is followed by a list of its client members and their response-time statistics.
Following is an example of the output for all configured client groups using the show extended channel tn3270-server response-time subnet command:
Router#show extended channel 3/2 tn3270-server response-time subnet group SUBNETGROUP1 subnet 10.10.10.0 255.255.255.192 aggregate NO excludeip NO dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100 group SUBNETGROUP2 subnet 10.10.10.128 255.255.255.192 subnet 10.10.10.192 255.255.255.192 aggregate NO exclude ip NO dynamic definite response NO sample period multiplier 40 bucket boundaries 20 30 60 120 group CLIENT SUBNET OTHER aggregate NO exclude ip NO dynamic definite response NO sample period multiplier 30 bucket boundaries 10 20 50 100
Following is an example of the output for subnet 10.10.10.0 with IP mask 255.255.255.192, which shows a list of the client members and their response-time statistics:
Router#show extended channel 3/2 tn3270-server response-time subnet
10.10.10.0 255.255.255.192 detail
group SUBNETGROUP1
subnet 10.10.10.0 255.255.255.192
aggregate NO excludeip NO dynamic definite response NO
sample period multiplier 30
bucket boundaries 10 20 50 100
client 10.10.10.129:23
buckets 5 8 11 9 4
average total response time 33 average IP response time 24
number of transactions 37
client 10.10.10.130:23
buckets 6 9 10 10 2
average total response time 32 average IP response time 25
number of transactions 37
client 10.10.10.131:23
buckets 11 14 10 8 7
average total response time 27 average IP response time 19
number of transactions 50
Table 10 provides descriptions of the output fields for the show extended channel tn3270-server response-time subnet command.
| Field | Description |
|---|---|
subnet | Displays the IP address and IP mask of the client subnet group for which response-time statistics are being shown. |
aggregate | Displays whether the response time statistics for the clients in this response-time group are reported collectively for the group (YES) or individually by client (NO). This value is automatically set to NO by the TN3270 server for subnet client response-time groups. |
excludeip | Displays whether the IP component (the client/server path) is included in the response time for any transaction (NO) or if only the SNA component (the server/host path) is included in the response time for any transaction (YES). This value is automatically set to NO by the TN3270 server for subnet client response-time groups. |
dynamic definite response | Displays whether the server adds a Definite Response request to the First-in-chain (FIC) reply in each transaction, to get a response from the client so that the IP component can be included in the response time. The value is automatically set to NO by the TN3270 server for all types of response-time groups. |
sample period multiplier | Displays the number that is multiplied by an interval of 20 seconds to determine the collection interval for the response-time group. The multiplier value is defined using the response-time group command. For example, a sample period multiplier of 30 results in a collection interval of 600 seconds (30 x 20 seconds), or 10 minutes, for this client group. |
bucket boundaries | Displays the value of the response-time bucket boundaries in tenths of seconds. The bucket boundaries are defined using the response-time group command. |
buckets | Displays the number of transactions in each response-time bucket for the specified application group. |
average total response time | Displays the average response time (in tenths of seconds) for the total number of response-time transactions. |
average IP response time | Displays the average response time in tenths of seconds (including IP transit time) for the total number of response-time transactions. |
number of transactions | Displays the total number of response-time transactions across all response-time buckets. |
| Command | Description |
Configures a client subnet group for response-time measurements. | |
show extended channel tn3270-server response-time application | Displays information for application client groups. |
Displays information about the global client group. | |
Displays information about host link client groups. | |
show extended channel tn3270-server response-time listen-point | Displays information about listen-point client groups. |
Posted: Mon Jul 26 10:24:20 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.