VMS Help  —  SET  HOST
    Connects your terminal (through the current host processor)
    to another processor, called the remote processor. The command
    requires that:

    o  You must have an account on the remote system to log in.

    o  The NETMBX (network mailbox) privilege is set.

    For more information about using the following qualifiers, see
    help for the appropriate subtopic.

    Qualifier   Type of Connection

    /DTE        Connects your system to a remote system through an
                outgoing terminal line.

    /DUP        Connects your terminal to a storage controller
                through the appropriate bus for that controller.

    /HSC        Connects your terminal to an HSC disk and tape
                controller through the computer interconnect (CI)
                bus.

    /LAT        Connects your terminal to a specified service
                available on the local area network (LAN).

    /RLOGIN     Allows you to log in to a remote host over a TCP/IP
                connection and start an interactive terminal session
                by accessing the RLOGIN application.

    /TELNET     Connects you to a remote host over a TCP/IP
                connection by invoking the TELNET application.

    /TN3270     Connects you to a remote IBM host over a TCP/IP
                connection, causing the local keyboard to emulate
                an IBM 3279-class terminal keyboard by invoking the
                TN3270 terminal emulator.

    Format

      SET HOST  node-name

1  –  Parameter

 node-name

    Specifies the node name of the remote processor to which you will
    connect.

2  –  Qualifiers

2.1    /APPLICATION_PROTOCOL

       /APPLICATION_PROTOCOL[=protocol]

    Specifies the protocol connection, CTERM (CTDRIVER) or RTERM
    (RTTDRIVER) on the specified node. CTERM protocol is the default
    if no connection is specified.

2.2    /BUFFER_SIZE

       /BUFFER_SIZE=n

    Changes the packet size of the protocol message sent between the
    terminal and the remote processor if a connection to the remote
    processor is already established. The default buffer size is 1010
    bytes; however, the buffer size n can range from 140 bytes to
    1024 bytes. The value of the parameter n is reset to 140 bytes if
    a value below 140 is specified; a value for n above 1024 bytes is
    reset to 1024.

    You can force the host node to write to the terminal in smaller
    packets, thereby ensuring that write operations to the terminal
    are displayed at more frequent intervals, by setting n to a
    value just above the minimum of 140 bytes. On slow DECnet links,
    setting the buffer size to a smaller value may decrease pauses
    between write operations when large amounts of data are being
    scrolled to the screen.

2.3    /LOG

       /LOG[=filespec]
       /NOLOG (default)

    Controls whether a log file of the entire session is kept. If you
    use the /LOG qualifier without the file specification, the log
    information is stored in the file SETHOST.LOG.

2.4    /MOP

       /MOP client-name

    Connects your system to a remote system using the MOP protocol.
    Note that this qualifier is displayed only if DECnet-Plus is
    installed on your system.

    For more information, type the following command:

    $ HELP DECnet-Plus DCL_Commands SET HOST/MOP

2.5    /RESTORE

       /RESTORE
       /NORESTORE (default)

    Saves current terminal characteristics before a remote terminal
    session is begun and restores them when the remote session is
    terminated.

