z/VM guest virtual machine setup for a terminal server

Edit online

There are some minimum requirements that the z/VM® guest virtual machine for the terminal server must meet.

The z/VM guest virtual machine for the terminal server has these requirements:

  • Sufficient storage (memory) for your Linux™ distribution.
  • A network connection.
  • Optional: Persistent disk space for session transcripts.

Figure 1 shows a typical directory entry for the z/VM virtual machine of a terminal server.

Figure 1. Sample directory entry for a terminal server
USER LXTS     XSECRETX 768M 1G G
* General statements
   IPL 0150
   CPU 00 BASE
   CPU 01
   MACH ESA 8
* IUCV authorization
   IUCV ANY
   OPTION MAXCONN 128
* Generic device statements
   CONSOLE 0009 3215 T
   SPOOL 000C 2540 READER *
   SPOOL 000D 2540 PUNCH A
   SPOOL 000E 1403 A
* Network connection
   NICDEF 7000 TYPE QDIO LAN SYSTEM VSWITCH1
* MiniDisks for Linux system and CMS A-disk
   MDISK 0150 3390 0001 3318 LXDASD1 MR
   MDISK 0151 3390 0001 1000 LXDASD2 MR
   MDISK 0191 3390 3000 0032 MDDASD  MR

The statements in this sample have the following meaning:

USER
defines a z/VM user ID (LXTS) with an initial password (XSECRETX). It also assigns 768 MB storage (memory) that, if required, can be expanded to 1 GB, and grants general user privileges (G).
IPL
specifies the boot device for Linux.
CPU
defines one or more virtual CPUs.
MACH ESA 8
specifies the machine architecture and the maximum number of CPUs that can be defined.
IUCV
allows the z/VM guest virtual machine to start an IUCV connection to any other z/VM guest virtual machine. Alternatively, you can use one or more statements of the form IUCV <userid> to grant permission to particular target systems as identified by <userid>. You can also grant IUCV permissions within the z/VM guest virtual machine specifications of the target system.

For more information about z/VM IUCV, see z/VM CP Programming Services, SC24-6179 and z/VM CP Planning and Administration, SC24-6178.

OPTION MAXCONN 128
limits the number of concurrent IUCV connections to 128. If omitted, the limit defaults to 64, the maximum value for MAXCONN is 65,535.
CONSOLE
defines the z/VM console device.
SPOOL
defines the z/VM spool file queues.
NICDEF
defines a virtual network device that is to be connected to a virtual switch. The network device that you use depends on your installation. For example, you can also use appropriate statements to specify HiperSockets™ or Open System Adapter (OSA) devices. See z/VM Connectivity, SC24-6174 for more information.
MDISK
Assigns read/write disk space for Linux and other data. The amount of disk space you require depends chiefly on the extent to which you want to create session transcripts.

For more information about z/VM user directory entries, see the chapter about the z/VM user directory in z/VM CP Planning and Administration, SC24-6178.