background image

42  TN3270 Server Commands

show extended channel tn3270-server dlur

show extended channel tn3270-server dlur

Use the show extended channel tn3270-server dlur privileged EXEC command to display
information about the SNA session switch.

show extended channel slot/2 tn3270-server dlur

Syntax Description

Command Mode

Privileged EXEC

Sample Display

The following is sample output on the Cisco 7000 from the show extended channel tn3270-server
dlur 
command:

router# show extended channel 3/2 tn3270-server dlur

dlur MPX.GOANCP

current dlus MPX.NGMVMPC                dlur-dlus status ACTIVE

preferred dlus MPX.NGMVMPC              backup dlus MPX.NGMVMPB

preferred server MPX.NGMVMPA

lsap token-adapter   0 5C     vrn MPX.LAN4           status ACTIVE

   link P390                 remote 4000.7470.00e7 08  status ACTIVE

Table 7 describes significant fields in the display.

slot/2

Specifies a particular CIP in the router where slot is the slot number.
The port value for a TN3270 server will always be 2.

Table 7

Show tn3270-server dlur Field Descriptions

Field

Description

DLUR fq-luname

Fully qualified CP name used by the SNA session switch and the
LU name for the DLUR function configured as the fq-cpname on
the dlur statement.

CURRENT DLUS fq-luname

Name of the currently active DLUS, either the primary DLUS or
the backup DLUS.

DLUR-DLUS STATUS
dlur-status

Possible DLUR-DLUS status values and their meanings are:

• reset—The DLUR-DLUS pipe is reset.

• pnd-actv—The DLUR-DLUS pipe is pending active.

• active—The DLUR-DLUS pipe is active.

• pnd-inac—The DLUR-DLUS pipe is pending inactive.

PREFERRED-DLUS fq-luname

Name of the DLUS as configured on the DLUR statement.

BACKUP-DLUS fq-luname

Name of the DLUS that is used if the preferred DLUS is
unavailable.

PREFERRED SERVER
fq-luname

Fully qualified name of the preferred network node server.

LSAP

Configured value for the local SAP on the configured internal
adapter. Token-adapter specifies the type of internal adapter used.

Summary of Contents for 11.0 BT

Page 1: ...l release of Cisco IOS Release 11 0 BT No prior versions of Cisco IOS Release 11 0 BT exist The TN3270 server function is supported on a Channel Interface Processor card in a Cisco 7000 series or Cisco 7500 series router The following Cisco IOS releases are covered by this release note publication Cisco IOS 11 0 10 BT Cisco IOS 11 0 11 BT Cisco IOS 11 0 12 BT Cisco IOS 11 0 13a BT Note Cisco IOS R...

Page 2: ...page 19 Cisco Connection Online page 57 Cisco Connection Documentation page 57 Use this document in conjunction with the Router Products Release Notes for Cisco IOS Release 11 0 and the Cisco IOS Release 11 0 configuration guide and command reference publications specifically the Router Products Configuration Guide Chapters 1 to 6 Router Products Configuration Guide Chapters 22 to 33 Router Produc...

Page 3: ...S Release 11 0 BT CIP Boot Image Requirements The CIP boot image is bundled in the Cisco IOS Release 11 0 BT image You must have the image that supports your CIP or your CIP2 hardware You cannot run a CIP and a CIP2 card in the same router See Table 1 for a list of image names and supported CIP or CIP2 cards Table 1 11 0 BT Image Names for CIP and CIP2 Hardware Memory Requirements The memory requi...

Page 4: ...anced resource management Systems Network Architecture SNA Session Switching Off loads VTAM by providing session routing TN3270E Support In combination with a TN3270E client provides advanced SNA management and SNA functionality including printer support Dynamic Definition of Dependent Logical Units LU Provides simplified configuration and network definition at the router and in VTAM Dynamic Alloc...

Page 5: ...s To route these dependent LU sessions to multiple virtual telecommunications access method VTAM hosts connected to the server in the CIP card rather than routing in the VTAM hosts the TN3270 server implements a SNA session switch with end node dependent LU requester DLUR function Using the DLUR is optional so that the TN3270 server can be used with VTAM versions prior to version 4 2 which provide...

Page 6: ...ADDR or LU name is allocated by the host as long as a network solicitor logon menu is presented The server will perform the following on such a session request Form an EBCDIC string based on the model type and number requested by the client see Formation of LU Model Type and Number for the algorithm used This string is used as a field in a Reply product set ID PSID network management vector transp...

