# Compaq TCP/IP Services for OpenVMS
User's Guide

Previous | Contents | Index

# SEND SYNCH

> The SEND SYNCH command clears the communications path between your local system and the remote host. The SYNCH is sent in urgent mode (out-of-band, OOB). As a result, the following actions occur:
> 1. The local host immediately sends an interrupt character, placing it at the front of the data stream sent to the remote host.
> 2. The remote host immediately processes the interrupt character, ignoring any incoming data not yet processed, and then including a TELNET synchronization or interrupt character in the data stream it sends back to the local host.
> 3. The local host throws away all incoming data (rather than processing that data) until it detects the synchronization or interrupt character. This provides faster response time to the synchronization and interrupt characters.

## DCL Format

> SEND SYNCH

## UNIX Format

> send synch

# SET ECHO

> Sets the echo character.

> Use this command if either your terminal or the remote system does not recognize the default echo character. Enter the following sequence of characters:

> 1. Opening quotation marks
> 2. A circumflex ( ^ )
> 3. The new echo character
> 4. Closing quotation marks

## DCL Format

> SET ECHO "^character"

## UNIX Format

> set echo "^character"

## Parameters

> ### "^character"

> Required.

> Character you want to use as the echo character.

## Example

    TELNET> SET ECHO "^m"
    Echo character is '^M'.

> Sets the echo control character to either m or M.

# SET ERASE

> Sets the erase character.

> The erase character deletes, either locally or remotely, the last character in the type-ahead buffer. (This character has no effect in binary mode.)

> Use this command if either your terminal or the remote system does not recognize the default erase character, the Delete key.

> Enter the following sequence of characters:

> 1. Opening quotation marks
> 2. A circumflex ( ^ )
> 3. The new erase character
> 4. Closing quotation marks

## DCL Format

> SET ERASE "^character"

## UNIX Format

> set erase "^character"

## Parameters

> ### "^character"

> Required.

> Character you want to use as the erase character.

## Example

    TELNET> SET ERASE "^P"
    Erase character is '^p'.

> Sets the erase control character to either p or P.

# SET ESCAPE

> Sets the escape character.

> The escape character returns you to the TELNET prompt. When you run multiple sessions, you can set different escape sequences for each connection.

> Use this command if either your terminal or the remote system does not recognize the default escape character, Ctrl/]. Enter the following sequence of characters:

> 1. Opening quotation marks
> 2. A circumflex ( ^ )
> 3. The new escape character
> 4. Closing quotation marks

## DCL Format

> SET ESCAPE "^character"

## UNIX Format

> set escape "^character"

## Parameters

> ### "^character"

> Required.

> Character you want to use as the escape character.

## Example

    TELNET> SET ESCAPE "^P"
    Escape character is '^p'.

> Sets the escape control character to either p or P.

# SET FLUSHOUTPUT

> Sets the flush output character.

> Use this command if either your terminal or the remote host does not recognize the default flush output character, Ctrl/O.

> Enter the following sequence of characters:

> 1. Opening quotation marks
> 2. A circumflex ( ^ )
> 3. The new flush output character
> 4. Closing quotation marks

## DCL Format

> SET FLUSHOUTPUT "^character"

## UNIX Format

> set flushoutput "^character"

## Parameters

> ### "^character"

> Required.

> Character you want to use as the flush output character.

## Example

    TELNET> SET FLUSHOUTPUT "^P"
    Flush output character is '^p'.

> Sets the flush output control character to either p or P.

# SET INTERRUPT

> Sets the interrupt character.

> The interrupt character clears the input and output paths to the remote host. The remote host interrupts the program that is processing. (This character has no effect in binary mode.)

> Use this command if either your terminal or the remote host does not recognize the default interrupt character, Ctrl/C.

> Enter the following sequence of characters:

> 1. Opening quotation marks
> 2. A circumflex ( ^ )
> 3. The new interrupt character
> 4. Closing quotation marks

## DCL Format

> SET INTERRUPT "^character"

## UNIX Format

> set interrupt "^character"

## Parameters

