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

Previous | Contents

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

Enter:

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

## DCL-Style Format

> ### SET ERASE "^character"

## UNIX-Style 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:

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

## DCL-Style Format

> ### SET ESCAPE "^character"

## UNIX-Style 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:

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

## DCL-Style Format

> ### SET FLUSHOUTPUT "^character"

## UNIX-Style 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:

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

## DCL-Style Format

> ### SET INTERRUPT "^character"

## UNIX-Style 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:

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

## DCL-Style Format

> ### SET KILL "^character"

## UNIX-Style 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 issue this command, establish a remote connection.

## DCL-Style Format

> ### SET MODE {CHAR | LINE}

## UNIX-Style 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-Style Format

> ### SET QUIT "^character"

## UNIX-Style 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 DIGITAL terminal model
> - An IBM terminal to emulate. Type the full specification for one of these:
>   - 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 PARAMETERS

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

## DCL-Style Format

> ### SHOW PARAMETERS

## UNIX-Style Format

> ### display

## Example

    TELNET> DISPLAY
    Will flush output when sending interrupt characters
    Won't send interrupt characters in urgent mode
    Will map carriage return on input
    Won't 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 that:

> - 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-Style Format

> ### SHOW SESSION

## UNIX-Style 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:                      (not echoed)
            Welcome to OpenVMS Alpha Version 7.1 on node LUNA
    $ [Ctrl/]] (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/]] (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 may include information about open sessions such as: which one is active and which one(s) are waiting, the escape character and options currently set, and the number of data overruns and suspended network I/Os (inputs/outputs) detected.

## DCL-Style Format

> ### SHOW STATUS

## UNIX-Style 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:                        not echoed
            Welcome to OpenVMS Alpha Version 7.1 on node LUNA
    $ [Ctrl/]] (not echoed)
    TELNET> SHOW STATUS
    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 to discover 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/]] (not echoed)
    TELNET> SHOW STATUS
    Session  2 Active  Host ESTRELLA
            Operating Mode: Line-by-line
            Escape character: '^]'
            Options:
            Echo -- Local
            End of Record -- Local
            End of Record -- Remote
            Terminal Type -- Local
            Terminal Type -- IBM-3278-2
            Suppress Go Ahead -- Local
            Suppress Go Ahead -- Remote
            Terminal Dataoveruns:     0
            Suspended Network I/Os:   0
    Session  1 Waiting Host LUNA
    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.

# SPAWN

> Suspends your current TELNET or TN3270 session and returns you to the local DCL prompt.

> To resume your session, log out at the DCL prompt.

## DCL-Style Format

> ### SPAWN

## UNIX-Style Format

> ### z

## Example

    % date
    Fri Sep 5 14:16:39 EDT 1997
    % [Ctrl/]] (not echoed)
    TELNET> SPAWN
    $ SHOW TIME
            5-Sep-1997 14:16:41
       .
       .
       .
    $ LOGOUT
      Process GROUP_1 logged out at 5-Sep-1997 14:27:18.63
    TELNET> RESUME

> In this example, the user returns to the TELNET prompt from the active session with a remote UNIX host. The user then enters the SPAWN command and, at the DCL prompt, displays the time and several other commands (not shown) before logging out and returning to the TELNET prompt to resume the active session.

# TELNET

> Starts a TELNET session and does one of the following:
> - Displays the TELNET prompt.
> - Establishes a connection to a remote host.
> - Establishes a connection to a remote host and runs TN3270.

## DCL-Style Format

> ### TELNET [ host ] [/CREATE_SESSION | /DELETE_SESSION | /LOG_FILE=file | /NOINTERACTIVE | /PORT=n | /TERMINAL_TYPE=type] [ port ] [unit ]

## UNIX-Style Format

> ### telnet [ host ]

## PARAMETERS

> ### host

> Required with the /CREATE_SESSION qualifier; optional in all other cases. Default: none.

> Remote host to which you want to connect. Specify one of the following:

> - Host name
> - IP address

> ### port

> Required with the /CREATE_SESSION qualifier; ignored in all other cases. Default: none.

> Specifies the remote port to which you want to connect the pseudodevice.

> ### unit

> Required with the /DELETE_SESSION qualifier; optional with the /CREATE_SESSION qualifier; ignored in all other cases. Default: 0.