Page 7: ...del string sent to the host Following the previously described terminal type string formats accepted by the server this additional condition is applied If the client has negotiated to receive BIND IMAGE the character S is overlaid on the fifth character of the string or appended if the string is less than five characters See Table 3 Specific LU Allocation A TN3270E client can request a specific LU...

Page 8: ...ed and owned by a controlling VTAM When a client requests an application residing on a different VTAM host the controlling VTAM will issue the request to the target host which will send a BIND directly to the client All LU LU data will then flow directly between the target host and the client without needing to go through the controlling VTAM VTAM Host Configuration Considerations for Dynamic LU A...

Page 9: ...U pool to be used for DDDLU unless they have been reserved by the configuration using the generic pool deny TN3270 configuration command Example VTAM host values defining LUSEED and LUGROUP name parameters TN3270PU PU IDBLK 05D IDNUM 30001 define other PU parameters LUSEED TN3X1 define the seed component of the LU names created by DDDLU e g LOCADDR 42 will have the name TN3X1042 LUGROUP AGROUP def...

Page 10: ...used but with only the first set of parameters The following example tasks clarify how to return to a command mode without necessarily creating a new entity To create a DLUR LSAP and enter DLUR LSAP configuration mode perform the following task beginning in TN3270 DLUR configuration mode To return later to the DLUR LSAP configuration mode on the same entity perform the following task beginning in ...

Page 11: ...3270 server configuration mode the dlur command puts you in DLUR configuration mode Prompt tn3270 dlur TN3270 configuration mode TN3270 DLUR configuration mode TN3270 PU TN3270 DLUR PU configuration mode TN3270 DLUR SAP configuration mode Prompt tn3270 server Prompt tn3270 dlur Prompt tn3270 dlur lsap Prompts tn3270 pu tn3270 dlur Use TN3270 PU configuration mode when the TN3270 server is attached...

Page 12: ...c rsap rsap lu seed lu name stem From DLUR configuration mode the pu command to create a new PU is pu pu name idblk idnum ip address From either mode to return to PU configuration mode on PU pu name the command is pu pu name Prompts tn3270 pu tn3270 dlur pu Commands Allowed in Multiple Modes The following commands are valid in TN3270 configuration mode or in either variation of PU configuration mo...

Page 13: ...er DLUR Monitor the TN3270 Server Note You can also use DLUR to reach a mix of APPN and non APPN hosts The host owning the PUs must be an APPN network node that also supports the subarea that is an interchange node When an SLU starts a session with any of the APPN hosts it can use session switching to reach that host directly When it starts a session with a non APPN host the traffic will be routed...

Page 14: ... server on the internal LAN interface and enter TN3270 configuration mode tn3270 server Optional Configure maximum number of LUs allowed maximum lus max number of lu allocated Optional Configure transmission of a WILL TIMING MARK timing mark Optional Assign a TCP port other than the default of 23 This command is also available in PU configuration mode tcp port port nbr Optional Specify the idle ti...

Page 15: ...Specify the idle time for server disconnect This command is also available in TN3270 configuration mode idle time num of seconds Optional Specify the maximum time allowed between keepalive marks before the server disconnects This command is also available in TN3270 configuration mode keepalive num of seconds Optional Specify whether the TN3270 session will disconnect when an UNBIND command is rece...

Page 16: ...d Create a PU function under DLUR and enter PU configuration mode pu pu name idblk idnum ip address Assign a TCP port other than the default of 23 tcp port port nbr Specify the idle time for server disconnect idle time num of seconds Specify the maximum time allowed between keepalive marks before the server disconnects keepalive num of seconds Specify whether the TN3270 session will disconnect whe...

Page 17: ... attached non APPN and will open SAP 4 on adapter 0 enter interface configuration mode for the virtual interface in slot 2 router config int channel 2 2 create TN3270 Server entity router config if tn3270 server set server wide defaults for PU parameters router cfg tn3270 keepalive 0 router cfg tn3270 unbind action disconnect router cfg tn3270 generic pool permit define DLUR parameters and enter D...

Page 18: ... ip redirects no ip directed broadcast ip pim query interval 0 ip igmp query interval 0 no ip route cache no keepalive no clns checksum clns congestion threshold 0 clns erpdu interval 0 clns rdpdu interval 0 no clns route cache no clns send erpdu no clns send rdpdu lan TokenRing 0 source bridge 223 1 2099 adapter 0 4100 cafe 0001 llc2 N1 2057 adapter 1 4100 cafe 0002 llc2 N1 2057 tn3270 server pu ...

