DIGITAL TCP/IP Services for OpenVMS
User's Guide


Previous Contents Index

4.12.10.0.2 Visible Attribute Mode Displays

The attribute characters are displayed in reverse video, bold symbols. Attribute characters indicating numeric fields are also underlined. All other characters are displayed normally. Table 4-7 lists the attribute characters and their meanings.

Table 4-7 Visible Attribute Mode: Displays
Character Meaning
n Unprotected field with normal intensity follows
N Protected field with normal intensity follows
d Following unprotected field is light-pen-detectable
D Following protected field is light-pen-detectable
h Following unprotected field has high intensity
H Following protected field has high intensity
i Unprotected nondisplay field follows
I Protected nondisplay field follows

4.13 Command Descriptions

To start TELNET, issue either the TELNET command or the TN3270 command at the DCL prompt.

To use TELNET commands, enter them at the TELNET> prompt.

This section provides complete descriptions of each TELNET command. The related ENABLE and DISABLE commands are presented together (see the description for ENABLE).


CONNECT

Establishes a TELNET connection between your local system and a remote host. You can run one session or up to ten simultaneous sessions (only one session if you invoke TN3270).

DCL-Style Format

CONNECT host [ port* [ terminal_type ] ]

* Required if you specify terminal type.


UNIX Style Format

open host [ port ] [ terminal_type ]


Parameters

host

Required.

Remote host to which you want to connect.

port

Optional without terminal_type.
Required with terminal_type.
Default: 23.

TELNET port on the remote host. Specify this parameter if:

terminal_type

Optional. Default: model of your physical terminal.

Terminal model that you want your physical terminal to function as. Specify one of the following:


Examples

#1

TELNET> CONNECT MYBUD 
      

Establishes a TELNET connection to remote host MYBUD.

#2

TELNET> CONNECT DEBTS 23 IBM-3278-2 
      

Establishes a TELNET connection to remote host DEBTS and runs TN3270. Your terminal functions as an IBM-3278-2 model terminal. For syntactical reasons, specifying a port number is required.

#3

TELNET> CONNECT 130.180.5.5 
      

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

#4

TELNET> CONNECT REVIN 31 
      

Establishes a TELNET connection to remote host revin. The connection is at port 31 on revin.

#5

% [Ctrl/]]  (characters not echoed)
TELNET> CONNECT QUIK
   .
   .
   .
%
      

During a TELNET session with a UNIX host, pressing Ctrl/] escapes to the TELNET prompt. Another CONNECT command establishes a second session, this one to UNIX host quik.


BIND_SESSION

Creates a TELNET terminal device (TNAx:) and connects to a network device (BGx:). If successful, returns the TNA device name (TNAx:) in the DCL symbol $TELNET_DEVICE. Network input and output operations may then be performed through the created TELNET device using terminal driver $QIO operations.

DCL-Style Format

BIND_SESSION network_device [ /PROTOCOL=option ]


Parameters

network_device

Required.

An existing network device.


Qualifiers

/PROTOCOL=option

Optional. Default: NONE.

Where option is:


Example


TELNET> BIND_SESSION BG393: /PROTOCOL=NVT 
      


CREATE_SESSION

Establishes an outbound TELNET pseudodevice (network terminal) and connects it to a remote listener (port).

DCL-Style Format

CREATE_SESSION host port [ unit ]


[ /[ NO ]TIMEOUT=option ]
[ /PROTOCOL=option ]

Parameters

host

Required.

Remote host to which you want to connect.

port

Required.

TELNET port on the remote host.

unit

Optional. Default: 0

The decimal number specifying the unit number for the pseudodevice (TNAx). The default "0" specifies that the DIGITAL TCP/IP Services for OpenVMS software should pick the next available unit number. If the requested unit number is already in use, the DIGITAL TCP/IP Services for OpenVMS software picks the next available unit number. In all cases, the software notifies you of the unit number chosen.


Qualifiers

/TIMEOUT

/NOTIMEOUT

Optional. Default: /NOTIMEOUT

/PROTOCOL=options

Optional. Default: NONE. Options include:

Example


TELNET> CREATE_SESSION DEBTS 23 2 
      

Establishes a network terminal known as TNA2 and connects this device to port 23 on remote host DEBTS.


TELNET> CREATE_SESSION /TIMEOUT=(NOIDLE, RECONNECTION=NN)
      

Creates a device which disconnects on deassignment and reconnects when data is written to it.


TELNET> CREATE_SESSION /NOTIMEOUT
      

Creates a device that is not reusable: the device disconnects on deassignment and is deleted.


TELNET>  CREATE_SESSION /TIMEOUT=(IDLE=0:0:30, RECONNECTION=0:2:00)
 
      

Creates a device which times out after being idle for 30 seconds and which retries connection attempts at 2 minute intervals.


DELETE_SESSION

Deletes an outbound TELNET pseudodevice (network terminal) created by the CREATE_SESSION command. If the device was not created with the CREATE_SESSION command, the command returns an error.

DCL-Style Format

DELETE_SESSION unit


Parameters

unit

Required.

The decimal number specifying the unit number of the pseudodevice (TNx) to be deleted.


Example


TELNET> DELETE_SESSION 2 
      

Deletes the network terminal known as TNA2.


DISCONNECT