3  –  Examples

    1.$ SET HOST/APPLICATION_PROTOCOL=CTERM DAKOTA

      The /APPLICATION_PROTOCOL qualifier specifies the CTERM
      protocol (the default) on node DAKOTA in this command line.

    2.$ SET HOST ITALIC
      Username:  GRESO
      Password: <PASSWORD>
          Welcome to OpenVMS VAX Version 7.3 on node ITALIC
         .
         .
         .
      $  LOGOUT
      GRESO logged out at 19-DEC-2001 15:04:25.27
      %REM-S-END, Control returned to node _CASLON::

      In this example, the name of the local node is CASLON. This SET
      HOST command connects the user terminal to the processor at the
      network node named ITALIC. The remote processor then prompts
      for user name and password. Use the normal login procedure to
      log in to the remote processor.

      Once you are logged in at a remote node, you can use the SET
      HOST command to establish communication with another node.
      After logging in to node ITALIC, you could type SET HOST
      BODONI.

      You would again be prompted for a user name and password. If
      you then supply a valid user name and password, you will be
      logged in to node BODONI.

      Note that when you log out of node BODONI, control is returned
      to node ITALIC. You must log out of node ITALIC to return to
      your local node, CASLON.

    3.$  SET TERMINAL/WIDTH=80
      $  SET HOST/RESTORE GENEVA
      Username: Jones
      Password: <PASSWORD>
      $  SET TERMINAL/WIDTH=132
         .
         .
         .
      $  logout
      JONES   logged out at 19-DEC-2001 11:04:51.45
      %REM-S-END, control returned to node _ORACLE

      This example shows user JONES on node ORACLE logging in to
      remote node GENEVA and specifies that the original terminal
      screen width be restored to 80 characters when the remote
      session is terminated.

4    /DTE

    Connects your system to a remote system through an outgoing
    terminal line.

    You must have an account on the remote system in order to log in
    to that system after the connection is made.

    You must also have the ability to assign a channel to the
    terminal port specified. Your system manager can set the device
    protection on the terminal port to allow you access.

    Format

      SET HOST/DTE  terminal-name

4.1  –  Parameter

 terminal-name

    Specifies the name of an outgoing terminal line, which connects
    your system directly to another system or modem.

4.2  –  Qualifiers

4.2.1    /BREAK

       /BREAK=break-character

    Selects the break character. The break character is used to
    generate a break on lines that expect a break rather than a
    carriage return. To generate a break, press Ctrl/break-character.

    The break character can be any ASCII character between @ and
    z, except C, M, Q, S, Y, or the left bracket ([).  You cannot
    select a character currently defined as either the command
    character (see the description of the /COMMAND=command-character
    qualifier) or the escape character (see the description of the
    /ESCAPE=escape-character qualifier).

    The ASCII characters between @ and z include the alphabetic
    characters in both upper and lower cases, the at sign (@),  the
    backslash (\),  the right bracket (]), the circumflex (^),  the
    underscore (_),  and the grave accent (`).

    By default, the break character is the right bracket (]).

4.2.2    /COMMAND

       /COMMAND=command-character

    Selects the command character. Use the command character to
    access DTE command mode by pressing Ctrl/command-character.

    The command character can be any ASCII character between @ and z,
    except C, M, Q, S, Y, or the left bracket ([).  You cannot select
    a character currently defined as either the break character (see
    the description of the /BREAK=break-character qualifier) or the
    escape character (see the description of the /ESCAPE=escape-
    character qualifier).

    The ASCII characters between @ and z include the alphabetic
    characters in both upper and lower cases, the at sign (@),  the
    backslash (\),  the right bracket (]), the circumflex (^),  the
    underscore (_),  and the grave accent (`).

    By default, the command character is the at sign (@).

4.2.3    /DIAL

       /DIAL=(NUMBER:number[,MODEM_TYPE:modem-type])

    Allows a modem attached to the outgoing terminal line to be
    autodialed using the autodial protocol of that modem. The
    NUMBER keyword is the telephone number to be autodialed and is
    a required parameter.

    Before you dial a new number, you must log out of the current
    remote system.

    On Alpha, the MODEM_TYPE keyword defaults to DMCL (any modem that
    uses the DIGITAL Modem Command Language).

    Each modem type requires a specific modem dialer code. Check with
    your system manager to see which modem dialer codes are installed
    on your system.

    In addition, the MODEM_TYPE keyword can be used to specify
    a modem type other than DF03, DF112, or DMCL. A template is
    provided for users interested in supporting other modems with
    autodial capabilities (see SYS$EXAMPLES:DTE_DF03.MAR).

4.2.4    /ECHO

       /ECHO
       /NOECHO (default)

    Determines whether the terminal input is echoed by your local
    system. By default, all echoing is performed by the remote
    system.

