HELPLIB.HLB  —  TELNET
    Starts a TELNET session and does one of the following:

    o  Displays the TELNET prompt.

    o  Establishes a connection to a remote host.

    o  Establishes a connection to a remote host and runs TN3270.

    For help with individual TELNET commands, enter the following
    command:

    $ TELNET
    TELNET> HELP

    DCL Format

      TELNET  [ host ] qualifier(s) [ port ] [unit ]

              [ /AUTHENTICATE]

              [ /BIND_SESSION network_device

              [ /CREATE_SESSION [ /[NO]TIMEOUT=option [/PERMANENT]

              /PROTOCOL=protocol]]

              [ /FORWARD

    UNIX Format

      telnet  [ host ]

1  –  Parameters

 host

    Required with the /CREATE_SESSION qualifier; optional in all
    other cases. Default: None.

    Remote host to which you want to connect. Specify one of the
    following:

    o  Host name

    o  IP address

 port

    Required with the /CREATE_SESSION qualifier; ignored in all other
    cases. Default: None.

    Specifies the remote port to which you want to connect the pseudo
    device.

 unit

    Required with the /DELETE_SESSION qualifier; optional with the
    /CREATE_SESSION qualifier; ignored in all other cases. Default:
    0.

    With the /CREATE_SESSION qualifier, specifies the unit number
    you want associated with the network terminal. The default of
    0 allows the TELNET software to select the next available unit
    number.

    With the /DELETE_SESSION qualifier, specifies the unit number of
    the network terminal you want to delete.

2  –  Qualifiers

2.1    /AUTHENTICATE

    Optional. Default: None.

    Specifies that you want the TELNET session to use Kerberos
    features.

                                   NOTE

       The /AUTHENTICATE qualifier also can be used with the TELNET
       commands OPEN and CONNECT.

2.2    /BIND_SESSION

       /BIND_SESSION network_device

    Optional. Default: None.

    Binds a TELNET terminal device to an existing network device. If
    the bind is successful, the DCL symbol $TELNET_DEVICE contains
    the TNA device name.

2.3    /CREATE_SESSION

    Optional. Default: None.

    Specifies that TELNET should create a pseudo device (network
    terminal) and connect it to the specified remote port. For
    additional information, see the CREATE_SESSION command. You can
    use the following qualifiers with CREATE_SESSION:

    o  /NOTIMEOUT

    o  /TIMEOUT=option
       Options include:

          NOIDLE
          IDLE=delta_time_interval

          Specifies the delta time interval to wait with no activity
          before closing the connection. The general delta time
          format is hh:mm:ss:cc.

          NORECONNECT
          RECONNECT=delta_time_interval

          Specifies the delta time interval to wait before retrying
          a connect request. The general delta time format is
          hh:mm:ss:cc.

    o  /PERMANENT Optional.

    o  /PROTOCOL=option
       Optional. Default: NONE.

       Options include:

       -  NONE

          Data is sent with no interpretation (raw).

       -  NVT

          Network Virtual Terminal (NVT), TELNET's internal
          representation of a standard network terminal. NVT format
          is standard 7-bit ASCII code transmitted in 8-bit octets,
          the canonical form of data representation used by both the
          client and the server.

       -  TELNET

          Standard TELNET protocol.

       -  RLOGIN

          Standard RLOGIN protocol.

2.4    /DELETE_SESSION

    Optional. Default: None.

    Specifies that TELNET should delete the specified pseudo device
    (network terminal). For additional information, see the DELETE_
    SESSION command.

2.5    /FORWARD

       /FORWARD
       /NOFORWARD

    Optional. Default: /NOFORWARD.

    Forwards a copy of your Kerberos tickets to the remote host.
    The /NOFORWARD qualifier overrides any forwarding specified in
    your machine's configuration files. You must request forwardable
    tickets at the same time that you issue the KINIT command.

    You must use the /AUTHENTICATE qualifier when you specify the
    /FORWARD qualifier.

2.6    /LOG_FILE

       /LOG_FILE=file

    Optional. Default: No logging.

    An optional log file that contains all session output. Using this
    option does not affect your terminal output. You cannot use this
    option for TN3270 sessions.

2.7    /NOINTERACTIVE

    Optional. Default: TELNET command mode.

    Disables the capability of using the escape character to leave
    a session and return to the TELNET prompt. This option is useful
    when the TELNET command is referenced in a command procedure in a
    captive account.

2.8    /PORT

       /PORT=n

    Optional. Default: 23.

    Remote port to which you want your TELNET process to connect. Use
    this qualifier only if you are connecting to a host that does not
    use the standard TELNET port.

2.9    /REALM

       /REALM=realm-name

    Optional.

    Requests Kerberos tickets for the remote host in the specified
    realm, instead of determining the realm itself.

    You must use the /AUTHENTICATE qualifier when you specify the
    /REALM qualifier.

2.10    /TERMINAL_TYPE

       /TERMINAL_TYPE=type

    Optional. Default: None.

    The type of terminal to emulate. Enter the full specification for
    one of these terminals:

    o  IBM-3278-2

    o  IBM-3278-3

    o  IBM-3278-4

    o  IBM-3278-5

    o  VT100

    o  VT200

    o  VT300

    o  VT400

    o  VT500

2.11    /UNBIND_SESSION

       /UNBIND_SESSION network_device terminal_device

    Optional.

    Unbinds a network device (BGx:) from a TELNET terminal device
    (TNAx:) that was initially bound by a BIND_SESSION command or
    qualifier.

3  –  Examples

    1.$ TELNET
      TELNET> ENABLE DEBUG
      TELNET> SET TERMINAL /DEVICE=VT300
      Terminal type is set to VT300
      TELNET> CONNECT DEBTS

      In this example, the TELNET command performs the following
      actions:

      o  Starts TELNET.

      o  Customizes the environment.

      o  Establishes a connection to host DEBTS and sets up the
         terminal type as VT300.

    2.$ TELNET MYCOM /TERMINAL_TYPE=IBM-3278-2

      Establishes a TELNET connection to remote host MYCOM and runs
      TN3270.

    3.$ TELNET 130.180.5.5

      Establishes a TELNET connection to the host at IP address
      130.180.5.5.

    4.$ TELNET UCOM 31

      Establishes a TELNET connection to remote host ucom at port 31.

    5.$ TELNET/AUTHENTICATE/REALM=jet.mbs.com terse

      %TELNET-I-TRYING, Trying ... 15.21.308.11
      %TELNET-I-SESSION, Session 01, host terse, port 23
      %TELNET-I-ESCAPE, Escape character is ^]
              terse.ucx.ttg.mbs.com

      This example logs in to system terse with Kerberos credentials.

    6.$ TELNET/AUTHENTICATE/FORWARD terse

      %TELNET-I-TRYING, Trying ... 15.21.308.11
      %TELNET-I-SESSION, Session 01, host terse, port 23
      %TELNET-I-ESCAPE, Escape character is ^]
      [Kerberos V5 accepts you as ''j_brown@terse.mbs.com'' ]
      [Kerberos V5 accepted forwarded credentials ]

      This example forwards credentials to host terse for user j_
      brown.
Close Help