> ### "^character"

> Required.

> Character you want to use as the interrupt character.

## Example

    TELNET> SET INTERRUPT "^a"
    Interrupt character is '^A'.

> Sets the interrupt control character to either a or A.

# SET KILL

> Sets the kill character.

> The kill character discards, both locally and remotely, the entire type-ahead buffer. (This character has no effect in binary mode.)

> Use this command if either your terminal or the remote host does not recognize the default kill character, Ctrl/U.

> Enter the following sequence of characters:

> 1. Opening quotation marks
> 2. A circumflex ( ^ )
> 3. The new kill character
> 4. Closing quotation marks

## DCL Format

> SET KILL "^character"

## UNIX Format

> set kill "^character"

## Parameters

> ### "^character"

> Required.

> Character you want to use as the kill character.

## Example

    TELNET> SET KILL "^q"
    Kill character is '^Q'.

> Sets the kill control character to either q or Q.

# SET MODE

> Sets the mode of transmission.

> The mode of transmission can be either character mode or line mode. Character mode is the default. Use character mode when you run a character-processing text editor on the remote host. With character mode, your local system sends data a character at a time to the remote host with which you have a connected session, and the remote host echoes the characters back for display on your local system. (Sometimes several characters may be sent in a burst for performance optimization, in which case the remote server usually replies with bursts of characters, but not a line at a time.)

> To use line mode, the remote host server must support line mode. The local host echoes characters. Line mode allows the following:

> - Signal trapping (such as for application programs on remote UNIX hosts that sense traps or special events)
> - Local character editing
> - Tab expansion (where a tab is more than simply the TAB character)

> This command overrides the ENABLE LOCAL_CHARS command.

> Before you enter this command, establish a remote connection.

## DCL Format

> SET MODE {CHAR | LINE}

## UNIX Format

> mode mode

## Parameters

> ### CHAR
> LINE

> Required.

> Transmission mode you want to set. Specify either of the following:

> - CHAR --- Data is transmitted one character at a time.
> - LINE --- Data is transmitted one line at a time.

# SET QUIT

> Sets the quit character, an alternate interrupt character.

## DCL Format

> SET QUIT "^character"

## UNIX Format

> set quit "^character"

## Parameters

> ### "^character"

> Required.

> Character you want to use as the quit character.

## Example

    TELNET> SET QUIT "^i"
    Quit character is '^I'.

> Sets the alternate interrupt control character to either i or I.

# SET TERMINAL

> Sets the default terminal type for future TELNET or TN3270 connections.

## Format

> SET TERMINAL /DEVICE=type

## Qualifiers

> ### /DEVICE=type

> Required.

> Terminal model. Specify one of the following:

> - A Compaq terminal model.
> - An IBM terminal to emulate. Enter the full specification for one of the following:
>   - IBM-3278-2
>   - IBM-3278-3
>   - IBM-3278-4
>   - IBM-3278-5

## Example

    TELNET> SET TERMINAL/DEVICE=IBM-3278-2
    Terminal type is set to IBM-3278-2
    TELNET>

> Runs TN3270. The terminal is emulating an IBM 3278-2 model terminal.

# SHOW DEVICE

> Displays status information about TELNET devices.

## DCL Format

> SHOW DEVICE

> [ device_name ] [ /FULL ]

## Parameters

> ### device_name

> Optional. TNA device name. For example, TNA245:.

## Qualifiers

> ### /FULL

> Optional.

> Shows detailed information about TNA devices on the local system.

## EXAMPLES

#1
    TELNET> SHOW DEVICE TNA281:
    TNA281:  BG9526:  Temporary Local:  condor:23
                                Remote: freebid:1033

> Displays status of a particular TNA device.