Page 19: ...te chapter of this Release Note The following commands are documented in this update chapter dlur page 20 dlus backup page 21 generic pool page 22 idle time page 24 keepalive page 25 link page 26 lsap page 28 maximum lus page 30 preferred nnserver page 31 pu DLUR page 35 pu direct page 32 show extended channel tn3270 server page 36 show extended channel tn3270 server client ip address page 39 show...

Page 20: ... characters pound at and dollar are allowed in the fully qualified name strings Each string is from one to eight characters long for example RA12 NODM1PP The portion of the name before the period is the NETID and is shared between entities in the same logical network The no dlur command hierarchically deletes all resources defined beneath it Example The following command performs two functions It ...

Page 21: ...orn down Several parameters in the DLUR configuration mode consist of fully qualified names as defined by the APPN architecture Fully qualified names consist of two case insensitive alphanumeric strings separated by a period However for compatibility with existing APPN products including VTAM the characters pound at and dollar are allowed in the fully qualified name strings Each string is from one...

Page 22: ...nt vector transport NMVT messages thus allowing dynamic definition of dependent LU DDDLU operation for that LU All LUs in the generic pool are by definition DDDLU capable Values entered for generic pool in TN3270 configuration mode apply to all PUs for that TN3270 server but can be changed in PU configuration mode In PU configuration mode a no generic pool command will restore the generic pool val...

Page 23: ...t is specified any inactive LUs are immediately available for dynamic connections Moreover any active LUs that were dynamic previously before generic pool deny was issued return to being dynamic Example The following command permits generic LU pool use generic pool permit ...

Page 24: ...n TN3270 mode applies to all PUs for that TN3270 server except as overridden by values entered in PU configuration mode A no idle time command entered in PU configuration mode will restore the idle time value entered in TN3270 command mode The idle time command affects currently active and future TN3270 sessions For example if the idle time value is reduced from 900 seconds to 600 seconds sessions...

Page 25: ...alue entered in TN3270 command mode 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 If the IP path to the client is broken the TCP layer will detect the failure to acknowledge the DO TIMING MARK and initiate disconnect...

Page 26: ...l LAN Using different adapters avoids any contention for SAP numbers and is also necessary if you configure duplicate MAC addresses for fallback CSNA access to the host By configuring the adapters in the same internal LAN you achieve the same performance bypassing the DLC stacks as looping back on a single adapter Examples The following command defines a link name and a remote SAP address link LIN...

Page 27: ...ent 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 dlur lsap token adapter 1 link HOST rmac 4000 0000 0001 rsap 4 ...

Page 28: ...adapter adapter number values configured on the CIP internal LAN interface are used in the lsap command However the lan type keyword is a little different Where the type on the lan command is tokenring the corresponding type on lsap is token adapter This emphasizes that the number that follows is an adapter number not a lan number The no lsap command hierarchically deletes any links using it Any s...

Page 29: ...TN3270 Server Commands 29 lsap Example The following command defines an adapter type an adapter number and a local SAP lsap token 0 B0 Related Commands adapter lan ...

Page 30: ...d on the console To prevent constant warning displays the threshold for generating such messages is raised for a period The TN3270 server attempts to allocate one LU control block for each LU activated by the hosts In the case of dynamic definition of dependent LU DDDLU the control block is allocated when the client requests the LU in anticipation of an ACTLU from the SSCP host By limiting the num...

Page 31: ...ngs Each string is from one to eight characters long for example RA12 NODM1PP The portion of the name before the period is the NETID and is shared between entities in the same logical network When no preferred server is specified the DLUR will request NN server support from the first suitable node with which it makes contact If refused it will try the next one and so on If a preferred server is sp...

Page 32: ...e 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 cl...

Page 33: ... achieve the same performance bypassing the DLC stacks as looping back on a single adapter Examples The following commands configure the TN3270 server to be active and has one PU CAPPU1 trying to connect in An LU seed using hexadecimal digits is defined tn3270 server pu CAPPU1 05D18101 10 14 20 34 token adapter 3 rmac 4000 0501 0001 lu seed CAP01L The following example shows different adapter numb...

Page 34: ...34 TN3270 Server Commands pu direct Related Commands adapter lan ...

