Step 17: Set Up the Server for Automatic Starting

You can have the server started in multiple user mode every time z/VM® itself is started. This step is optional and can be done any time after the file pool is generated. These instructions assume an AUTOLOG1 virtual machine exists on your z/VM system and you know the password to the machine. For automatic starting, do the following:

  1. Log on or reconnect to the server machine if you are not already logged on to it.
  2. Stop multiple user mode processing by issuing the server STOP NOBACKUP operator command.
  3. Make a copy of the current PROFILE EXEC.

    You should make a copy of the PROFILE EXEC as it currently exists. This exec is needed because sometimes it is necessary to log on the server and inhibit the execution of the usual PROFILE EXEC, which will be modified to automatically start the server. In these instances, it is handy to have an exec that contains everything in the PROFILE EXEC except the command to start multiple user mode processing. You would process the exec so the server machine would have access to the minidisks on which the FILESERV commands reside.

    In the step-by-step instructions in other parts of this manual, it is assumed you have such an exec with a file name of SETUP. To create the SETUP EXEC enter:
    copyfile profile exec a setup = =

    Naturally, you can name the exec anything you like, just remember to substitute your name whenever the instructions ask that you process the SETUP EXEC.

  4. Edit the PROFILE EXEC. Add the following commands near the beginning of the PROFILE EXEC:
    "set autoread off"
    "cp set run on"
    Then add the following command to the end of the PROFILE EXEC of the server machine:
    "exec fileserv start"

    It should be the last record in the PROFILE EXEC.

  5. Resume multiple user mode processing, if you wish, by entering:
    fileserv start
  6. Disconnect from the server machine by entering:
    #cp disc
  7. Log on (or reconnect to) the AUTOLOG1 virtual machine.
  8. Add the following line to the PROFILE EXEC of the AUTOLOG1 machine:
    CP AUTOLOG FPSERV1 password

    In this example, FPSERV1 is the user ID of the server machine. Substitute the password of the server machine for password.

  9. Log off or disconnect from the AUTOLOG1 user ID.

When z/VM is started, the virtual machine AUTOLOG1 is automatically logged on if it exists. When the PROFILE EXEC of AUTOLOG1 processes, the CP AUTOLOG command will log on the server machine. The z/VM system directory entry for a server machine contains an IPL CMS control statement, so CMS is automatically loaded when the server is logged on. Because additional data was not specified on the AUTOLOG command, the first read to the virtual console (the VM READ immediately after IPL CMS) is automatically satisfied. The PROFILE EXEC is then processed. The PROFILE EXEC of the server contains a FILESERV START command, so multiple user mode is immediately started.

Note: Do not specify the AUTOCR initialization parameter for CMS in the server machine's IPL CMS control statement. If AUTOCR is specified, you will not be able to inhibit the execution of the PROFILE EXEC when you log on the server machine to do dedicated maintenance mode work.