1  CREATE_SESSION
   Establishes an outbound TELNET pseudodevice (network terminal)
   and connects it to a remote listener (port).

   DCL-Style Format

     CREATE_SESSION  host port [ unit ]

                     [ /[ NO ]TIMEOUT=option ]

                     [ /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
   pseudodevice (TNAx). The default "0" specifies that the DIGITAL
   TCP/IP Services for OpenVMS software should pick the next
   available unit number. If the requested unit number is already in
   use, the DIGITAL TCP/IP Services for OpenVMS software picks the
   next available unit number. 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 which has the following connection
      attributes:

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

      o  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 set any data for the idle period.

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

      o  RECONNECTION-When data is written to the device and it 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, then if the
         first connection attempt fails, subsequent connection
         attempts will be made in one-minute intervals.

   o  /NOTIMEOUT

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

/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 USASCII 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  Example

 TELNET> CREATE_SESSION DEBTS 23 2

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

 TELNET> CREATE_SESSION /TIMEOUT=(NOIDLE, RECONNECTION=NN)

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

 TELNET> CREATE_SESSION /NOTIMEOUT

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

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

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