Defining AUTOLOG1 in the Directory

To use AUTOLOG1 or any other user ID specified on the SYSTEM_USERIDS statement in the system configuration file to initiate one or more virtual machines, the z/VM® directory statement loads CMS into the AUTOLOG1 virtual machine. In the PROFILE EXEC for AUTOLOG1, each CP AUTOLOG command can initiate one virtual machine. Each such virtual machine can contain a guest operating system, such as VSE. When you use the CP AUTOLOG command, the directory entry for the virtual machine referred by the CP AUTOLOG command must contain an IPL statement.

In our example, the PROFILE EXEC for AUTOLOG1 does not directly autolog the VSE guests. Because we are using a virtual disk in storage to store temporary data, we need a user who is not a VSE guest to own the virtual disk in storage. A virtual disk in storage simulates an FBA minidisk and cannot be formatted from VSE. Therefore, the PROFILE EXEC for AUTOLOG1 contains a CP AUTOLOG command for a server machine called VSESETUP, which owns the virtual disk in storage. The PROFILE EXEC for VSESETUP calls the ICKDSF program to format the virtual disk in storage. Following the call to ICKDSF, the PROFILE EXEC for VSESETUP contains CP AUTOLOG commands for the four VSE guest virtual machines.

Figure 1 shows the AUTOLOG1 entry in the z/VM directory. The IPL statement initializes CMS, causing the execution of the PROFILE EXEC.

Figure 1. AUTOLOG1 Entry in z/VM Directory

IDENTITY AUTOLOG1 pw 32M 32M ABCDEG
 BUILD ON * USING SUBCONFIG AUTLG1-1
 AUTOLOG OP1 MAINT
 ACCOUNT 9 SYSTEM
 MACH ESA
 IPL 190
 CONSOLE 009 3215
 SPOOL 00C 2540 READER *
 SPOOL 00D 2540 PUNCH  A
 SPOOL 00E 1403 A

SUBCONFIG AUTLG1-1
 LINK MAINT 190 190 RR
 LINK MAINT 193 193 RR
 LINK MAINT 19E 19E RR
 MDISK 191 3390 2610 005 MO1RES MR readpw writepw multipw

Figure 2 shows the PROFILE EXEC for AUTOLOG1 with the CP AUTOLOG command for the VSESETUP server machine. The last CP command in the PROFILE EXEC logs off AUTOLOG1.

Figure 2. PROFILE EXEC for AUTOLOG1 with AUTOLOG Command for VSESETUP

/* PROFILE EXEC for AUTOLOG1 */
 
TRACE O
ADDRESS COMMAND
'CP SPOOL CONSOLE START'
'CP SET EMSG ON'
'CP AUTOLOG VSESETUP password'
'CP LOGOFF'

Figure 3 shows the PROFILE EXEC for VSESETUP, containing the call to ICKDSF and the CP AUTOLOG command for each VSE virtual machine to be loaded. VSEVM is autologged first because in our example it is the guest that initializes the lock file. The last CP command in the PROFILE EXEC logs off VSESETUP.

Figure 3. PROFILE EXEC for VSESETUP with AUTOLOG Commands

/* PROFILE EXEC for VSESETUP */
 
/* Sample exec to ICKDSF virtual disk in storage    */
/* and AUTOLOG VSE guests                           */
/* Assumes virtual disk in storage defined in       */
/* directory as device 900                          */
PUSH 'END'
PUSH 'U'
PUSH 'INIT UNIT(900),NOVERIFY,NOMAP,VOLID(VDSK01),FBAVTOC(start,length)'
PUSH 'CONSOLE'
PUSH 'CONSOLE'
'ICKDSF'
/* The following message will inform the operator that the guest */
/* operating systems are being autologged.                       */
'MSG OP The guest VSE virtual machines are being autologged.'
'ENABLE ALL'
'AUTOLOG VSEVM password' /* This is the guest that formats the lock file */
'SLEEP 30 SEC' /* Allows time to format lock file - adjust as necessary */
'AUTOLOG VSESA1 password'
'AUTOLOG VSESA2 password'
'AUTOLOG ......
'AUTOLOG ......
CP LOGOFF
EXIT

With the CP AUTOLOG command in the PROFILE EXEC, the VSE virtual machine is loaded and runs in disconnected mode. A VSE user can gain access by doing one of the following:

Logging on with the user ID specified in the CP AUTOLOG command
Issuing the CP SEND command from the secondary user's console
Issuing the CP DIAL command and specifying the guest user ID.

When the user logs off, the contiguous storage space is relinquished, and the virtual machine stops. If you want to keep the virtual machine's I/O blocks in contiguous storage and keep the virtual machine running while you temporarily give up use of the virtual machine console, then enter the CP DISCONNECT command. Later, you can enter the CP LOGON command to reconnect the console to the virtual machine.