Establishes an outbound TELNET pseudo device (network terminal)
    and connects it to a remote listener (port). This is also known
    as a reverse TELNET connection.

    DCL Format

      CREATE_SESSION  host port [ unit ]

                      [ /[ NO ]TIMEOUT=option ]

                      [ /PERMANENT ]

                      [ /PROTOCOL=option ]

1  –  Parameters

 host

    Required.

    Remote host to which you want to connect.

 port

    Required.

    TELNET port on the remote host.

 unit

    Optional. Default: 0

    The decimal number specifying the unit number for the pseudo
    device (TNAx). The default 0 specifies that TCP/IP Services
    should pick the next available unit number. If the requested
    unit number is already in use, the next available unit number is
    used. In all cases, the software notifies you of the unit number
    chosen.

2  –  Qualifiers

2.1    /TIMEOUT

       /TIMEOUT
       /NOTIMEOUT

    Optional. Default: /NOTIMEOUT

    o  /TIMEOUT

       Creates a TNA device that has the following connection
       attributes:

       -  NOIDLE-The connection is broken when the device is finally
          deassigned. The device will automatically reconnect when
          data is written to it.

       -  IDLE-Specifies the idle time for the device. If the device
          is idle for at least the specified amount of time (note
          that the time has a granularity of one second), then the
          connection will be broken. Idle means that the device has
          neither received nor sent any data for the idle period.

       -  NORECONNECTION-The device does not automatically retry
          reconnections if they fail.

       -  RECONNECTION-When data is written to the device and
          the device is not connected, this value determines the
          interval between reconnection attempts. For example, if
          an application writes to a TNA with a RECONNECTION-0:1:00,
          and if the first connection attempt fails, then subsequent
          connection attempts will be made in 1-minute intervals.

    o  /NOTIMEOUT

       Creates a TNA device that breaks the connection when the
       device is finally deassigned (the last channel assignment
       is deassigned).

2.2    /PERMANENT

    Optional.

    Creates a TNA device that disconnects on deassignment and
    reconnects on assignment.

2.3    /PROTOCOL

       /PROTOCOL=options

    Optional. Default: NONE. Options include:

    o  NONE

       Data is sent with no interpretation (raw).

    o  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 server.

    o  TELNET

       Standard TELNET protocol.

    o  RLOGIN

       Standard RLOGIN protocol.

3  –  Examples

    1.TELNET> CREATE_SESSION DEBTS 23 2

      Establishes a network terminal known as TNA2, and connects this
      device to port 23 on remote host DEBTS.

    2.TELNET> CREATE_SESSION /TIMEOUT=(NOIDLE, RECONNECTION=nn)

      Creates a device that disconnects on deassignment and
      reconnects when data is written to it.

    3.TELNET> CREATE_SESSION /NOTIMEOUT

      Creates a device that is not reusable; the device disconnects
      on deassignment and is deleted.

    4.TELNET> CREATE_SESSION /TIMEOUT=(IDLE=0:0:30, RECONNECTION=0:2:00)

      Creates a device that times out after being idle for 30 seconds
      and that retries connection attempts at 2-minute intervals.