DIGITAL TCP/IP Services for OpenVMS
User's Guide


Previous Contents Index

Copies file NAMES.LIS from remote host BOSTON to remote host FRAM (naming the file ROSTER.LIS). Assumes appropriate entries for the user have been made in each remote host's authentication files.
#10

$ RCP "MILLER@BOSTON:SYS$DIR:T2.TXT" "nelson@nyx:/usr/nelson/T2.TXT" 
      

Copies file T2 from remote OpenVMS system BOSTON in the directory pointed to by the logical name SYS$DIR to remote UNIX system nyx in the specified directory. Different user names are used on the two remote systems. Entries in the remote host's authentication files must be set up properly because the passwords are not being passed.

#11

$ RCP /USER=ROSS /PASSWORD=LC12LC BOS:CLIENT.LIS "BEX:/usr" 
      

Copies file CLIENT.LIS from OpenVMS host BOS to UNIX host bex. The user has a proxy account on the UNIX host. The specified authentication information allows access to the account for ROSS on host BOS.


REXEC

Sends a command line to a specified remote host for execution.

The difference between the REXEC facility and RSH is security checking:

To invoke the REXEC feature, enter one of the following:

RSH /PASSWORD=password

or

RSH /PASSWORD

See the RSH command with the /PASSWORD qualifier.


RLOGIN

Initiates an interactive login session with a remote host.

DCL-Style Format

RLOGIN /DROP_TIMEOUT=seconds host



[ /EIGHTBIT ]
[ /ESCAPE_CHARACTER=character ]
[ /LOG_FILE=file ]
[ /[NO]LOWERCASE ]
[ /PROBE_TIMEOUT=seconds ]
[ /TERMINAL_SPEED=baud ]
[ /TERMINAL_TYPE=type ]
[ /[NO]TRUNCATE_USER_NAME ]
[ /USER_NAME=remote_user_name ] )

UNIX Style Format

rlogin host [ -8 ] [ -ec ] [ -l remote_user_name ]

This format is valid only when logging in to a UNIX system.

Parameters

host

Required.

Remote host to which you want to connect.


Qualifiers

/DROP_TIMEOUT=seconds

Required if you set /PROBE_TIMEOUT.

Maximum interval, in seconds, that your network link can be down before the software closes it.

/EIGHTBIT

-8 (UNIX style, valid only on UNIX systems)

Optional. Default: only 7-bit data is sent.

Accepts 8-bit data from the terminal and sends it to the remote system.

/ESCAPE_CHARACTER=character

-ec (UNIX style, valid only on UNIX systems)

Optional. Default: ~ (tilde).

New escape character if you want to close your RLOGIN session from the remote host.

To close your session from your local host, use a period ( . ) as the escape command.

/LOG_FILE=file

Optional. Default: no logging.

Logs a copy of the output to the specified file. Output continues to be directed to SYS$OUTPUT while it is being recorded in the log file.

/LOWERCASE

/NOLOWERCASE

Optional. Default: /LOWERCASE.

Sends your local user name to the remote host in lowercase.

To send your user name in uppercase, use either of the following:

To send your user name in mixed case, enclose it in quotation marks ( " " ).

/PROBE_TIMEOUT=seconds

Required if you set /DROP_TIMEOUT.

Interval, in seconds, that DIGITAL TCP/IP Services for OpenVMS checks to see if your network link and the remote host are both still up.

/TERMINAL_SPEED=baud

Optional. Default: current speed of your terminal.

Terminal speed in baud rate.

/TERMINAL_TYPE=type

Optional. Default: type of physical terminal you are using.

Terminal type. Use this qualifier if the remote host does not recognize your terminal.

/TRUNCATE_USER_NAME

/NOTRUNCATE_USER_NAME

Optional. Default: /NOTRUNCATE_USER_NAME.

Abbreviates the user name sent to the remote host to eight characters (required for older UNIX hosts, which limit user names to eight characters).

/USER_NAME=remote_user_name

-l remote_user_name (UNIX style, valid only on UNIX systems)

Optional. Default: current name on local host, but in lowercase.

Your user name on the remote host. Specify this qualifier if your user names on the remote host and local host are different.

To send your user name in uppercase, use either of the following:

To send your user name in mixed case, enclose it in quotation marks ( " " ).


