DISPLAY TELNET CONNECTION command

Use the CONNECTION DISPLAY command with the SUMmary parameter to view high-level information about multiple existing connections and their usage.

Use the CONNECTION DISPLAY command with the DETail parameter to view all available details about a single connection.

Use the LUName filter with the *LUNSREQ option to see the connections at a LUNR that are waiting for a reply from the LUNS.

Format:

Read syntax diagramSkip visual syntax diagram
>>- Display TCPIP----,tnproc----+---------+--,CONNection-------->
                                '-,Telnet-'                

   .-,POrt=ALL--------.  .-,PROFile=ALL-----.   
>--+------------------+--+------------------+------------------->
   +-,POrt=num--------+  +-,PROFile=prfid---+   
   +-,POrt=num1..num2-+  +-,PROFile=ACTive--+   
   '-,POrt=num,qual---'  +-,PROFile=CURRent-+   
                         +-,PROFile=Basic---+   
                         '-,PROFile=Secure--'   

>--+----------------------------------------------------+------->
   |                           .-,DETail--.             |   
   +-+-,COnn=connid---------+--+----------+-------------+   
   | +-,IPPort=ipaddr..port-+  '-,SUMmary-'             |   
   | '-,LUName=luname-------'                           |   
   |                                       .-,NOHname-. |   
   +-+-,LUName=luname*------------------+--+----------+-+   
   | +-,APPL=applname|applname*---------+  '-,HName---' |   
   | +-,TCPipjobname=tcpip--------------+               |   
   | +-,IPAddr=-+-ipaddr--------------+-+               |   
   | |          +-ipv4mask:ipv4subnet-+ |               |   
   | |          '-ipv6addr/prefixlen--' |               |   
   | +-,LUGroup=lugroupname-------------+               |   
   | +-,IPGroup=ipgroupname-------------+               |   
   | '-,PROTOcol=protocol mode----------'               |   
   |                           .-,HName---.             |   
   '-+-,HName=*hostname-----+--+----------+-------------'   
     '-,HNGroup=hngroupname-'  '-,NOHname-'                 

   .-,MAX=100--.   
>--+-----------+-----------------------------------------------><
   '-,MAX=nn|*-'   

Parameters:

tnproc
The member name of the cataloged procedure that is used to start the Telnet address space.
Telnet
Legacy parameter that directs the command to the Telnet component when Telnet could run in the TCP/IP stack.
CONNection
The connection keyword.
POrt=ALL|num|num1..num2|num,qual
Specifies that ALL ports, a specific port (num), port number range (num1..num2), qualified port (num,qual) be displayed. ALL is the default.
PROFile =ALL|prfid|ACTive|CURRent|Basic|Secure
The type of profile to display.
  • ALL is all profiles, both active and inactive. This is the default.
  • prfid is the profile ID.
  • ACTive is all the active profiles.
  • CURRent is the name of the current profile.
  • Basic is the basic profile.
  • Secure is the secure profiles.
COnn=connid
Displays detailed information about a specific TCP/IP connection ID.
IPPort=ipaddr..port
Displays detailed information about a specific IP port and address.
LUName=luname*
The name of the LU for which you are searching. The wildcard (*) is allowed only as the last character of the LUName. If no * is indicated, a detailed display will appear.
SUMmary|DETail
DETail displays all of the information about the requested connection.

SUMmary displays a subset of the information about the requested connection.

APPL=applname|applname*
The application name of the application for which you are searching. The wildcard (*) is allowed only as the last character.
TCPIPJOBNAME=tcpip
The TCPIP stack that supports the connection.
IPAddr=ipaddr|mask:subnet
The IP address of the connection for which you are searching. The mask:subnet designation is essentially allowing an IP wildcard.
LUGroup=lugroupname
The name of the LU group for which you are searching.
IPGroup=ipgroupname
The name of the IP group for which you are searching.
PROTOcol=protocol mode
The protocol mode for which you are searching. Protocol choices are:
  • BINARY
  • LINEMODE
  • TN3270
  • TN3270E
  • TRANSFORM
HName|NOHname
The summary display includes client host names when HNAME is specified. The summary display omits client host names when NOHNAME is specified.
HName=*hostname
The host name for which you are searching. Single or double asterisks are permitted as wildcards:
  • Use a single asterisk (*) to indicate that any value is acceptable for a particular qualifier in a particular position within the host name. For example, *.*.IBM.COM matches USER1.RALEIGH.IBM.COM, but does not match USER1.TCP.RALEIGH.IBM.COM because this name includes an extra qualifier.
  • Use a double asterisk (**) to indicate that any number of qualifiers are acceptable to the left of the asterisks. For example, **.IBM.COM matches USER1.IBM.COM, USER1.RALEIGH.IBM.COM, and USER1.TCP.RALEIGH.IBM.COM.