> With the /CREATE_SESSION qualifier, specifies the unit number you want associated with the network terminal. The default of 0 allows the TELNET software to select the next available unit number.

> With the /DELETE_SESSION qualifier, specifies the unit number of the network terminal you want to delete.

## QUALIFIERS

> ### /CREATE_SESSION

> Optional. Default: None

> Specifies that TELNET should create a pseudodevice (network terminal) and connect it to the specified remote port. For additional information, see the CREATE_SESSION command.

> ### /DELETE_SESSION

> Optional. Default: None

> Specifies that TELNET should delete the specified pseudodevice (network terminal). For additional information, see the DELETE_SESSION command.

> ### /LOG_FILE=file

> Optional. Default: no logging.

> An optional log file to contain all session output. Using this option does not affect your terminal output. You cannot use this option for TN3270 sessions.

> ### /NOINTERACTIVE

> Optional. Default: TELNET command mode.

> Disables the capability of using the escape character to leave a session and return to the TELNET prompt. This option is useful when the TELNET command is referenced in a command procedure in a captive account.

> ### /PORT=n

> Optional. Default: 23.

> Remote port to which you want your TELNET process to connect. Specify only if you are connecting to a host that does not use the standard TELNET port.

> ### /TERMINAL_TYPE=type

> Optional. Default: none.

> The IBM or DIGITAL terminal to emulate. Type the full specification for one of these:

> - IBM-3278-2
> - IBM-3278-3
> - IBM-3278-4
> - IBM-3278-5
> - VT100
> - VT200
> - VT300
> - VT400
> - VT500

##

### Examples

#1

    $ TELNET
    TELNET> ENABLE DEBUG
    TELNET> SET TERMINAL /DEVICE=VT300
    Terminal type is set to VT300
    TELNET> CONNECT DEBTS

> - Starts TELNET.
> - Customizes the environment.
> - Establishes a connection to host debts and sets up the terminal type as VT300.

#2

    $ TELNET MYCOM /TERMINAL_TYPE=IBM-3278-2

> Establishes a TELNET connection to remote host MYCOM and runs TN3270.

#3

    $ TELNET 130.180.5.5

> Establishes a TELNET connection to the host at IP address 130.180.5.5.

#4

    $ TELNET UCOM 31

> Establishes a TELNET connection to remote host ucom at port 31.

# TN3270

> Starts a TELNET session that runs TN3270 and does one of the following:
> - Displays the TELNET prompt.
> - Establishes a connection to a remote host.

## Format

> ### TN3270 [ host ] [/CHARACTER_SET=file | /KEY_DEFINITIONS=file | /NATIONAL_CHARACTERS=char_set | /NOINTERACTIVE | /PORT=n | /PRINTER=file | /STATUS=state | /TERMINAL_TYPE=IBM-3278-n]

## PARAMETERS

> ### host

> Optional.

> Remote host to which you want to connect. Specify one:

> - Host name
> - IP address

## QUALIFIERS

> ### /CHARACTER_SET=file

> Optional. Default: ORIGINAL.

> File with the EBCDIC-to-DMCS (DIGITAL Multinational Character Set) and the DMCS-to-EBCDIC translation tables.

> If you omit this qualifier, TN3270:

> - Uses the translation table named by the default file SYS$LIBRARY:UCXTEDEF.TBL, if your system manager has created it.
> - Defaults to its own translation table, if UCXTEDEF.TBL does not exist. The default table maps the US EBCDIC set to the equivalent DMCS characters.
>   If none of these translation tables meets your needs, the system manager can generate a new translation table. (See the DIGITAL TCP/IP Services for OpenVMS Management manual for information about the EBCDIC / DMCS translation tables.)

>   > Note

>   > To reset the default, do not abbreviate ORIGINAL.

> ### /KEY_DEFINITIONS=file

> Optional. Default: default keyboard layout.

> Keyboard definition file you created to redefine how the TN3270 key functions correspond to your keyboard layout. This file holds the definitions for alternative keyboard mapping.

> ### /NATIONAL_CHARACTERS=character_set

> Optional. Defaults: For 8-bit terminals: MULTINATIONAL
> For 7-bit terminals: US_ASCII.

> National Replacement Character Set (NRCS) for which your DIGITAL terminal is configured. Specify one of the following:

> Canadian | MULTINATIONAL
> Dutch | Norwegian
> Finnish | Spanish
> French | Swedish
> German | Swiss
> Italian | UK_ASCII
> Japanese | US_ASCII

> ### /NOINTERACTIVE

> Optional. Default: TELNET command mode.

> Disables the capability of using the escape character to leave a session and return to the TN3270 prompt. This option is useful when the TN3270 command is referenced in a command procedure in a captive account.

> ### /PORT=n

> Optional. Default: 23.

> Remote port to which you want your TELNET/3TN3270 process to connect. Specify only if you are connecting to a host that does not use the standard TELNET port.

> ### /PRINTER=file

> Optional. Default: TN3270PRINT.LIS.

> File that records your screen's contents when you use the PRINT function.

> Directs printer output to either a file or a spooled printer (not a physical printer or terminal).

> ### /STATUS=state

> Optional. Default: AUTOMATIC.

> Determines how the status line operates during your session. Specify one of the following:

> AUTOMATIC | Status line is displayed. The status line is disabled automatically if the remote host writes data to the area under the status line or you type in that space. The status line is restored automatically when the data is erased.
> ON | Status line is always displayed.
> OFF | Status line is not displayed.

> To toggle between ON and OFF, invoke the STATUS function.

> ### /TERMINAL_TYPE=IBM-3278-n

> Optional. Default: IBM-3278-2.

> IBM terminal to emulate. Type the full specification for one of the following:

> - IBM-3278-2
> - IBM-3278-3
> - IBM-3278-4
> - IBM-3278-5

##

### Examples

#1

    $ TN3270 MYCOM

> Establishes a TELNET connection to remote host MYCOM. By default, the physical terminal functions as an IBM-3278-2 model terminal.

#2

    $ TN3270 130.180.5.5 /TERMINAL_TYPE=IBM-3278-3 -
    _$ /KEY_DEFINITIONS=MY_NUMPAD.FIL

> Establishes a TELNET connection to the host at IP address 130.180.5.5. The terminal functions as if it were an IBM-3278-3 model terminal, and it uses the customized keyboard definition file MY_NUMPAD.FIL.

#3

    $ TN3270 UCOM 31 /TERMINAL_TYPE=IBM-3278-5 /PRINTER=LOG

> Establishes a TELNET connection to remote host ucom:

> - The connection is at port 31 on ucom.
> - The terminal is functioning as if it were an IBM-3278-5 model terminal.
> - During the session at ucom, using the PRINT function records the screen's contents in a file named LOG.LIS.

# Chapter 6
Sending and Receiving E-Mail Using SMTP

For exchanging electronic mail (E-mail) with users working on internet hosts, the DIGITAL TCP/IP Services for OpenVMS (UCX) product includes Simple Mail Transfer Protocol (SMTP) and Post Office Protocol (POP) software.

What You Can Do

The following table lists the SMTP electronic mail services you can perform and the sections that explain how to use them.

Capability | Section
--- | ---
Send mail to users on other internet hosts | 6.2
Send mail to multiple users, with and without distribution lists | 6.3
Receive mail from users on other internet hosts | 6.4
Set a "personal" name | 6.5
Create a carbon copy of your messages | 6.6
Forward messages | 6.7
Use the UNIX-to-UNIX copy program (UUCP) to send mail | 6.9
Use your PC mail software to receive and send messages | 6.8
Get status information about SMTP mail | 6.10.1
Remove holding state mail messages from SMTP queues | 6.10.2
Requeue holding state mail messages for delivery | 6.10.3

What You Need

To use the DIGITAL TCP/IP Services for OpenVMS mail services, you need the following:

- Knowledge of the OpenVMS Mail utility
- User names and IP addresses of the people to whom you want to send mail

# 6.1 Obtaining Online Help

You can obtain online help for DIGITAL TCP/IP Services for OpenVMS electronic mail by typing the following command:

    $ HELP TCP_IP_SERVICES MAIL

# 6.2 Sending Mail

To send E-mail to another internet host also running SMTP, simply invoke the OpenVMS Mail utility at the DCL prompt, type SEND at the MAIL> prompt, and enter the destination. A remote destination consists of the user name followed by an ampersand (@) and the host (such as user_name@host). If the user is on your local host, omit the ampersand (@) and host name.

    $ MAIL
    MAIL> SEND
    To: destination_user@destination_host

Previous | Next | Contents