Name

ologin − remote login using the OSI Virtual Terminal protocol

Syntax

ologin application [−b c] [−d c] [−e c] [−h] [−o filename] [−p profile-name]

Description

The ologin command is used to communicate with another host using the OSI Virtual Terminal protocol.  The application argument an alias in /etc/isoapplications, or an X.500 Distinguished Name, and specifies the remote node with which ologin will establish an association. The /etc/isoapplications file contains the aliases and their addresses.  You will see the login prompt of the remote system when you complete the connection.

Options

application
Specifies either an alias listed in the /etc/isoapplications file, or an X.500 Distinguished Name.  If the input is an alias, then it is looked up in the /etc/isoapplications file.  If the input is an X.500 Distinguished Name, then the X.500 Directory is queried for the presentation address associated with the X.500 Directory entry specified by the input Distinguished Name.

−b c Sets the break character.  When this character is typed, a VT-BREAK message is sent to the responder.  This message causes all messages that have been received but not processed to be discarded.  The default for this character is <Ctrl/^> (^^). 

−d c Sets the disconnect character.  When this character is typed, a VT-RELEASE message is sent to the responder.  This message causes the Virtual Terminal association to be terminated.  The default for this character is <Ctrl/_> (^_). 

-e c Sets the escape (command) character.  When this character is typed, ologin escapes to command mode.  The default for this character is <Ctrl/]> (^]). 

−h Print help message. 

−o filename
Save screen output to a file.  This option takes a file name as an argument.

−p profile-name
Specifies the initial profile to be negotiated. Note that these values are not case-sensitive and can be abbreviated to the point where they are unique.  The default profile is generalized-telnet.  The following profiles are available:

transparent

telnet

generalized-telnet

a-mode

Commands

The ologin utility lets you execute commands on your local node after you have started a remote session on another node.  Whenever you wish, you can switch back and forth between your local session and your ologin session with the ologin escape (command) character. To temporarily return control to your local node, at the remote system’s prompt, type the ologin escape character. The default escape character is <Ctrl/]>.  Entering the escape character puts you at the local prompt where you can execute commands. Return to the remote session by pressing <RETURN> on a line by itself.  The following commands are available:

abort
Aborts any Virtual Terminal association and exits ologin.

display [ item ]
With no argument, displays all set and toggle values (see below), as well as the current profile and any negotiated profile information.  With an argument specified, displays information about that item only. 

display profile
Displays the current profile and any negotiated profile information. Note that this command does not have an equivalent set profile as with other display commands. 

exit
Releases any Virtual Terminal association and exits ologin.

help
Accesses on-line help. ologin displays a list of command topics on which help is available. Selecting a topic provides an explanation of that topic, along with subtopics you can select for more information.

?  Same as help

mode type
(Available only when using the Telnet or Generalized-Telnet profiles.) The type is either line, for line-by-line mode, or character,for character-at-a-time mode.  The VT initiator asks the responder for permission to go into one or the other mode.  The responder enters the requested mode if it is capable. 

quit Same as exit

resume
Exits ologin command mode and resumes your Virtual Terminal association.

send argument
Sends a special character sequence to the responder. After you issue the send command, ologin automatically exits command mode. One of the following arguments can be specified.
 
The send command, break, and disconnect options are useful when the command (escape), break, or disconnect character has some meaning to the remote host.  Using one of these commands sends the specified character sequence to the remote host to be processed, bypassing its ologin function.

ao
(Available only when using the Telnet or Generalized-Telnet profiles.) Sends the TELNET AO (Abort Output) sequence, which causes the remote system to alternately suspend and resume the sending of output to the user’s terminal.  The AO sequence does not affect the processing of the remote system.

ayt
(Available only when using the Telnet or Generalized-Telnet profiles.) Sends the TELNET AYT (Are You There) sequence.  The remote system may or may not respond.

brk
(Available only when using the Telnet or Generalized-Telnet profiles.) Sends the TELNET BRK (Break) sequence, which may have significance to the remote system.

break
Sends the current break character.

command
Sends the current command (escape) character.

disconnect
Sends the current disconnect character.

ec
(Available only when using the Telnet or Generalized-Telnet profiles.) Sends the TELNET EC (Erase Character) sequence, which causes the remote system to erase the last character entered.

el
(Available only when using the Telnet or Generalized-Telnet profiles.) Sends the TELNET EL (Erase Line) sequence, which causes the remote system to erase the line currently being entered.

ga
(Available only when using the Telnet or Generalized-Telnet profiles.) Sends the TELNET GA (Go Ahead) sequence.  Often this sequence has no significance to the remote system.

ip
(Available only when using the Telnet or Generalized-Telnet profiles.) Sends the TELNET IP (Interrupt Process) sequence, which causes the remote system to abort the currently running process.

synch
(Available only when using the Telnet or Generalized-Telnet profiles.) Sends the TELNET SYNCH sequence.  This sequence causes the remote system to discard input that was previously entered but that it has not yet read.

vtbreak
Sends a VT-BREAK message.  This is similar in concept to the TELNET SYNCH sequence.

? 
Prints out help information for the send command. 

set item [ value ]
Sets an ologin variable to a specific value or sets to TRUE the value of a flag that controls how the VT initiator responds to events.  Valid values for setting the value of an initiator variable are a single character, a control-character, a circumflex-character sequence, or OFF.  Circumflex-character sequences are interpreted as control characters. The OFF value turns off the function associated with the variable. The current values of variables can be displayed with the display or show command.  Valid items are:

break
Sets the value of the break initiator variable to the specified value.  When the break character is entered at the terminal, a VT-BREAK message is sent to the responder.  The value is initially <Ctrl/^> (^^). 

command
Sets the value of the command (escape) initiator variable to the specified value.  When the command (escape) character is entered at the terminal, ologin command mode is entered.  The value is initially <Ctrl/]> (^]).

disconnect
Sets the value of the disconnect initiator variable to the specified value.  When the disconnect character is entered at the terminal, a VT-RELEASE message is sent to the responder and the Virtual Terminal association is terminated.  The value is initially <Ctrl/_> (^_). 

binary, inbinary, and outbinary
Sets the item to TRUE. See the toggle command. 

? 
Prints out help information for the set command. 

show [ item ]
Same as display

show profile
Same as display profile

toggle item
(Available only when using the Telnet or Generalized-Telnet profiles.) Toggles (between TRUE and FALSE) the flags that control how ologin responds to events. After you issue the toggle command, ologin automatically exits command mode. The current value of these flags can be displayed with the display or show command.  Valid items are:

binary
Toggles the value of the binary flag.  The binary flag allows 8-bit data to be both sent and received.  If either or both of inbinary and outbinary are FALSE, then the appropriate value is toggled to TRUE.  If both are TRUE, then both are toggled to FALSE. 

inbinary
Toggles the value of the inbinary flag.  The inbinary flag allows 8-bit data to be received. 

outbinary
Toggles the value of the outbinary flag.  The outbinary flag allows 8-bit data to be sent. 

? 
Displays the valid toggle arguments. 

unset item
Sets an ologin variable to off, or sets to FALSE the value of a flag that controls how ologin responds to events. Valid arguments are the same as those for the set command. 

Examples

% ologin discvr -o myfile.out

This example invokes a DECnet/OSI Virtual Terminal association, specifies discvr as the remote host node, and stores the screen output in a file called myfile.out.

See Also

isoapplications(5)
DECnet/OSI FTAM and Virtual Terminal Use and Management