Both wildcard techniques require that the entire qualifier be wildcarded. For example, *USER.IBM.COM is not a valid use of a wildcard. In this case, use *.IBM.COM instead.
HNGroup=hngroupname
The name of the HN group for which you are searching.
MAX=100|nn|*
The number of output lines that are displayed. Valid values are in the range 2–65533. The default value is 100. An asterisk (*) indicates that all output lines are displayed. The command can display a maximum of 65533 output lines (control, label, and data lines). Therefore, if you specify an asterisk (*), a maximum of 65533 output lines is displayed.

Examples:

    D TCPIP,TELNET,CONN
(C) EZZ6064I TELNET CONN DISPLAY
(L)          ENCR                                           TSP
(L) CONN     TYPE IPADDR..PORT            LUNAME   APPLID   PTR LOGMODE
    -------- ---- ---------------------- -------- --------  --- --------
    0000001C 4S   9.27.11.197..4155      TCPM1002 APPL2     TAE SNX32702
    0000001A 4S   9.27.11.197..4154      TCPM1001 APPL2     TAE SNX32702
    ----- PORT:      23    ACTIVE           PROF: CURR CONNS:      2
    ------------------------------------------------------------
    4 OF 4 RECORDS DISPLAYED
The following example shows information that is related to AT-TLS.
    D TCPIP,TELNET,CONN,CONN=35
    EZZ6065I TELNET CONN DISPLAY
      CONNECTED: 12:01:49  10/26/2005  STATUS: SESSION ACTIVE
      CLIENT IDENTIFIER FOR CONN: 00000035   SECLABEL: **N/A**
        CLIENTAUTH USERID: USER60
        HOSTNAME: TEST3.IBM.COM
        CLNTIP..PORT: ::FFFF:9.16.17.18..2763
        DESTIP..PORT: ::FFFF:9.42.43.44..23
        LINKNAME: CTCLNK6
      PORT:    23 QUAL: NONE
        AFFINITY: TCPIP
        STATUS: ACTIVE  TTLSSECURE    ACCESS: SECURE  0005 SSLV3 SAFCHECK
        TTLSRule:       TTLSTNRULE1
        TTLSGrpAction:  TTLSTN3270GROUPACTION1
        TTLSEnvAction:  TTLSTN3270ENVIRONMENTACTION1
        TTLSConnAction: TTLSTN3270CONNECTIONACTION1
      PROTOCOL: TN3270E  LOGMODE: SNX32702 DEVICETYPE: IBM-3278-2-E
        OPTIONS: ETET----   3270E FUNCTIONS: BSR----
                          NEWENV FUNCTIONS: --
      USERIDS  RESTRICTAPPL: USER64    EXPRESSLOGON: **N/A**
      LUNAME: TCPM1011  TYPE: TERMINAL GENERIC  APPL: TSO10003
      MAPPING TYPE:  CONN IDENTIFIER
                          OBJECT   ITEM SPECIFIC     OPTIONS
        LUMAP GEN:  IG IPGRP1
                         >LUGRP1                     -E--G---
                          LUGRP2                     ----G---
        DEFLT APPL: IP ::FFFF:9.16.17.18
                          TSO                        --------
        USS TABLE:  IG IPGRP1
                          EZBTPUST                   P-------
                    LU EXIT                                   
                          EZBTPUST,>EZBTPSCS         PE------ 
        INT TABLE:  **N/A**
        MONGROUP:   IG IPGRP1
                          MONGRP1
          PERIOD:       60 MULT:        5
                S/W AVG TOT AVG  SUM R/T      SSQ R/T  ST DEV
                ======= ======= ======== ============ =======
          SNA:     2124    1316    17112     72757524    2046
          IP:         0       0        0            0       0
          TOTAL:   2124    1316    17112     72757524    2046
          COUNT:      4      13
          BUCKET1    BUCKET2    BUCKET3    BUCKET4    BUCKET5
               50        100        200        500     NO LMT
                1          1          0          1         10
        PARMS:
      PERSIS    FUNCTION        DIA   SECURITY    TIMERS    MISC
     (LMTGCAK) (OPATSKTQSSHRT) (DRF) (PCKLECXN2) (IPKPSTS) (SMLT)
      -------  ------------     ---   ---------   -------   ----
      *******  ***TSBTQ***RT    EC*   BB**D****   *P**STS   *DD* *DEFAULT
      -------  -------------    DJ-   -------*-   -------   S--- *TGLOBAL
      LM-R-P-  -----BT--WH--    ---   TSS--F---   ----ST-   ---- *TPARMS
      LM*R*P*  ***TSBTQ*-HRT    DJ*   TSS*DF***   *P**STS   SDD* TP-CURR
        PARMSGROUP: IG IPGRP1
      -------  OP-----------    TC-   --------2   I------   ---- PRMGRP1
        LUMAP-PMAP: ON LUMAP  OF LUGRP1
      -------  ------------     --F   ---------   -------   -M-- PRMGRP2
      LM*R*P*  OP*TSBTQ*-HRT    TCF   TSS*DF**2   IP**STS   SMD* <-FINAL
    56 OF 56 RECORDS DISPLAYED

Usage:

Only one connection at a time is displayed with parameters CONN=, IPPort=, and LUName= if no wildcard is on LUName.