converse

converse


conv-case Index Level copy
Syntax converse port.number {(options}
Category TCL
Type Verb
Description links the current process to a device. The "target" or "slave" device is put into "pass-through" mode, allowing data in and out in "raw" mode.

The target device (the one being "linked" to the current device) must be available on the given "port.number". It may not be already attached or linked to another process.

A "hotkey", or "termination", sequence disconnects the link. The default "hotkey" sequence is <escape>x. The default can be modified by using the "d" option.

If the termination sequence contains an escape character, as in the default, an "esc-data" command is issued automatically, so the process will not get locked out from being able to suspend "converse".

When the device is successfully attached, "LINE ATTACHED" is displayed on the master terminal, unless the (S) option is used.

On releases 6.1 and later, hitting the <BREAK> key on the master terminal, sends a <BREAK> to the slave port.

On all Unix implementations, if the Pick process is not connected to the virtual machine, then "converse" is not allowed, even if the "where" verb with a "z" option shows the port as being available.
Options
c  Captures all output on the (slave) screen and writes it to an item in the "dm,cap-file," using the item-id "*n", where "n" is the current port.number.

d/hexnum{,hexnum...}  Designates the sequence of characters to terminate "converse" mode. Each character is provided in its hexadecimal equivalent of its ASCII value. Each character is separated by a comma. The "/" is required after the "d" option and before the first hex number. For example, "d/41,42,43,44", indicates that an "ABCD" will disconnect the link.

i  Same as the "c" option, except that output from the master process is captured.

n  Suppresses capturing on converse mode. This is the default.

s  Suppresses the message when the process terminates.

x  Terminates converse mode on target device number and returns target device to logon.

z  (releases 6.1 and later) Used in conjunction with (I) or (C), translate the non printable characters into a dot, the carriage returns into an attribute mark and suppresses the line feeds. Without this option, if a character x'ff' is captured, the item is truncated.
See Also tandem mirror unlink-pibdev :reset-async port.number system privileges cap-file devs link-pibdev dev-det dev-att :ent-mon
Example converse 16

Attaches the current process to port 16.

converse 33 (c

Attaches the current process to port 33, capturing screen output from the slave process.

converse 3 (d/2a,2b,2b

Attaches to port 3 and sets the hotkey sequence to "*++".

converse 42 (iz

Attaches to port 42 and captures the screen output from the master process, making sure all data is displayable.

converse 42 (x

Terminates converse on port 42 and returns port to logon.
Warnings If the termination sequence contains an escape (as in the default), it is not easy to send an escape by itself to the target port.  This is due to the fact that, since an escape starts the termination sequence, the system waits for the second character. If character other than 'x' is typed, then the escape and the second character are sent together. This may create some unexpected results. If  an escape is to be used as a regular  character, it is preferable to define a less used character for the termination sequence, like a DEL.
Unlike some other implementations, a <BREAK> is not generated by a special escape sequence. Simply hit the <BREAK> key on the master terminal to send a <BREAK> signal to the slave device.
If the slave device is not a serial line, the <BREAK> will be interpreted accordingly. For instance, if the target is a Telnet entity, the <BREAK> will generate the appropriate Telnet message.
When capturing is in effect, the data is not stored in real time to the cap-file item. There may be a delay of a few seconds. This is done to reduce the number of file accesses in case of heavy traffic.
Compatibility D3 7.0 AP AP 6.1
conv-case Index Level copy