How to Install the CA Mainframe Connector for Linux on System z › Start the CA Mainframe Connector for Linux on System z › Configure z/VM Agents

Configure z/VM Agents

After you install the z/VM agent software on the z/OS system, you transfer the software to each target z/VM system and configure the agent. The following list describes the installed software by the members in the dsnpref.CNTL and the SMP/E-installed dsnpref.CE2JOBJ0 data sets. You rename the data set members during the transfer to conform to the z/VM file name file type naming conventions.

dsnpref.CNTL(CAVLUSRi)

Is the z/VM directory for the agent user ID. The member contains the user ID and the allocation parameters for a 191 disk that you specify during setup using the Install Utility. i is the alphanumeric character that is assigned to the associated z/OS region during setup.

CMS file name: agent_user_id

CMS file type: DIRECT

dsnpref.CNTL(CAVLRUNi)

Is the REXX program that runs $UTVM002. The member contains the z/OS region IP address and port number that you specify during the z/OS region setup using the Install Utility. i is the alphanumeric character that is assigned to the associated z/OS region during setup.

CMS file name: CAVLRUNA

CMS file type: EXEC

dsnpref.CE2JOBJ0(CAVLPROF)

Is the profile for the agent user ID.

CMS file name: PROFILE

CMS file type: EXEC

dsnpref.CE2JOBJ0(GENIUCVM)

Is the REXX program that generates the IUCVMSG module.

CMS file name: GENIUCVM

CMS file type: EXEC

dsnpref.CE2JOBJ0(IUCVMSG)

Is the Inter-User Communications Vehicle (IUCV) message handler.

CMS file name: IUCVMSG

CMS file type: TEXT

dsnpref.HL20.CE2JOBJ0($UTVM002)

Is the compiled REXX program that is the agent.

CMS file name: $UTVM002

CMS file type: EXEC

Follow these steps:

1. Define a user ID for the z/VM agent to the z/VM system:
   1. Log on to the user ID responsible for directory maintenance on the target z/VM system.
   2. Transfer the CAVLUSRi data set member to the 191 disk as agent_user_id DIRECT.
   3. Customize the password in the directory.
   4. Add the directory to the z/VM system directory.
   5. Install the changed directory using the DIRECTXA utility.

   A user ID is defined for the agent.

2. Log on to the agent user ID.
3. Transfer the other data set members to the 191 disk for the agent user ID. Use the CMS file names and types that were indicated previously for the target files.

   Important! Transfer the IUCVMSG and $UTVM002 members using the binary data type.

   The agent software is on the z/VM system.

4. Run the GENIUCVM EXEC.

   The IUCVMSG module is generated.