#2
    TELNET> SHOW DEVICE

     (1)
          (2)
           (3)
             (4)

    TNA10:   BG495:   Temporary Local:   condor:23
                                Remote:  freebid:1059
    TNA12:   BG658:   Temporary Local:   condor:23
                                Remote   pigdog:1455
    TNA13:   BG671:   Temporary Local:   condor:23
                                Remote:  pigdog:1456
    TNA35:   BG2993:  Temporary Local:   condor:23
                                Remote:  projector:1044
    TNA37:   BG2999:  Temporary Local:   condor:23
                                Remote:  pigdog:1459
    TNA38:   BG3000:  Temporary Local:   condor:23
                                Remote:  pigdog:1470
    TNA47:   BG3393:  Temporary Local:   condor:23
                                Remote:  l-22-222-37.*.com:1069
    TNA58:   BG3866:  Temporary Local:   condor:23
                                Remote:  pcruth.mel.dec.com:1043
    TNA59:   BG3878:  Temporary Local:   condor:23
                                Remote:  lexser13.lex.dec.com:1090
    TNA60:   BG3910:  Temporary Local:   condor:23
                                Remote:  l-20-244-54.*.com:1635
    TNA61:   BG3932:  Temporary Local:   condor:23
                                Remote:  lexser3.lex.dec.com:1093
    TNA62:   BG3933:  Temporary Local:   condor:23
                                Remote:  tcpipa:1801
    TNA63:            Temporary

> Displays status of all TNA devices on the local system. Command output includes:

> 1. The TNA device (terminal device)
> 2. The associated BG device (network device)
> 3. Whether the TNA device is permanent or temporary
> 4. Local and remote host names and port numbers

#3
    TELNET> SHOW DEVICE/FULL
    Device TNA7:
        Access port name:       "Host: 16.99.999.140    Port: 1310"
        Characteristics:        (none)
        Connection attempts:        0 (tries)
        Connection interval:        0 (seconds)
        Connection timeout:         0 (seconds)
        Data high limit:          512 (bytes at VCI port)
        Data low limit:           256 (bytes at VCI port)
        Idle interval:              0 (seconds)
        Idle timeout:               0 (seconds)
        Network device name:    BG266:
        Protocol:               TELNET
        Local address:          16.99.999.100 (condor)
                  port:            23
        Remote address:         16.99.999.140 (pigdog.dec.com)
                  port:          1310
        Service type:           None
       .
       .
       .

> Displays detailed information about all TNA devices that exist on the local system. The information shown in the example is output for each TNA device.

# SHOW PARAMETERS

> Displays current TELNET or TN3270 parameter settings. If you run multiple sessions, the display applies to the active session.

## DCL Format

> SHOW PARAMETERS

## UNIX Format

> display

## Example

    TELNET> SHOW PARAMETERS
    Will flush output when sending interrupt characters
    Won't send interrupt characters in urgent mode
    Will map carriage return on output
    Won't recognize certain control characters
    Won't show option negotiation
    Won't print network data flow in hexadecimal
    [^^]     echo
    [^]]     escape
    [^?]     erase
    [^O]     flushoutput
    [^C]     interrupt
    [^U]     kill
    [^Y]     quit
    [^T]     areyouthere
    TELNET>

> Displays the parameter settings for the active session, revealing the following information:

> - Automatic flushing (AUTOFLUSH) of output is enabled.
> - Sending of interrupt characters in urgent mode (AUTOSYNCH) is disabled.
> - Mapping of received carriage returns (CRMOD) is enabled.
> - Mapping of carriage returns as Return LP on output (CRLF) is disabled.
> - Interpretation of control characters (LOCAL_CHARS) is enabled. The remote host does not recognize certain control characters; therefore, the local host interprets them.
> - Display of option negotiations (OPTIONS_VIEW) between the local and remote hosts is disabled.
> - The display or printing of data in hexadecimal (DEBUG) is disabled. Therefore, TELNET displays the data in readable text only.
> - The control characters are interpreted as listed.

# SHOW SESSION

> Displays the session information about your current TELNET sessions (or TN3270 session) and, if you are running multiple TELNET sessions, about the waiting sessions.

## DCL Format

> SHOW SESSION

## UNIX Format

> status

##

### Examples

