The iucvtty application provides full-screen terminal access to an instance of Linux on z/VM®.
Runs on target systems to start iucvtty instances. Typically, the iucvtty command is called through systemd instance units, inittab entries, or Upstart job files.
Format
iucvtty syntax .- -- /bin/login---------------------------. >>-iucvtty--+-------------+-- <terminal_id>--+------------------------------------------+->< '- -a <regex>-' '- -- <login_program>-+------------------+-' '- <login_options>-'
where:
- -a or --allow-from <regex>
- is a regular expression that limits permissions for incoming connections to matching z/VM user IDs. The connection is refused if the z/VM user ID does not match. If this parameter is omitted, connections are permitted from any z/VM user ID.
- <terminal_id>
- identifies the z/VM IUCV connection. <terminal_id> is case-sensitive and consists of up to eight alphanumeric characters. The <terminal_id> must be specified as a parameter in access requests against an iucvtty instance. The <terminal_id> is like a port number in TCP/IP communications.
- <login_program>
- specifies the absolute path to the login program to be started when a connection is established. The default is /bin/login.
- <login_options>
- specifies further options that depend on the particular login program used.
- -v or --version
- displays the version number of iucvtty and exits.
- -h or --help
- displays a short help text and exits. For more detail, see the iucvtty man page.
Examples
- To allow remote logins for terminal ID lxterm1:
[root]# iucvtty lxterm1 - To allow only users from LXGUEST1 to access lxterm1:
[root]# iucvtty -a lxguest1 lxterm1 - To allow only users from LINUX10 through LINUX19 to access lxterm1:
[root]# iucvtty -a "linux1[0-9]" lxterm1 - To use /sbin/sulogin instead of /bin/login for suterm:
[root]# iucvtty suterm -- /sbin/sulogin