Examples

#1

$ RLOGIN /USER_NAME="BlissTon" ROLLS 
      

An OpenVMS user logs in to account BlissTon on UNIX host rolls. The mixed-case remote user name is in quotation marks so RLOGIN does not send it all lowercase, which is the default. This example assumes the user has a proxy account on the remote host.

#2

$ RLOGIN /NOLOWERCASE /USER_NAME=DAVE PLETHORA 
      

User DAVE starts an interactive login session with UNIX host plethora. Because this user has an uppercase user name, it is specified with the /NOLOWERCASE qualifier. This example assumes the user has a proxy account on the remote host.

#3

$ RLOGIN /ESCAPE_CHARACTER="+"  PJARO [Return] 
Password:        (password not echoed)[Return]
Last login: Fri Aug 21 16:50:40 from world.wide.webber.com 
DIGITAL UNIX System - 4: Tues Aug 25 11:02:20 EST 1998 
 
You have mail. 
Tues Aug 25 11:02:20 EST 1998 
 
pjaro> who [Return] 
black     ttyp0   Aug 20 11:02   grades.philosophy.ucd.edu. 
bristow   ttyp1   Aug 12 09:00   grades.biology.ucd.edu. 
cutler    ttyp2   Aug 24 08:55   grades.math.ucd.edu. 
 
pjaro> pwd [Return] 
/usr/users/black 
pjaro> ls [Return] 
bin                     Sem1.paper              Sem2.paper 
 
pjaro> +. (characters not echoed) 
%RLOGIN-S-REMCLOSED, Remote connection closed 
$ 
      

OpenVMS user BLACK, with UNIX user name black, logs in to UNIX host pjaro and resets the escape character to a plus sign. By default, DIGITAL TCP/IP Services for OpenVMS passes the user name and commands to the remote host in lowercase.

#4

$ RLOGIN FANTAC [Return] 
OpenVMS Version 7.1 - Unauthorized access is prohibited.
 
Username: TDERR [Return] 
Password:         (password not echoed) [Return]
   .
   .
   .
$
      

TDERR logs in to remote OpenVMS host FANTAC.

#5

$ RLOGIN QANCE /DROP_TIMEOUT=45 
%RLOGIN-E-INETERROR, Internet interface error 
-RLOGIN-I-INETCALL, setsockopt(TCP_DROP_IDLE) 
-SYSTEM-F-BADPARAM, bad parameter value 
$ 
      

The command fails because the /DROP_TIMEOUT and /PROBE_TIMEOUT qualifiers must both be set.


RSH

Sends a command to a remote host for execution, including a command that invokes a remote shell script or remote command procedure. Any command recognized by the remote host is valid. When using the RSH command, consider the following:

DCL-Style Format

RSH host [/EIGHTBIT ] [ remote_command ]

[ /ESCAPE_CHARACTER=character ]
[ /LOG_FILE=file ]
[ /[NO]LOWERCASE ]
[ /PASSWORD[=password] ]
[ /[NO]SYSERROR ]
[ /TERMINAL_SPEED=n ]
[ /TERMINAL_TYPE=type ]
[ /[NO]TRUNCATE_USER_NAME ]
[ /USER_NAME=remote_user_name ]


UNIX Style Format

rsh host [ -l remote_user_name ] [ remote_command ]

This format is valid only on UNIX systems.


Parameters

host

Required.

Remote host at which you want the command to execute.

remote_command

Optional. Default: none.

Command you are sending to the remote host for execution.

Note

The remote_command must be the last item on the command line.

Qualifiers

/EIGHTBIT

Optional. Default: only 7-bit data is sent.

Accepts 8-bit data from the terminal and sends it to the remote system.

/ESCAPE_CHARACTER=character

Optional. Default: ~ (tilde).

New RLOGIN escape character. This character lets you exit the RLOGIN process without typing the remote host's typical logout sequence, for example, LOGOUT or Ctrl/D.

Typing the escape character and a period (.) breaks the connection with the remote host, for example:


remote> ~. (characters not echoed) 
%RSH-S-LCLCLOSED, Local connection closed 
local_vms> 

/LOG_FILE=file

Optional. Default: no logging.

Logs a copy of the output to the specified file. Output continues to be directed to SYS$OUTPUT while it is being recorded in the log file.

