table of contents
iucvconn(1) | IUCV terminal applications | iucvconn(1) |
NAME¶
iucvconn - start terminal connection over z/VM IUCVSYNOPSIS¶
iucvconn [-h|--help]DESCRIPTION¶
The iucvconn application establishes a terminal connection to another Linux instance. The Linux instance where iucvconn runs and the target Linux instance must be z/VM guest operating systems of the same z/VM instance. The communication path between both virtual machines is based on the z/VM Inter-User Communication Vehicle (IUCV). Because z/VM IUCV is independent from TCP/IP, Linux instances with no external network can be accessed. iucvconn accesses the terminal specified by terminal_id on the z/VM guest virtual machine vm_guest. The terminal_id is similar to a port number in TCP/IP communications. terminal_id is case-sensitive and consists of up to 8 alphanumeric characters. terminal_id must either identify a running iucvtty instance, or a terminal device provided by the z/VM IUCV hypervisor console (HVC) device driver.OPTIONS¶
- -h, --help
- Display a short help text, then exit.
- -v, --version
- Display the version number of iucvconn, then exit.
- -e, --escape-char escape_char
- Set an escape character for this terminal session. You need
an escape character to access special iucvconn functions. The
default escape character is underscore (_). If escape_char is set
to "none", escaping is not possible. The escape character can be
the closing bracket (]), the caret (^), the underscore (_), or any
alphabetical character except C, D, Q, S and Z. The escape_char
character is not case-sensitive.
- -s, --sessionlog logfile
- Create a transcript of the terminal session and write
session data to three different files.
ESCAPE CHARACTERS¶
iucvconn supports functions through the use of an escape character. The default escape character ( escape_char) is underscore (_).- Ctrl+_
- Send the escape character to the connected terminal.
- . or d
- Disconnect and exit iucvconn.
- r
- Force resizing of the connected terminal.
EXAMPLES¶
To access the "lnxterm" terminal on the Linux instance in z/VM guest virtual machine LNXSYS01:iucvconn LNXSYS01 lnxterm
To access the first z/VM IUCV HVC terminal on the Linux instance in z/VM guest virtual machine LNXSYS02:
iucvconn LNXSYS02 lnxhvc0
To create a transcript of the terminal session to the Linux instance in z/VM guest virtual machine LNXSYS99:
iucvconn -s ~/transcripts/lnxsys99 LNXSYS99 lnxhvc0
ENVIRONMENT¶
- TERM
- The terminal environment variable contains the name of the
terminal (e.g. linux, xterm, ...) and also specifies the terminal
capabilities.
DIAGNOSTICS¶
If the Linux kernel does not include kernel support for the AF_IUCV network addressing family, iucvconn exits and displays the message 'AF_IUCV address family is not available: Address family not supported by protocol'.SECURITY¶
Linux¶
The iucvconn program does not require superuser privileges and can be used by regular users. Each connection attempt and failure is logged to the authpriv syslog facility. Terminal session transcripts facilitate logging and auditing of terminal activity on remote systems or recording and playing back terminal sessions, for example for education and presentations.z/VM guest virtual machine¶
The z/VM guest virtual machine must have authorization to establish IUCV communication paths to other z/VM guest virtual machines.NOTES¶
The Linux instance where iucvconn runs and the target Linux instances must be z/VM guest operating systems of the same z/VM instance.SEE ALSO¶
iucvtty(1), hvc_iucv(9), af_iucv(7), scriptreplay(1)March 2009 | s390-tools |