DataMuseum.dk

top - download

    Length: 4673 (0x1241)
    Types: TextFile
    Notes: R1k Text-file segment

└─⟦8527c1e9b⟧ Bits:30000544 8mm tape, Rational 1000, Arrival backup of disks in PAM's R1000
    └─ ⟦5a81ac88f⟧ »Space Info Vol 1« 
        └─⟦ecadbb85b⟧ 
            └─⟦this⟧ 

TextFile

  @node !Commands.Telnet

  Package Telnet is the user interface for managing Telnet
  connections.  This package sets up connections between a local
  terminal and a remote computer and disconnects them when the
  user is finished.  The package also transmits data over Telnet
  connections.
  @node !Commands.Telnet.Connect

  procedure Connect
  (Remote_Machine  : Machine_Name          := Telnet_Profile.Remote_Machine;
   Session         : Session_Number        := 1;
   Escape          : String               := Telnet_Profile.Escape;
   Escape_On_Break : Boolean              := Telnet_Profile.Escape_On_Break;
   Terminal        : System_Utilities.Port := System_Utilities.Terminal);

  Establishes a new connection or resumes an existing connection with
  the specified computer (Remote_Machine) and session (Session).

  Upon receipt of the specified escape sequence from the terminal,
  the connection is escaped and the terminal is reconnected to the
  local Environment.
  @node !Commands.Telnet.Disconnect

  procedure Disconnect
           (Remote_Machine : Machine_Name   := Telnet_Profile.Remote_Machine;
            Session        : Session_Number := 1;
            User           : User_Name      := Telnet.My_User_Name);

  Disconnects a connection with the specified computer
  (Remote_Machine) and session (Session).
  @node !Commands.Telnet.Machine_Name

  subtype Machine_Name is String;

  Specifies the name of a remote machine.
  @node !Commands.Telnet.My_User_Name

  function My_User_Name return User_Name;

  Returns your own username and session name.
  @node !Commands.Telnet.Send

  procedure Send
          (Data           : String         := Telnet_Profile.Escape;
           Remote_Machine : Machine_Name   := Telnet_Profile.Remote_Machine;
           Session        : Session_Number := 1);

  Sends data via an existing Telnet connection.
  @node !Commands.Telnet.Send_Break

  procedure Send_Break
          (Remote_Machine : Machine_Name   := Telnet_Profile.Remote_Machine;
           Session        : Session_Number := 1);

  Sends a break signal via an existing Telnet connection.
  @node !Commands.Telnet.Session_Number

  subtype Session_Number is Positive;

  Specifies the session number of a Telnet connection.

  The default session number is 1.  Specifying different session
  numbers makes it possible to have multiple connections to a remote
  machine.
  @node !Commands.Telnet.Show_Sessions

  procedure Show_Sessions (User : User_Name := Telnet.My_User_Name);

  Displays all existing connections for the specified user.

  Fields shown include local username, local session name, remote
  machine name, and Telnet session number.
  @node !Commands.Telnet.User_Name

  subtype User_Name is String;

  Specifies the username for a Telnet connection.

  The format for the username is:

        user's local login name.local Environment session name
  @node !Tools.Networking.Telnet_Profile

  Package Telnet_Profile supplies default values for Telnet
  commands.  Each of these functions has a corresponding session
  switch that can be set by the user.

  Many parameter values are virtually constant for a given user.  For
  common applications, it is much easier to have the values of these
  parameters automatically set to the commonly used values rather
  than to specify parameter values each time the command is used.
  The Rational Environment supplies session switches to do this.
  Session switches set parameter values at login.  Telnet uses these
  session values for the duration of the login session.

  Switches are stored in files.  The user can edit the switch values
  in these files by means of the switch file object editor.  The
  !Commands.Switches.Edit_Session_Attributes command edits session
  switch files.  Refer to the documentation on Session Switches
  in the Session and Job Management (SJM) book of the Rational
  Environment Reference Manual for further information on switches.

  There is a switch to provide a value for most Telnet parameters.
  If the user does not give a Telnet command a parameter value in the
  Telnet Command window, Telnet takes the parameter value from the
  user's session switch file.
  @node !Tools.Networking.Telnet_Profile.Escape

  function Escape return String;

  Returns the current value of the Escape session switch.
  @node !Tools.Networking.Telnet_Profile.Escape_On_Break

  function Escape_On_Break return Boolean;

  Returns the current value of the Escape_On_Break session switch.
  @node !Tools.Networking.Telnet_Profile.Remote_Machine

  function Remote_Machine return String;

  Returns the current value of the Remote_Machine session switch