Page 35: ...ss per host application For example clients wanting to connect to TSO specify an IP address that will be defined with PUs that have LOGAPPL TSO Example The following sequence of commands define three PUs Two of the PUs share the same IP address and the third PU has a separate IP address pu p0 05D99001 192 195 80 40 pu p1 05D99002 192 195 80 40 pu p2 05D99003 192 195 80 41 pu name Name that uniquel...

Page 36: ...ex 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 12...

Page 37: ... qualified DLUR CP name STATUS Possible DLUR DLUS status values and their meanings are reset The DLUR DLUS pipe is reset pnd actv The DLUR DLUS pipe is pending active active The DLUR DLUS pipe is active pnd inac The DLUR DLUS pipe is pending inactive DLUS fq dlusname Currently active DLUS NAME pu name This is the name of the PU as configured IP TCP ip addr tcpport IP address and TCP port number co...

Page 38: ...internal adapter number or dlur if it is a SNA Session Switch PU DESTINATION mac address or PU name If a direct PU then it is the destination MAC address otherwise it is the name of the partner PU R LSAP number number Remote and local SAP values Table 5 Show tn3270 server Field Descriptions Continued Field Description ...

Page 39: ... 0 in 0 out NegRsp 0 in 0 out pacing window 0 in 1 out credits 0 in queue size 0 in 0 out traces dynamic timer expired warm actpu req warm actpu req warm actpu req warm actpu req warm actpu req warm actpu req warm actpu req IN len 9 2C0001010009838100 OUT len 15 2Cxxxxxxxx0A038120F3000501FF IN len 9 2C000101000A838100 IN len 170 xxxxxxxxxx0403922088000D818080 OUT len 1730 2Cxxxxxxxx0B0381207EC3110...

Page 40: ...CP port number STATE lu state The LU state and their meanings are unknown LU in an undefined state inactive LU didn t receive ACTLU active LU received ACTLU and acknowledged positively p sdt LU is bound but there is no SDT yet act sess LU is bound and in session p actlu Telnet connects in and is waiting for ACTLU p ntf av Awaiting host notify available response p ntf ua Awaiting host notify unavai...

Page 41: ...WINDOW IN OUT number number SNA pacing window as configured in the bind CREDITS IN number Number of frames that can be sent inbound without requiring an isolated pacing response QUEUE SIZE IN number If non zero indicates the number of SNA frames waiting to be sent to the host which are blocked waiting for a pacing response QUEUE SIZE OUT number SNA frames not yet acknowledged by an isolated pacing...

Page 42: ...ter where slot is the slot number The port value for a TN3270 server will always be 2 Table 7 Show tn3270 server dlur Field Descriptions Field Description DLUR fq luname Fully qualified CP name used by the SNA session switch and the LU name for the DLUR function configured as the fq cpname on the dlur statement CURRENT DLUS fq luname Name of the currently active DLUS either the primary DLUS or the...

Page 43: ... actv SAP activation in progress active SAP open pnd inac SAP deactivation in progress LINK name Name of the configured link If not a configured link then the name is an invented name DLURnn REMOTE mac sap Remote MAC and SAP for this link LINK STATUS status Possible link status values and their meanings are inactive Not connected to host pnd actv Link activation in progress active Link active pnd ...

Page 44: ... in the router where slot is the slot number The port value for a TN3270 server will always be 2 name Name of the SNA session switch link to be displayed Table 8 Show tn3270 server dlurlink Field Descriptions Field Description LSAP VRN STATUS status Possible sap status values and their meanings are inactive Not connected to adapter pnd actv SAP activation in progress active SAP open pnd inac SAP d...

Page 45: ...c pool perm bytes 100 in out frames 90 in 4 out NegRsp 6 in 0 out actlus 4 dactlus 0 binds 0 lu name client ip tcp state model frames in out idle for 1 EXT2001 171 69 176 34 1897 ACTIVE 327805 1 1 4 32 49 2 EXT2002 never connected ACTIVE 1 1 4 32 49 The following is sample output on the Cisco 7000 from the show extended channel tn3270 server pu command for a SNA session switch PU router show exten...

Page 46: ...ree p dactpu PU is pending DACTPU dlur DLUR PU is in undefined state LINK type LINK type is either internal adapter type and internal adapter number or dlur if it is a SNA session switch PU DESTINATION mac address or PU name If a direct PU then it is the destination MAC address otherwise it is the name of the partner PU R LSAP number number Remote and local SAP values IDLE TIME number Configured i...

