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 of the following 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 build 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.

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

Note: Full support of zCMS started with z/VM 6.2.0. For information about generating a zCMS operating system, please see the appropriate IBM manual.

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

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

   You are transferred to the appropriate panel, based on your operating system.

2. Access another terminal, and log on to your CMS system maintenance machine.
3. Issue the CAKVBLD command to rebuild the CMS nucleus.

   The general format of the command is as follows:

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

   prodid

   Specifies 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 PPF 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 PPF filename for the product. ITASK uses this default filename when it executes the VMFBLD command. Select the appropriate prodid value for your z/VM release as follows:

   • For z/VM 6.3.0, use SERVP2P.
   • For all other z/VM releases, use ZVM.

   compname

   Specifies 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

   (Optional) Specifies the build list name, as in the VMFBLD command. Typically, for CMS, the default CMSLOAD is used.

   Important! To build the zCMS operating system (z/VM R6.2.0 and above), you must supply the ZCMSLOAD as the buildlist parameter.

   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 cannot specify TEST.

   vmfbld_options

   Specifies any options valid for the VMFBLD command. The specified options 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 performs the following activities:

   • Links to the CA-Activator Test System minidisk or the Production Generation minidisk, according to your specification.
   • Reads your PPF file, your PPF override file, and the base PPF. Then it generates a temporary PPF override file called $CAKVCMS $PPF. Your original PPF 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 PPF 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 PPF 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.

   Note: Usually the CMS and zCMS build process punches the output (which is usually spooled to a reader). IPLing from the reader will cause the process to want to write to the boot sector of the appropriate disk (190 – CMS and 990 – zCMS). Make sure the appropriate disk is linked WRITE for this function.

   We recommend saving the load maps of the newly created CMS systems for diagnostic purposes later.

4. Reconnect if necessary, and from panel KVC0‑I104, press F2 to finish the task.
5. Press F3.