Not valid with /SYSERROR.

/LOWERCASE

/NOLOWERCASE

Optional. Default: /LOWERCASE.

Sends your local user name to the remote host in lowercase.

To send your user name in uppercase, use either of the following ways:

To send your user name in mixed case, enclose it in quotation marks ( " " ).

/PASSWORD[=password]

Optional.

Your password on the remote host.

Invokes the local REXEC facility that directs your RSH command to the REXEC server on the remote host. This server does authentication checking using the user name and password that you specified on the RSH command line.

Directs diagnostics to SYS$ERROR and output to SYS$OUTPUT.

When SYS$ERROR and SYS$OUTPUT both output to the same terminal, the output might be garbled.

/NOSYSERROR directs output only to SYS$OUTPUT.

/TERMINAL_SPEED=n

Optional. Default: your terminal's current speed.

Terminal speed passed to the remote host during an RLOGIN session.

/TERMINAL_TYPE=type

Optional. Default: your terminal's current type.

Terminal type passed to the remote host during an RLOGIN session.

/TRUNCATE_USER_NAME

/NOTRUNCATE_USER_NAME

Optional. Default: /NOTRUNCATE_USER_NAME.

Abbreviates the user name sent to the remote host to eight characters (required for older UNIX hosts, which limit user names to eight characters).

/USER_NAME=remote_user_name

-l remote_user_name (UNIX style, valid only on UNIX systems)

Optional. Default: same name on local host, but in lowercase.

Your user name on the remote host. Specify this qualifier if your user names on the remote host and local host are different.

To send your user name in uppercase, use either of the following ways:

To send your user name in mixed case, enclose it in quotation marks ( " " ).


Examples

#1

$ RSH HENCE MAN CP 
 cp(1) 
 
   Name 
     cp - copy file data 
 
   Syntax 
     cp [ -f ] [ -i ] [ -p ] file1 file2 
   .
   .
   .
   See Also 
     cat(1), pr(1), mv(1) 
$ 
      

A user sends the man cp command to UNIX host hence for execution.

#2

$ RSH /USER_NAME=ROGERS DELPHI LS 
      

OpenVMS user PHILIPS enters the ls command for execution at remote UNIX host delphi. PHILIPS is accessing an account called rogers.

#3

$ RSH /PASSWORD=BLOOMER AVOC8N DIRECTORY 
      

OpenVMS user PANTO sends the DIRECTORY command to remote OpenVMS host AVOC8N. The remote directory listing is of PANTO's home directory.

RSH /PASSWORD invokes REXEC, which authenticates PANTO's remote password.

#4

$ RSH /PASSWORD MAGIC CAT BUZZ.TXT 
REXEC password:        (password not echoed)[Return] 
 
      

A user sends the cat command to host magic. /PASSWORD invokes REXEC, which requires a password. Because the password was omitted from the command line, REXEC prompts the user for it.


Chapter 4
Establishing Network Terminal Sessions Using TELNET/TN3270

With the TELNET software in DIGITAL TCP/IP Services for OpenVMS, you can log in to a remote internet system. This is called establishing a TELNET session. Your terminal appears to be attached directly to the remote system.

You can establish a TELNET session with a host that uses IBM 3270 model terminals (TN3270).

Note that you can also use RLOGIN to log in to remote internet hosts. However, RLOGIN does not have the ability to manage a 3270 session. To determine the best remote login service to use for your needs, see Section 1.1.2. For more information about RLOGIN, see Chapter 3.

What You Can Do

The following table lists the TELNET/TN3270 network terminal services and the sections that explain how to use them.
Capability Section
Use either DCL-style or UNIX style command syntax 4.1
Establish a network terminal session with any other host that uses TCP/IP as a transport 4.3
Log all terminal output to a file 4.5
Toggle between the remote host and the local TELNET prompt 4.7
Suspend TELNET/TN3270 to spawn a subprocess at the DCL prompt 4.8
Establish multiple TELNET sessions 4.9
Toggle between open sessions 4.9.1
Customize the way TELNET interprets control characters, sends and receives transmissions, and displays processing on your terminal 4.6.2
4.10
Send commands to the remote host that affect processing of commands you have entered 4.11
Run IBM 3270 model terminal emulation (TN3270) 4.12
Record a TN3270 screen's contents 4.12.5