Page 47: ...ng host notify available response p ntf ua Awaiting host notify unavailable response p reset Waiting for a buffer to send DACTLU response p psid Waiting for NMVT Reply psid response p bind Waiting for host to send bind p unbind Awaiting host unbind response wt unbnd Waiting for client to acknowledge disconnection wt sdt Waiting for client to acknowledge SDT MODEL model 3278 model type of client FR...

Page 48: ...ended channel tn3270 server pu lu command for a SNA session switch PU router show extended channel 3 2 tn3270 pu int1 lu 1 lu name client ip tcp state model frames in out idle for 1 GOAN1X01 171 69 176 77 3828 ACTIVE 4 4 0 4 51 pu is INT1 lu is STATIC type 0 negotiated TN3270E bytes 74 in 1219 out RuSize 0 in 0 out NegRsp 0 in 0 out pacing window 0 in 0 out credits 0 in queue size 0 in 0 out The f...

Page 49: ...LU active LU received ACTLU and acknowledged positively p sdt LU is bound but there is no SDT yet act sess LU is bound and in session p actlu Telnet connects and is awaiting ACTLU p ntf av Awaiting host notify available response p ntf ua Awaiting host notify unavailable response p reset Waiting for a buffer to send DACTLU response p psid Waiting for NMVT Reply psid response p bind Waiting for host...

Page 50: ...ow as configured in the bind CREDITS IN number Number of frames that can be sent inbound without requiring an isolated pacing response QUEUE SIZE IN number If non zero indicates the number of SNA frames waiting to be sent to the host that are blocked while waiting for a pacing response QUEUE SIZE OUT number SNA frames not yet acknowledged by an isolated pacing response by the TN3270 server Table 1...

Page 51: ...utdown Syntax Description This command has no arguments or keywords Default The interface or entity is enabled Command Modes CIP interface configuration TN3270 configuration PU configuration DLUR configuration DLUR SAP configuration Usage Guidelines In CIP interface configuration mode the command applies to the entire CIP In TN3270 configuration mode the command applies to the whole TN3270 Server ...

Page 52: ...Usage Guidelines The tcp port command can be entered in either TN3270 configuration mode 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 PU configuration mode The tcp port command affects only future TN3270 sessions The no tcp port command entered in PU configuration mode removes the override Example The fo...

Page 53: ...nfigured the TN3270 server will send DO TIMING MARK as necessary to achieve an end to end response protocol Specifically DO TIMING MARK will be sent if any of the following are true The host application has requested a pacing response The host application has requested a Definite Response and either the client is not using TN3270E or the request is not Begin Chain The use of the timing mark comman...

Page 54: ...lt No TN3270 server function is enabled Command Mode Interface configuration Usage Guidelines Only one TN3270 server can run on a CIP It will always be configured on port 2 which is the internal LAN interface port The no tn3270 server command shuts down TN3270 server immediately All active sessions will be disconnected and all DLUR and PU definitions deleted from the router configuration To restar...

Page 55: ... can be entered in either TN3270 configuration mode 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 PU configuration mode The unbind action command affects currently active and future TN3270 sessions The no unbind action command entered in PU configuration mode removes the override The unbind action command...

Page 56: ... topology as a kind of node termed a VRN To make use of this function all APPN nodes must use the same VRN name for the SATF Refer to the VTAM operating system documentation for your host system for additional information regarding the VTAM VNGROUP and VNNAME parameters on the PORT statement of an XCA major node Several parameters in the DLUR configuration mode consist of fully qualified names as ...

Page 57: ...s with photographs figures graphics and video as well as hyperlinks to related information You can access CCO in the following ways WWW http www cisco com WWW http www europe cisco com WWW http www china cisco com Telnet cco cisco com Modem From North America 408 526 8070 from Europe 33 1 64 46 40 82 Use the following terminal settings VT100 emulation databits 8 parity none stop bits 1 and connect...

Page 58: ...Fast Step FragmentFree IGX JumpStart Kernel Proxy LAN2LAN Enterprise LAN2LAN Remote Office MICA Natural Network Viewer NetBeyond Netsys Technologies Packet PIX Point and Click Internetworking Policy Builder RouteStream Secure Script SMARTnet StrataSphere StrataSphere BILLder StrataSphere Connection Manager StrataSphere Modeler StrataSphere Optimizer Stratm StreamView SwitchProbe The Cell TrafficDi...

Reviews: