Installing the z/VM System Console facility

The following procedure describes how to install the BMC AMI Defender for z/VM System Console facility.

Before you begin

Before uploading the installation material to the z/VM system, ensure that the following utilities are installed:

  • VMARC
    To obtain the VMARC package and installation instructions, go to www.vm.ibm.com/download/.

  • REXX package or runtime library

To install the BMC AMI Defender for z/VM System Console facility

  1. Download the installation material to your workstation.

  2. Upload the material to the z/VM system.

    Note

    You must upload and install the VMARC file as a binary file with a fixed format and 80-byte records.

    The following example illustrates how to use FTP to send the material to the MAINT 191 minidisk.

    The following is a sample FTP session initiated from a Microsoft Windows command prompt to the virtual machine. The parts marked with <---ENTER indicate information that you must enter.

    ----------------------------------------------------------------
    C:\CORREL>FTP 10.100.0.235 <-------------------------------ENTER
    Connected to 10.100.0.235
    220-FTPSERV IBM VM Level 630 at Z63PRD01, 10:50:26 EDT MONDAY 2017-05-16
    220 Connect will close it idle for more than 5 minutes
    User (10.100.0.235:(none)): maint/by/username  <----------ENTER
    331 Send passwords please.
    Password:      <------------------------------------------ENTER
    230 MAINT logged in: working directory = MAINT 191
    ftp> bin  <-----------------------------------------------ENTER
    200 Representaion type IMAGE.
    ftp> quote site fix 80 <----------------------------------ENTER
    200 Site command was accepted.
    ftp> put vmconsol.vmarc <---------------------------------ENTER
    200 Port request OK.
    150 Storing file 'vmconsol.vmarc'
    250 Transter completed successfully
    ftp: 11920 bytes sent in 0.12Seconds 102.76bytes/sec
    ftp> quit <-----------------------------------------------ENTER
    Quit command received. Goodbye.
    ----------------------------------------------------------------

  3. Issue the FORCE OPERATOR command to shut down the OPERATOR virtual machine.
  4. Use VMARC to load the materials onto the OPERATOR 0191 minidisk.
  5. Set up OPERATOR on the system:

    • If OPERATOR is already set up on this system, run the following commands. The parts marked with <---ENTER indicate information that you must enter.

      ----------------------------------------------------------------
      link operator 191 1 mr <-------------------------------ENTER
      Ready; t=0.01/0.01 12:25:48
      access 1 c <-------------------------------------------ENTER
      Ready; t=0.01/0.01 12:25:58
      copyfile profile exec c = exec-ibm = (olddate <--------ENTER
      Ready; t=0.01/0.01 12:26:10
      vmarc unpk vmconsol vmarc a = = c ( replace <----------ENTER
      PROFILE EXEC C1. Bytes in= 122, bytes out= 323 ( 200%)
      OPERATOR SPARMS C1. Bytes in= 160, bytes out= 453 ( 282%)
      OPERATOR EXEC C1. Bytes in= 9160, bytes out= 453 ( 283%)
      CZAUME TEXT C1. Bytes in= 2400, bytes out= 3600 ( 150%)
      Ready; t=0.01/0.01 12:26:37
      ----------------------------------------------------------------

    • If OPERATOR is not already set up on the system, run the following commands. The parts marked with <---ENTER indicate information that you must enter.

      ----------------------------------------------------------------
      link operator 191 1 mr <----------------------------ENTER
      Ready; t=0.01/0.01 12:25:48
      access 1 c <----------------------------------------ENTER
      Ready; t=0.01/0.01 12:25:58
      vmarc unpk vmconsol vmarc a = = c <-----------------ENTER
      PROFILE EXEC C1. Bytes in= 122, bytes out= 323 ( 200%)
      OPERATOR SPARMS C1. Bytes in= 160, bytes out= 453 ( 282%)
      OPERATOR EXEC C1. Bytes in= 9160, bytes out= 453 ( 283%)
      CZAUME TEXT C1. Bytes in= 2400, bytes out= 3600 ( 150%)
      Ready; t=0.01/0.01 12:26:37
      ----------------------------------------------------------------

  6. Copy the sample parameter file as shown in the following example:

    copyfile operator   sparms   c  =  parms c           
    Ready; t=0.01/0.01 12:31:58

  7. Configure the sever parameter file.

    Using XEDIT, update the OPERATOR PARMS file. Values for the following statements must be present in the file:

    Statement              

    Value

    server_ip

    IP address in dotted decimal notation

    server_port

    Port number greater than 1024

    The following statements are optional:

    Statement

    Value

    wait_time

    Time to wait between RACF SMF SWITCH commands

    The value must be a whole number from 1 through 3600 seconds.

    The default value is 30 seconds.

    If you enter an invalid value, the default value is used.

    auth_user

    Valid virtual machine user ID

    The default value is MAINT.

    *

    Comment

    The following code is an example of the OPERATOR PARMS file:

    server_ip 127.0.0.1
    server_port  8182
    wait_time  15
    auth_user maint

    This example sets the following values:

    • The IP address of the server is 127.0.0.1.
    • The listening port is 8192 (2000x).
    • The wait time is 15 seconds between the RACF SMF SWITCH commands and the virtual machine CORREL is an authorized user

    You can issue commands to change the timer interval and stop the machine.


  8. Release and detach the C disk by using a release c (detach command.

    ----------------------------------------------------------------
    release c (detach                                   
    DASD 0001
    DETACHED
    Ready; t=0.01/0.01 12:36:05
    ----------------------------------------------------------------

  9. Start OPERATOR with an xautolog operator ipl cms command.

    ----------------------------------------------------------------
    xautolog operator ipl cms
      ICH70001I OPERATOR LAST ACCESS AT 10:45:03 ON
    MONDAY, JULY 2, 2018
    Command accepted
    Ready; T=0.01/0.01 12:23:06
    AUTO LOGON  ***       OPERATOR USERS = 20
    HCPCLS6056I XAUTOLOG information for OPERATOR: The IPL command is verified by the IPL
    command processor.
    ----------------------------------------------------------------

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*