#1
    TELNET>  SHOW SESSION
    %TELNET-E-NOSESSION, No active session
    TELNET>  CONNECT LUNA
    %TELNET-I-Trying, Trying... 192.1.2.3
    %TELNET-I-SESSION, Session 01, host luna, port 23
    -TELNET-I-Escape, Escape character: '^]'
    LUNA -- Unauthorized access is prohibited
    Username:  BURNS
    Password:                      (password not echoed)
            Welcome to OpenVMS Alpha Version 7.3 on node LUNA
    $ [Ctrl/]] (characters not echoed)
    TELNET> SHOW SESSION
    Session 01, host LUNA, port 23 (default active port)
    TELNET>

> Displays information about current sessions. The information returned for the first SHOW SESSION command reveals that the local host has no active sessions. The user then connects to host LUNA and returns to the TELNET prompt to display session information once again. This time, the SHOW SESSION command displays information about the connection with LUNA.

#2
    TELNET> CONNECT ESTRELLA 23 IBM-3278-2
       .
       .
       .
    % [Ctrl/]] (characters not echoed)
    TELNET> SHOW SESSION
    Session 01, host LUNA, port 23
    Session 02, host ESTRELLA, port 23 (default active session)
    TELNET>

> Here, the same user has established another connection, this time to host ESTRELLA. The SHOW SESSION command displays information about all sessions, revealing that the current active session is with host ESTRELLA.

# SHOW STATUS

> Displays the status of the current TELNET or TN3270 session and, if you are running multiple sessions, about the waiting sessions. Status information can include information about open sessions, such as which one is active and which ones are waiting, the escape character and options currently set, and the number of data overruns and suspended network I/Os (inputs/outputs) detected.

## DCL Format

> SHOW STATUS

## UNIX Format

> status

##

### Examples

#1
    TELNET> SHOW STATUS
    No open sessions
    Escape character: '^]'
    TELNET> CONNECT LUNA
    %TELNET-I-Trying, Trying ... 192.1.2.3
    %TELNET-I-SESSION, Session 01, host LUNA, port 23
    -TELNET-I-Escape, Escape character: '^]'
    LUNA -- Unauthorized access is prohibited
    Username: BURNS
    Password:                   (password not echoed)
            Welcome to OpenVMS Alpha Version 7.3 on node LUNA

    $ [Ctrl/]]
    TELNET> SHOW STATUS
    Session  1 Active  Host LUNA Port 23
        Operating Mode: Character-at-a-time
        Escape character: '^]'
        Options:
            Echo - Remote
            Terminal Type - Local
            Terminal Type - VT300
            Suppress Go Ahead - Local
            Suppress Go Ahead - Remote
        Terminal Dataoveruns:     0
        Suspended Network I/Os:   0

    TELNET>

    Session  1 Active  Host LUNA
        Operating Mode: Character-at-a-time
        Escape character: '^]'
        Options:
            Echo - Remote
            Terminal Type - Local
            Terminal Type - DEC-VT300
            Suppress Go Ahead - Local
            Suppress Go Ahead - Remote
        Terminal Dataoveruns:     0
        Suspended Network I/Os:   0
    TELNET>

> The user enters a SHOW STATUS command, which reveals that no active sessions have been established. After the user connects to host LUNA, the next SHOW STATUS command displays information about the active session with LUNA.

#2
    TELNET> CONNECT ESTRELLA 23 IBM-3278-2
    .
    .
    .
    % [Ctrl/]]             (characters not echoed)
    TELNET> SHOW STATUS
    Session  2 Active  Host ESTRELLA Port 23
        Operating Mode: Character-at-a-time
        Escape character: '^]'
        Options:
            Echo - Remote
            Terminal Type - Local
            Terminal Type - VT300
            Suppress Go Ahead - Local
            Suppress Go Ahead - Remote
        Terminal Dataoveruns:     0
        Suspended Network I/Os:   0

    Session  1 Waiting Host LUNA Port 23
    TELNET>

> Here, the user has established an additional session, this time with host ESTRELLA. The SHOW STATUS command displays information about the currently active session with ESTRELLA and the waiting session.

Previous | Next | Contents | Index