What You Need

To use the network terminal services, you need the following:

Command Summary

To use TELNET, issue the commands summarized in Table 4-1 (for complete command descriptions, see Section 4.13).

Table 4-1 TELNET/TN3270 Commands: Summary
DCL-Style UNIX Style Description
Starting (at the DCL Prompt)
TELNET telnet Invokes TELNET
TELNET remote_host telnet remote_host Invokes TELNET and establishes a connection to a remote host
TN3270 N/A Invokes TELNET and TN3270
TN3270 remote_host N/A Invokes TELNET, runs TN3270, and establishes a connection to a remote host
Getting In and Out of Sessions
CONNECT open Establishes a connection between the local host and a remote host
CREATE_SESSION N/A Establishes a pseudodevice and connects it to a remote listener port
DELETE_SESSION N/A Deletes a pseudodevice created by the CREATE_SESSION command
DISCONNECT close Terminates your current session
Ctrl/] Ctrl/] Takes you from the remote host back to the TELNET prompt
EXIT quit Closes open connections and exits from TELNET
HELP help
?
Invokes online help
RESUME [Return] Resumes an open connection
SPAWN z Suspends your TELNET session and takes you to the DCL prompt
 
Customizing the TELNET Environment
DISABLE AUTOFLUSH toggle autoflush Disables the automatic flushing of output when interrupt characters are sent
DISABLE AUTOSYNCH toggle autosynch Disables the automatic sending of interrupt characters in urgent mode
DISABLE BINARY toggle binary Disables transmission in binary mode
DISABLE CRLF toggle crlf Disables the sending of carriage returns as Return LF
DISABLE CRMOD toggle crmod Disables the mapping of received carriage returns
DISABLE DEBUG toggle netdata Disables the display of data flow information in hexadecimal
DISABLE
LOCAL_CHARS
toggle localchars Disables the interpretation of certain control characters by your local TELNET client and passes them to the remote TELNET server
DISABLE
OPTIONS_VIEW
toggle options Disables the display of option negotiations between the client and server
ENABLE AUTOFLUSH toggle autoflush Enables the automatic flushing of output when interrupt characters are sent
ENABLE AUTOSYNCH toggle autosynch Enables the automatic sending of interrupt characters in urgent mode
ENABLE BINARY toggle binary Enables transmission in binary mode
ENABLE CRLF toggle crlf Enables the sending of carriage returns as Return LF
ENABLE CRMOD toggle crmod Enables the mapping of received carriage returns
ENABLE DEBUG toggle netdata Enables the display of data flow information in hexadecimal
ENABLE
LOCAL_CHARS
toggle localchars Enables the interpretation of certain control characters by your local TELNET client and prohibits them from being passed to the remote TELNET server
ENABLE
OPTIONS_VIEW
toggle options Enables the display of option negotiations between the client and server
SHOW DEVICE Displays the current devices
SHOW PARAMETERS display Displays the current parameter settings
SHOW SESSION Displays the current sessions
SHOW STATUS status Displays the current status
SET ECHO set echo Sets the echo character to the specified character
SET ERASE set erase Sets the erase character to the specified character
SET ESCAPE set escape Sets the escape character to the specified character
SET
FLUSHOUTPUT
set flushoutput Sets the flush output character to the specified character
SET INTERRUPT set interrupt Sets the interrupt character to the specified character
SET KILL set kill Sets the kill character to the specified character
SET MODE mode Sets the transmission mode to character or line
SET QUIT set quit Sets the quit character (an alternate interrupt character) to the specified character
SET TERMINAL   Sets the terminal type to the specified model
Sending Commands to the Remote Host
SEND AO send ao Sends the Abort Output command
SEND AYT send ayt Sends the Are You There command, testing the path to the remote application and eliciting connection status information from the remote host
SEND BRK send brk Sends the Break command
SEND EC send ec Sends the Erase Character command
SEND EL send el Sends the Erase Line command
SEND GA send ga Sends the Go Ahead command
SEND IP send ip Sends the Interrupt character
SEND NOP send nop Sends the No Operation command to test whether data can be sent to the remote host, eliciting an error if the connection is not open
SEND SYNCH send synch Sends the Synchronize character


Previous Next Contents Index