4.2.5    /EIGHT_BIT

       /EIGHT_BIT (default)
       /NOEIGHT_BIT

    Determines whether the outgoing terminal line supports 8-bit or
    7-bit characters. By default, 8-bit characters are supported. If
    you specify /NOEIGHT_BIT, then 7-bit characters are supported.

4.2.6    /ERROR_ACTION

       /ERROR_ACTION=CONTINUE (default)
       /ERROR_ACTION=EXIT

    Specifies the error action by using the EXIT or the CONTINUE
    keyword.

    When an error is detected on the outgoing terminal line, the
    error is reported to the local system and an error message is
    displayed on your terminal.

    If the error action is CONTINUE, then communication with the
    remote system continues uninterrupted.

    If the error action is EXIT, then the local system immediately
    exits from the remote system.

4.2.7    /ESCAPE

       /ESCAPE=escape-character

    Selects the escape character. You can use the escape character to
    exit from DTEPAD by pressing Ctrl/ escape-character.

    The escape character can be any ASCII character between @ and z,
    except C, M, Q, S, Y, or the left bracket ([).  You cannot select
    a character currently defined as either the break character (see
    the description of the /BREAK=break-character qualifier) or the
    command character (see the description of the /COMMAND=command-
    character qualifier).

    By default, the escape character is a backslash (\).

    The ASCII characters between @ and z include the alphabetic
    characters in both upper and lower cases, the at sign (@),  the
    backslash (\),  the right bracket (]), the circumflex (^),  the
    underscore (_),  and the grave accent (`).

4.2.8    /FLOW_CONTROL

       /FLOW_CONTROL (default)
       /NOFLOW_CONTROL

    Determines whether XON/XOFF flow control is enabled. By default,
    flow control is enabled.

    XON/XOFF flow control is a means of preventing data-overrun
    errors. Incoming data is stored in receive buffers; when these
    buffers are full, a signal is sent to the remote system to stop
    transmission. Once there is sufficient space in the receive
    buffers, another message is sent to restart transmission.

    You should disable XON/XOFF flow control when the remote system
    has no XON/XOFF flow control.

4.2.9    /INIT

       /INIT[=filespec] (default)
       /NOINIT

    Sets the configurable characteristics of DTEPAD according to
    values contained in the specified initialization file.

    If you use qualifiers in the command line to define the values of
    any of the configurable characteristics, these will supersede the
    values contained in the initialization file.

    By default, DTEPAD tries to translate the logical name DTEPAD$INI
    in order to find the appropriate initialization file. If you
    use the /INIT qualifier and omit the file specification, DTEPAD
    translates the logical name DTEPAD$INI and finds the appropriate
    file. If DTEPAD$INI is not defined, then DTEPAD uses /NOINIT as
    the default.

    An initialization file can contain any combination of any of the
    following DTE commands:

    o  SAVE

    o  SEND BREAK

    o  SET DTE

    o  SPAWN

    The following is an example of an initialization file:

    SET DTE/MAX_BUFFERS=150
    SET DTE/READ_DELAY=100
    SEND BREAK

4.2.10    /LOG

       /LOG[=filespec]
       /NOLOG (default)

    Controls whether a log file of the session is kept.

    If you use the /LOG qualifier and omit the file specification,
    then the log information is written to the file DTEPAD.LOG.

    When used to log a modem session, the log file contains any noise
    that occurred on the phone line. For example, typing a file in
    order to get it recorded in the log file could result in noise
    being recorded along with the file data. Therefore, the use of a
    log file is not recommended for the purpose of file transfers.

    VSI recommends that you use asynchronous DECnet to transfer files.

4.2.11    /MAX_BUFFERS

       /MAX_BUFFERS=number-buffers

    Specifies the maximum number of receive buffers. Receive buffers
    are buffers used to receive incoming data from the modem port.
    They are allocated as they are required.

    By default, the maximum number of receive buffers is 100. The
    minimum number you can specify is 20.

4.2.12    /PARITY

       /PARITY=NONE (default)
       /PARITY=ODD
       /PARITY=EVEN

    Selects parity on the outgoing terminal line.

4.2.13    /READ_DELAY

       /READ_DELAY=delay

    Specifies the modem port read delay in milliseconds. The modem
    port read delay is the time interval during which data in the
    modem port is transferred into receive buffers at the terminal.

    By default, the modem port read delay is 50 milliseconds. This is
    also the minimum value.

    A long modem port read delay slows the rate at which data is
    displayed at your terminal, and also increases the risk of data-
    overrun errors; however, a longer read delay requires less CPU
    overhead.

4.2.14    /SPEED

       /SPEED=(output-rate,input-rate)

    Sets the baud rate at which the terminal receives and transmits
    data. If the input and output rates are the same, specify the
    qualifier as /SPEED=rate.

    Not all terminals support different input and output baud rates.
    For specific information on baud rates for your terminal, consult
    the manual for that terminal.

    The default transmission rates are installation dependent.

    The valid baud rates are as follows:

     50       150       1800       4800       38400
     75       300       2000       7200       57600
    110       600       2400       9600       76800
    134      1200       3600      19200      115200

    If you select an invalid or unsupported speed, then the terminal
    line speed will remain set at its previous value.

4.3  –  Examples

    1.$ SET HOST/DTE TTA2:/DIAL=NUMBER:5551234
      Username: SMITH
      Password:

      This command connects the user terminal to the outgoing
      terminal line TTA2:, which is attached to a modem (type DF03
      by default) set to autodial the phone number 555-1234. The
      remote processor then prompts for user name and password. Use
      the normal login procedure to log in to the remote system.

    2.$ SET HOST/DTE/DIAL=(NUMBER:5551234#,MODEM_TYPE:DF112) TTA2:
      Username: SMITH
      Password:

      This command accomplishes the same thing as in the first
      example, except that it uses the DF112 modem. The number sign
      (#)  is required to activate the autodialer in the DF112.

    3.$ SET HOST/DTE/NOEIGHTBIT TTA2

      This command sets the outgoing terminal port, TTA2, to support
      7-bit characters.

    4.$ SET HOST/DTE/NOFLOW_CONTROL TTA2

      This command disables the XON/XOFF flow control.

    5.$ SET HOST/DTE/ERROR_ACTION=EXIT TTA2

      This command sets the error action to EXIT.

    6.$ SET HOST/DTE/MAX_BUFFERS=150 TTA2

      This command sets the maximum number of receive buffers to 150.

    7.$ SET HOST/DTE/ESCAPE=E TTA2

      This command defines the letter E as the escape character. Note
      that DTEPAD is not case sensitive.

    8.$ SET HOST/DTE/LOG TTA2

      This command enables logging of the session. Since no log
      file is specified, the log is written to the default log file,
      DTEPAD.LOG.

    9.$ SET HOST/DTE/INIT=MYFILE.INI TTA2

      This command uses the initialization file MYFILE.INI.

    10$ <Ctrl/@>
      DTEPAD>

      This example shows you how to access DTE command mode by
      pressing Ctrl/@, where @ is the command character.

    11DTEPAD> SAVE MYFILE.INI

      This command saves the information on the current configuration
      in the file MYFILE.INI.

    12DTEPAD> SET DTE/BREAK=G

      This command defines the letter G as the break character.

    13DTEPAD> SET DTE/ECHO

      This command sets the terminal port so that echoing is
      performed by the local system.

    14DTEPAD> SET DTE/SPEED=4800

      This command sets the input and output baud rates to 4800.

    15DTEPAD> SET DTE/LOG=myfile.log

      This command directs logging to the file MYFILE.LOG.

    16DTEPAD> SHOW DTE
        Port TXA0              EIGHT_BIT ECHO
        Flow control           XON/XOFF
        Parity                 NONE
        Transmit Speed         4800
        Receive Speed          4800
        Error action           CONTINUE
        Break character        B
        Escape character       \
        Command character      @
        Maximum buffers        100
        Read delay             50 milliseconds
        Log file               MYFILE.INI
        Number dialed          12345678
        Modem type             DF03

        Bytes transmitted      75
        Bytes received         132
        Errors                 0

      This command displays all the current settings of the
      configurable characteristics, the number of bytes transmitted
      and received, and the number of errors detected.

5    /DUP

    Connects your terminal to a storage controller through the
    appropriate bus for that controller. The /SERVER and /TASK
    qualifiers are required.

    For use only with storage controllers. Requires the DIAGNOSE
    privilege.

    Format

      SET HOST/DUP/SERVER=server-name

      /TASK=task-name node-name

5.1  –  Parameter

 node-name

    Specifies the node name of the storage controller.

5.2  –  Qualifiers

5.2.1    /LOG

       /LOG[=filespec]
       /NOLOG (default)

    Controls whether a log file of the entire session is kept. If you
    use the /LOG qualifier without the file specification, the log
    information is stored in the file HSCPAD.LOG.

5.2.2    /SERVER

       /SERVER=server-name

    Specifies the server name for the target storage controller.

    This qualifier is required.

5.2.3    /TASK

       /TASK=task-name

    Specifies the utility or diagnostic name to be executed on the
    target storage controller under direction of the server.

    This qualifier is required.

5.3  –  Example

  $ SET HOST/DUP/SERVER=MSCP$DUP/TASK=DIRECT R2DH5Y
  %HSCPAD-I-LOCPROGEXE, Local program executing -
 type ^\ to exit utility

      The SET HOST/DUP command in this example connects the user
      terminal to the utility program called DIRECT executing on a
      storage controller named R2DH5Y under direction of the MSCP$DUP
      server.

6    /HSC

    Connects your terminal to an HSC disk and tape controller through
    the computer interconnect (CI) bus.

    Used only with HSC controllers. Requires the DIAGNOSE privilege.

    Format

      SET HOST/HSC  node-name

6.1  –  Parameter

 node-name

    Specifies the node name of the HSC.

6.2  –  Qualifier

6.2.1    /LOG

       /LOG[=filespec]
       /NOLOG (default)

    Controls whether a log file of the entire session is kept. If you
    use the /LOG qualifier without the file specification, the log
    information is stored in the file HSCPAD.LOG.

6.3  –  Example

  $ SET HOST/HSC HSC001
  %HSCPAD-I-LOCPROGEXE, Local program executing -
    type ^\ to exit, ^Y for prompt
  HSC>

      This SET HOST/HSC command connects the user terminal to the HSC
      named HSC001.

7    /LAT

    Connects your terminal to a specified service available on
    the local area network (LAN), establishing one session for
    communication between your terminal and that service.

    The service node that provides the service must be on the same
    extended LAN and must be running at least Version 5.0 of the LAT
    protocol.

    Format

      SET HOST/LAT  service-name

7.1  –  Parameter

 service-name

    Specifies the name of the service to which you want your terminal
    connected. A service is a resource on the LAN. A service often
    consists of all of the resources of a computer system. Other
    examples of services are a file storage system and an application
    program running on a computer system. A computer system that
    offers one or more services is called a service node.

    If several service nodes offer the same service, and you do not
    specify the /NODE=node-name qualifier, your terminal connects to
    the service node that is the least busy.

    To display a list of services on your LAN, use the LAT Control
    Program (LATCP) SHOW SERVICES command. See the VSI OpenVMS System
    Management Utilities Reference Manual.

7.2  –  Qualifiers

7.2.1    /AUTOCONNECT

       /AUTOCONNECT
       /NOAUTOCONNECT

    Specifies whether connection attempts should be retried
    automatically when a connection fails because a service is
    unknown or unavailable, or because a node is unknown or
    unreachable. Also specifies that reconnects should be attempted
    automatically if a service has disconnected abnormally. The
    default is /NOAUTOCONNECT.

7.2.2    /AUTOPROMPT

       /AUTOPROMPT (default)
       /NOAUTOPROMPT

    Causes an OpenVMS Username: prompt to appear with no user action
    when a SET HOST/LAT command is issued.

    On a terminal server port, you can configure the port to have
    AUTOPROMPT disabled (/NOAUTOPROMPT) so that you are required
    to press Return when connecting to a node to get the Username:
    prompt; however, when connecting to a reverse LAT service, the
    AUTOPROMPT characteristic should be disabled.

7.2.3    /BREAK

       /BREAK=break-character

    Defines a character that generates a break on lines that expect a
    break rather than a carriage return. To generate a break, press
    the Ctrl and break-character keys together. The default break-
    character value is the tilde (~).

    You can select any ASCII character between @ and Z, except C, M,
    Q, S, Y, and the left bracket ([).  You cannot select a character
    that is already defined as the disconnect character.

7.2.4    /DESTINATION_PORT

       /DESTINATION_PORT=port-name

    Specifies the port on a node to which you want to connect. The
    /NODE qualifier is required when you specify the /DESTINATION_
    PORT qualifier. The port must be available and must offer the
    service you specify. OpenVMS and certain other LAT service node
    systems ignore the /DESTINATION_PORT qualifier.

7.2.5    /DIAL

       /DIAL=(NUMBER:number[,MODEM_TYPE:modem-type])

    Allows a modem attached to the outgoing terminal line to be
    autodialed using the autodial protocol of that modem. The
    NUMBER keyword is the telephone number to be autodialed and is
    a required parameter.

    The MODEM_TYPE keyword is optional. It can be used to specify any
    of the following modem types:

    o  DMCL (any modem that uses the DIGITAL Modem Command Language)

    o  DF03 (default)

    o  DF112

    Each modem type requires a specific modem dialer code. Check with
    your system manager to see which modem dialer codes are installed
    on your system.

    In addition, the MODEM_TYPE keyword can be used to specify
    a modem type other than DF03, DF112, or DMCL. A template is
    provided for users interested in supporting other modems with
    autodial capabilities (see SYS$EXAMPLES:DTE_DF03.MAR).

7.2.6    /DISCONNECT

       /DISCONNECT=disconnect-character

    Defines the character that you can use to disconnect from a
    remote session. To generate a disconnect, press the Ctrl and
    disconnect-character keys together. The default disconnect-
    character is the backslash (\).

    You can select any ASCII character from @ through Z, except C, M,
    Q, S, Y, and the left bracket ([). For example, if you specify
    /DISCONNECT=A, Ctrl/A will be the disconnect character. You
    cannot select a character that is already defined as the break
    character.

7.2.7    /EIGHT_BIT

       /EIGHT_BIT (default)
       /NOEIGHT_BIT

    Determines whether the outgoing terminal line supports 8-bit or
    7-bit characters. By default, 8-bit characters are supported. If
    you specify /NOEIGHT_BIT, then 7-bit characters are supported.

                                   NOTE

       To change the number of bits per character on the remote
       terminal server port, that port must have the REMOTE
       MODIFICATION characteristic enabled.

7.2.8    /FRAME

       /FRAME=n

    The /FRAME=n qualifier allows a user making a LAT connection
    to a remote system to specify the number of data bits that
    the terminal driver expects for every character that is input
    or output. The value of n can be from 5 to 8. The default
    value depends on the settings for the terminal established by
    the /PARITY and /EIGHT_BIT qualifiers. The following example
    specifies a character frame size of 7 bits per character:

    $ SET HOST/LAT /FRAME=7 DIAL_OUT_SVC

7.2.9    /LOG

       /LOG[=log-file]

    Logs all data that is delivered during the LAT session. If you do
    not specify a log file, the data is stored in the file SETHOST_
    LAT.LOG.

7.2.10    /NODE

       /NODE=node-name

    Specifies the node that offers the service to which you want to
    connect. Failover is not performed if the connection fails.

7.2.11    /PASSWORD

       /PASSWORD=password

    Specifies the password required by a service that is password
    protected. If you do not specify the /PASSWORD qualifier when
    requesting a connection to a password-protected service, you are
    prompted for a password.

7.2.12    /QUEUE

       /QUEUE
       /NOQUEUE (default)

    When connecting to a reverse LAT service that is already in use
    (such as a dial out modem), you are notified that the service
    is in use and the SET HOST/LAT command terminates. However, LAT
    can allow incoming connections to be queued to any reverse LAT
    service that supports service queueing, which enables users to be
    placed on a queue when using reverse LAT services.

    LAT reports your position in the queue. When the resource becomes
    available, you are immediately notified. You can cancel the
    queued connection by pressing Ctrl/Y and terminating the SET
    HOST /LAT command.

7.2.13    /SPEED

       /SPEED=(output-rate,input-rate)

    Sets the baud rate at which the terminal receives and transmits
    data. If the input and output rates are the same, specify the
    qualifier as /SPEED=rate.

    Not all terminals support different input and output baud rates.
    For specific information on baud rates for your terminal, consult
    the manual for that terminal.

    The default transmission rates are installation dependent.

    The valid values for input and output baud rates are as follows:

    300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600

    If you select an invalid or unsupported speed, the terminal line
    speed will remain set at its previous value.

                                   NOTE

       To change the speed on the terminal server port, the REMOTE
       MODIFICATION characteristic must be enabled on that terminal
       server port.

       When initiating a connection, SET HOST/LAT may attempt
       to set terminal server port characteristics, such as the
       speed and the default speed for a LAT device. If the device
       connected to the terminal server port has a fixed speed
       (such as a dial-out modem) and you do not want the host
       to try to change this, disable the REMOTE MODIFICATION
       characteristic on that port using the following command:

       Local> DEFINE PORT x REMOTE MODIFICATION DISABLE
       Local> LOGOUT PORT x

       Use the following command for terminal servers that support
       the CHANGE command:

       Local> CHANGE PORT x REMOTE MODIFICATION DISABLE

7.3  –  Examples

    1.$ SET HOST/LAT SORTER
      %LAT-S-CONNECTED, session to SORTER established
      %LAT-I-TODISCON, type ^\ to disconnect the session
      Username: BARKER
      Password:
         .
         .
         .

      $ LOGOUT
      BARKER logged out at 30-DEC-2001  11:04:51.45
      %LAT-I-DISCONNECTED, session disconnected from SORTER
      -LAT-I-END, control returned to node HOME
      $

      This SET HOST/LAT command connects the user to the service
      SORTER, which is a computer system. The first message confirms
      that the user has been connected to that service. The second
      message informs the user how to disconnect the session. (The
      user can also disconnect the session by logging out from
      SORTER.) SORTER then prompts for the username and password.
      Use the normal login procedure to log in to the system. When
      the user logs out of the service SORTER, the terminal displays
      the DCL command prompt of the user's local processor system
      (HOME).

    2.$ SET HOST/LAT/DESTINATION_PORT=BOSTON-
      _$ /NODE=STATE/DISCONNECT=F BUDGET

      This command connects the user's terminal to the service BUDGET
      that is offered on port BOSTON, on service node STATE. The user
      can disconnect the session by pressing Ctrl/F.

    3.$ SET HOST/LAT PURSE
      Password:

      This command attempts to connect the user's terminal to the
      service PURSE. The service PURSE is password protected, so the
      user is prompted for a password. The user could have specified
      the password within the SET HOST/LAT command, as shown in the
      next example.

    4.$ SET HOST/LAT/PASSWORD=BEOR PURSE

      This command connects the user's terminal to the password-
      protected service PURSE. The password is BEOR.

8    /RLOGIN

    Allows you to log in to a remote host over a TCP/IP connection
    and start an interactive terminal session by accessing the RLOGIN
    application.

    Format

                       { IPhostname }
      SET HOST/RLOGIN  { IPaddress  }
                       {            }

                                   NOTE

       You can specify the IPhostname or the IPaddress, but not
       both.

8.1  –  Parameter

 IPhostname

    Specifies the IP host name of the remote host.

 IPaddress

    Specifies an IP address of the remote host.

8.2  –  Qualifiers

8.2.1    /AUTHENTICATE

    Specifies that Kerberos authentication should be used for
    acquiring access to the remote node.

8.2.2    /TERMINAL_TYPE

       /TERMINAL_TYPE=type

    Sets the terminal emulator to one of the following terminal
    types: VT100, VT200, VT300, VT400, VT500.

8.2.3    /TRUNCATE_USERNAME

    Specifies that the current user name should be truncated to 8
    characters before attempting to connect to the remote node. The
    qualifier is required for communication with systems that limit
    the size of their login names to 8 characters. The /TRUNCATE_
    USERNAME qualifier is ignored if /USERNAME is specified.

8.2.4    /USERNAME

       /USERNAME=username

    Specifies the user name for logging in to the remote node. The
    user name can be enclosed in quotes to preserve the case of the
    user name for case sensitive systems such as UNIX systems. If the
    /USERNAME qualifier is not specified, the default is the current
    user's user name.

8.3  –  Example

  $ SET HOST/RLOGIN remotehst1

      This example creates an RLOGIN connection to remote host
      remotehst1 over a TCP/IP connection.

9    /TELNET

    Connects you to a remote host over a TCP/IP connection by
    invoking the TELNET application.

    Format

                       { IPhostname }
      SET HOST/TELNET  { IPaddress  }
                       {            }

                                   NOTE

       You can specify the IPhostname or the IPaddress, but not
       both.

9.1  –  Parameters

 IPhostname

    Specifies the IP host name of the remote host.

 IPaddress

    Specifies an IP address of the remote host.

9.2  –  Qualifiers

9.2.1    /AUTHENTICATE

    Specifies that Kerberos authentication should be used for
    acquiring access to the remote node.

9.2.2    /PORT

       /PORT=port

    Specifies the remote TCP port to use. The default is 23.

9.2.3    /TERMINAL_TYPE

       /TERMINAL_TYPE=type

    Sets the terminal emulator to one of the following terminal
    types: VT100, VT200, VT300, VT400, VT500.

9.3  –  Example

  $ SET HOST/TELNET remotehst2

      This example creates a TELNET connection to remote host
      remotehst2 over a TCP/IP connection.

10    /TN3270

    Connects you to a remote IBM host over a TCP/IP connection,
    causing the local keyboard to emulate an IBM 3279-class terminal
    keyboard by invoking the TN3270 terminal emulator.

    Format

                       { IPhostname }
      SET HOST/TN3270  { IPaddress  }
                       {            }

                                   NOTE

       You can specify the IPhostname or the IPaddress, but not
       both.

10.1  –  Parameters

 IPhostname

    Specifies the IP host name of the remote host.

 IPaddress

    Specifies an IP address of the remote host.

10.2  –  Qualifiers

10.2.1    /AUTHENTICATE

    Specifies that Kerberos authentication should be used for
    acquiring access to the remote node.

10.2.2    /PORT

       /PORT=port

    Specifies the remote TCP port to use. The default is 23.

10.2.3    /TERMINAL_TYPE

    Sets the terminal emulator to one of the following terminal
    types: VT100, VT200, VT300, VT400, VT500.

10.3  –  Example

  $ SET HOST/TN3270 remotehst3

      This example creates a connection to a TELNET server on the
      remote IBM system remotehst3 over a TCP/IP connection.
Close Help