DIGITAL TCP/IP Services for OpenVMS
User's Guide

The TNA device (terminal device)
The associated BG device (network device)
Whether the TNA device is permanent or temporary
Local host name and port number
Remote host name and port number


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 . . .

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 on all TNA devices which 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-Style Format

SHOW PARAMETERS

UNIX Style 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> TELNET>

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>
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: (password not echoed) Welcome to OpenVMS Alpha Version 7.1 on node LUNA $ `[Ctrl/]`] (characters not echoed) TELNET> SHOW SESSION Session 01, host LUNA, port 23 (default active port) TELNET>

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.1 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>

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 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: (password not echoed) Welcome to OpenVMS Alpha Version 7.1 on node LUNA $ `[Ctrl/]`] (characters not echoed) 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>

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.1 on node LUNA
 
$ [Ctrl/]]             (characters not echoed)
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 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/]`] (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>

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.

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 11 14:16:39 EDT 1998 % `[Ctrl/]`] (characters not echoed) TELNET> SPAWN $ SHOW TIME 11-Sep-1998 14:16:41 . . . $ LOGOUT Process GROUP_1 logged out at 11-Sep-1998 14:27:18.63 TELNET> RESUME

% date 
Fri Sep 11 14:16:39 EDT 1998
% [Ctrl/]] (characters not echoed)
TELNET> SPAWN 
$ SHOW TIME 
        11-Sep-1998 14:16:41 
   .
   .
   .
$ LOGOUT 
  Process GROUP_1 logged out at 11-Sep-1998 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

DCL-Style Format

TELNET [ host ] qualifier(s)* [ port ] [unit ]

*Choose from the following qualifiers:
[ /BIND_SESSION network_device /PROTOCOL=protocol ]
[ /CREATE_SESSION [ /[ NO ]TIMEOUT=option
/PROTOCOL=option
[ /DELETE_SESSION ]
[ /LOG_FILE=file ]
[ /NOINTERACTIVE ]
[ /PORT=n ]
[ /TERMINAL_TYPE=type ]
[ /UNBIND_SESSION ]

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

/BIND_SESSION network_device
Optional. Default: None.
Binds a TELNET terminal device to an existing network device. If the bind is successful, the DCL symbol $TELNET_DEVICE contains the TNA device name.
/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.

/NOTIMEOUT
/TIMEOUT=option

Where option is:

NOIDLE
IDLE=delta_time_interval
Specifies the delta time interval to wait with no activity before closing the connection. The general delta time format is HH:MM:SS:CC.

NORECONNECT
RECONNECT=delta_time_interval
Specifies the delta time interval to wait before retrying a connect request. The general delta time format is HH:MM:SS:CC.

/PROTOCOL=option
Optional. Default: NONE.
where option is:

NONE
Data is sent with no interpretation (raw).
NVT
Network Virtual Terminal (NVT), TELNET's internal representation of a standard network terminal. NVT format is standard 7-bit ASCII code transmitted in 8-bit octets, the canonical form of data representation used by both the client and server.
TELNET
Standard TELNET protocol.
RLOGIN
Standard RLOGIN protocol.

/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 that contains 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. Enter the full specification for one of these terminals:

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

/UNBIND_SESSION network_device terminal_device
Optional.
Unbinds a network device (BGx:) from a TELNET terminal device (TNAx:) that was initially bound by a BIND_SESSION command or qualifier.

Examples

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

In this example, the TELNET command:

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:TN3270DEF.TBL, if your system manager has created it.
Defaults to its own translation table, if TN3270DEF.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/TN3270 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. Enter 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.

UNBIND_SESSION

Unbinds a network device (BGx:) from a TELNET terminal device (TNAx:) that was previously bound with a BIND_SESSION command or qualifier.

DCL-Style Format

UNBIND_SESSION network_device terminal_device

Parameters

network_device
Required.
Network device (BGx:) to unbind.
terminal_device
Required.
Associated terminal device (TNAx:).

Example


TELNET> TNA458: BG2032: Temporary condor:4009 angel:23 TNA460: BG4739: Temporary condor:23 ler13.dec.com:1037 TNA463: Temporary TELNET> UNBIND_SESSION BG2032: TNA458: TELNET>

Contents

Index

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

DIGITAL TCP/IP Services for OpenVMSUser's Guide

SHOW PARAMETERS

DCL-Style Format

SHOW PARAMETERS

UNIX Style Format

display

Example

SHOW SESSION

DCL-Style Format

SHOW SESSION

UNIX Style Format

status

Examples

SHOW STATUS

DCL-Style Format

SHOW STATUS

UNIX Style Format

status

Examples

SPAWN

DCL-Style Format

SPAWN

UNIX Style Format

z

Example

TELNET

DCL-Style Format

UNIX Style Format

telnet [ host ]

Parameters

host

port

unit

Qualifiers

/BIND_SESSION network_device

/CREATE_SESSION

/DELETE_SESSION

/LOG_FILE=file

/NOINTERACTIVE

/PORT=n

/TERMINAL_TYPE=type

/UNBIND_SESSION network_device terminal_device

Examples

TN3270

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

Qualifiers

/CHARACTER_SET=file

/KEY_DEFINITIONS=file

/NATIONAL_CHARACTERS=character_set

/NOINTERACTIVE

/PORT=n

/PRINTER=file

/STATUS=state

/TERMINAL_TYPE=IBM-3278-n

Examples

UNBIND_SESSION

DCL-Style Format

UNBIND_SESSION network_device terminal_device

Parameters

network_device

terminal_device

Example

DIGITAL TCP/IP Services for OpenVMS
User's Guide

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