Terminates the current remote connection.

If you terminate a session with a remote OpenVMS host, the connection is closed by your local host. However, the process on the remote host is still running. To terminate it, issue a LOGOUT command.


DCL-Style Format

DISCONNECT


UNIX Style Format

close


ENABLE (DISABLE) AUTOFLUSH

Enables or disables the automatic flushing of output when you send the interrupt character.

Default: ENABLE AUTOFLUSH.


DCL-Style Format

ENABLE AUTOFLUSH

DISABLE AUTOFLUSH


UNIX Style Format

toggle autoflush


ENABLE (DISABLE) AUTOSYNCH

Enables or disables the sending of the synchronization and interrupt characters in urgent mode.

Default: DISABLE AUTOSYNCH.


DCL-Style Format

ENABLE AUTOSYNCH

DISABLE AUTOSYNCH


UNIX Style Format

toggle autosynch


ENABLE (DISABLE) BINARY

Enables or disables the transmission of data in binary mode.

Default: DISABLE BINARY.


DCL-Style Format

ENABLE BINARY

DISABLE BINARY


UNIX Style Format

toggle binary


ENABLE (DISABLE) CRLF

Enables or disables the sending of carriage returns as Return LF (the carriage return / line feed combination) at the end of each line.

Default: ENABLE CRLF.


DCL-Style Format

ENABLE CRLF

DISABLE CRLF


UNIX Style Format

toggle crlf


ENABLE (DISABLE) CRMOD

Enables or disables the mapping of received carriage returns. With this mapping, the remote host sends each line with Return LF (the carriage return / line feed combination) at the end of each line.

Default: DISABLE CRMOD.


DCL-Style Format

ENABLE CRMOD

DISABLE CRMOD


UNIX Style Format

toggle crmod


ENABLE (DISABLE) DEBUG

Enables or disables the display of data in hexadecimal.

Default: DISABLE DEBUG.


DCL-Style Format

ENABLE DEBUG

DISABLE DEBUG


UNIX Style Format

toggle netdata


Example


% [Ctrl/Z]  (characters not echoed) 
TELNET> enable debug [Return] 
TELNET> display [Return] 
   .
   .
   .
Will print network data flow in hexadecimal 
. 
. 
. 
TELNET>)resume [Return]
SEND [   0] D A 
RCVD [   0] D A 
RCVD [   0] 746E7069782E6C6B672E6465632E636F6D3E20 
% ls [Return] 
SEND [   0] 6C 
RCVD [   0] 6C l 
SEND [   0] 73 
RCVD [   0] 73 s 
SEND [   0] D A 
RCVD [   0] D A 
RCVD [   0] 62696E20202020202020... 
RCVD [  32] 7074 D A 
french.estud.oiseau     russian.estud.ptitsa     fences 
typescript     verio 
%
      

Escapes from a session with a UNIX host, enables debug mode, resumes the session, and asks for a list of files in the working directory. Both hexadecimal data and readable data are displayed.


ENABLE (DISABLE) LOCAL_CHARS

Enables or disables the translation of the following terminal control characters in to TELNET protocol sequences:

With local characters:

Default: DISABLE LOCAL_CHARS.


DCL-Style Format

ENABLE LOCAL_CHARS

DISABLE LOCAL_CHARS


UNIX Style Format

toggle localchars


ENABLE (DISABLE) OPTIONS_VIEW

Enables or disables the display of option negotiations between the local system and the remote host during the session.

Default: DISABLE OPTIONS_VIEW.


DCL-Style Format

ENABLE OPTIONS_VIEW

DISABLE OPTIONS_VIEW


UNIX Style Format

toggle options


EXIT

Closes any open sessions, exits from TELNET, and returns to the DCL prompt.

If you terminate a session with a remote OpenVMS host, the connection is closed by your local host. However, the process on the remote host is still running. To terminate it, issue a LOGOUT command.


DCL-Style Format

EXIT


UNIX Style Format

quit


HELP

Displays online help for TELNET or TN3270 commands.

Format

HELP [ dcl_style_telnet_command ]


Parameters

dcl_style_telnet_command

Optional.

Specific TELNET command about which you want information.


Examples

#1

TELNET> HELP CONNECT 
      

This command provides information about the CONNECT command.

#2

TELNET> HELP OPEN 
      

This command displays: Sorry, no documentation on OPEN.

To get help for a command, enter the command name using DCL style.


RESUME

Resumes an open TELNET or TN3270 session that you interrupted with the escape sequence. When you run simultaneous multiple sessions (TELNET only):

DCL-Style Format

RESUME [ session_number ] [Return]


UNIX Style Format

[Return]


Parameters

session_number

Optional. Default: the active session.

Use session_number when you run multiple TELNET sessions. It resumes the session with the specified number.


Examples

#1

$ [Ctrl/]] (characters not echoed)
TELNET> SHOW STATUS [Return] 
Session  1 Active  Host FINDER
   .
   .
   .
TELNET> RESUME [Return] 
$
 
      

This example:

#2

% [Ctrl/]] (characters not echoed)
TELNET> SHOW STATUS [Return] 
Session  2 Active  Host LUNA
   .
   .
   .
Session  1 Waiting Host SOLAR
TELNET> RESUME 1 [Return] 
%
 
      

This example:


Previous Next Contents Index