Generating the Test System › Task KVC0I099—Generate CMS Nucleus

Task KVC0I099—Generate CMS Nucleus

Use this task to update your current CMS nucleus load list with CA Top Secret CMS modules.

This task consists the panels:

• KVC0‑I099—Generate CMS Nucleus
• KVC0‑I104—Generate CMS Nucleus Enhanced

To build the required CA Top Secret modules into the CMS nucleus, the system load list must be modified. In addition, the most current version of these modules must be accessible to the z/VM service EXECs during the build.

To accomplish this in the enhanced z/VM maintenance structure, the CAKVBLD command creates a temporary, updated copy of the system build list and a temporary Product Parameter File (PPF) override file. CAKVBLD passes these files to the standard z/VM service routine to build the nucleus. (Use panels KVC0‑I099 and KVC0‑I104.)

The system generation method invoked by this task is dependent on the operating system selected for generating CA Top Secret.

To update your current CMS nucleus load list with CA Top Secret CMS modules

1. From the Task Selection Menu, select panel KVC0‑I099.

   This panel does not appear. You are transferred to the appropriate panel based on your operating system that lists instructions which must be followed to generate the CMS system.

2. Access another terminal to complete the following steps.
3. Log on to your CMS system maintenance machine.
4. Issue the CAKVBLD command to rebuild the CMS nucleus. The general format of the command is:

   CAKVBLD prodid compname <buildlist> (TEST|PROD <vmfbld_opts>
   

   prodid

   Is the filename of the Product Parameter File (PPF) normally used to build your CMS system. If you are accustomed to using the VMFBLD command to build your CMS nucleus, use the same prodid or PF for this parameter as you would specify in the VMFBLD command. You may specify an override file here, if applicable.

   If you have previously used the ITASK command to build the CMS nucleus, you should specify the z/VM product number that is the default PF filename for the product. ITASK uses this default filename when it executes the VMFBLD command. Select the appropriate product number for your z/VM release as shown following.

   • z/VM R5.2.0 ZVM
   • z/VM R5.3.0 ZVM
   • z/VM R5.4.0 ZVM
   • z/VM R6.1.0 ZVM
   • z/VM R6.2.0 ZVM

   compname

   Is the component name you usually specify when building your CMS system. You can specify an override component such as CMSOPT. Note that the component name specified here must exactly match those used to generate your CMS system without CA Top Secret as well as the PF filename and build list.

   buildlist

   Is the optional specification of build list name, as in the VMFBLD command.

   TEST

   Indicates that the Test System is generated. If specified, you cannot specify PROD.

   PROD

   Indicates that the Production System is generated. If specified, you can not specify TEST.

   vmfbld_opts

   Any options valid for the VMFBLD command may be specified here. They are passed to VMFBLD when this command is executed.

   Note: The CAKVBLD command supersedes the VMFBLD or ITASK build step in the z/VM installation procedures. You must, however, complete the remaining procedures.

   Issuing CAKVBLD does the following:

   • Links to the CA-Activator Test System minidisk or the Production Generation minidisk, according to your specification.
   • CAKVBLD reads your PF file, your PF override file and the base PPF. Then it generates a temporary PF override file called $CAKVCMS $PPF. Your original PF files are not modified. This temporary override file is used to generate your CMS nucleus.
   • The temporary override file contains new definitions that supplement your base PF CMS component to include a new local disk (the CA-Activator Test or Production Generation minidisk) and to define the temporary build list ($CAKVCMS EXEC). If your original CMS component was an override component, it is included in its entirety in the temporary PPF, in addition to the above changes.
   • Invokes VMFSETUP to establish the proper disk search order as follows:

     	VMFSETUP $CAKVCMS compname ( ACCESS BLD
     

   • Creates a temporary build list, $CAKVCMS, by adding CA Top Secret modules to your original build list.
   • Invokes VMFBLD to build the nucleus using the temporary PF and build list. The VMFBLD command will include any vmfbld_opts you specified in the CAKVBLD command.
   • The CA Top Secret generated temporary files are not erased, so you can inspect them in case of build errors.
5. Reconnect if necessary, and from panel KVC0‑I104, press F2.
6. Press F3.