1  CREATE_SESSION
   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 ]
 

2  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
 

/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).
 

/PERMANENT

   Optional.

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

/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.
 

2  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.