Installing from Pax Files Using Pax ESD or DVD › Prepare the SMP/E Environment for a Pax Installation

Prepare the SMP/E Environment for a Pax Installation

The members in this procedure prepare the SMP/E data sets, initialize the zones, and create the DDDEFs for CA Common Services for z/OS. External DDDEF data sets are required. For information about the members, see the comments in the JCL.

The following steps describe the process to install products using native SMP/E JCL:

1. Download external HOLDDATA.
2. Allocate product data sets and SMP/E data sets.
3. Create SMP/E CSI or use the existing CA Common Services v14.0 CSI. If you are applying CA Common Services v14.0 maintenance while upgrading your systems to r14.1, then create an SMP/E CSI for the new Base and Optional CA Common Services r14.1 installation.
4. Receive base functions and HOLDDATA.

   Complete the SMP/E RECEIVE using files on DASD that the UNZIPJCL job created. Consult the product sample JCL library that contains a sample that is customized to receive the product from DASD. Specify the following values:

   • DASD data set names for SMPPTFIN and SMPHOLD (if applicable).
   • The HLQ that you used in the UNZIPJCL job on the RFPREFIX parameter on the RECEIVE command.
5. Download and RECEIVE PTFs from http://ca.com/support.
6. Run an SMP/E APPLY CHECK operation.
7. Apply base functions using SELECT GROUPEXTEND.
8. Run an SMP/E ACCEPT CHECK operation.
9. Accept base functions using SELECT GROUPEXTEND.
10. Configure the product according to your site requirements.

Installation Notes:

• When you install Agent Technology, Event Management, or the version of Tomcat that is shipped with CA Common Services, establish a USS hierarchical file system first as part of the product installation. USS is a required feature for installing CA CSM Common Services.
• The CA Common Services software components are packaged using four pax files. Consider installing all the components at once as opposed to repeating this procedure for each Common Services component or pax file.
• You do not have to reinstall existing installations of CA Common Services v14.0 Legacy Common Services, or Mainframe CA NSM Common Services. These two pax files have not changed so you can continue to use the CA Common Services v14.0 SMP environment you established for Legacy Common Services or Mainframe CA NSM Common Services.
• The BASE pax file contains the SAMPJCL data set to install all the CA Common Services components. If you perform multiple installations, make copies of the BASE SAMPJCL data set for each installation before you edit any of the members.
• Install all Base and Optional CA Common Services components into the same SMP/E CSI.
• Install all the CA Common Services components found in the BASE pax file.

Follow these steps:

1. Customize the ISPF Edit macro, AW0SEDIT found in the SAMPJCL data set unzipped from the BASE pax file with your site-specific information. Then copy it to your SYSPROC location.

   To customize member AW0SEDIT, replace the right-most parameters for each ISREDIT CHANGE macro command with your site-specific information.

   Each time that you edit an installation member, type AW0SEDIT on the TSO command line, and press Enter to replace the defaults with your specifications.

   The macro is ready to customize the SAMPJCL members.

   Important! Install all Base and Optional CA Common Services components into the same CSI and zones. If you decide to perform multiple installations for each CA Common Services component or pax file, the “change to” values for GLOBALHLQ and CAIT0HLQ must be the same for each installation.

   Note: Update the SREDIT Change command for DASDHLQ. Replace CAI to the same value you specified as yourHLQ in the UNZIPJCL file for the pax file. This value is used in the SMP/E receive processing.

   If you install CA Common Services components from multiple pax files with a different value for yourHLQ in each UNZIPJCL pax file, perform the SMP/E receive for each yourHLQ.

   Update

   ISREDIT CHANGE ALL DASDHLQ     CAI
   

   to

   ISREDIT CHANGE ALL DASDHLQ    yourHLQ
   

   The following steps include instructions to execute the AW0SEDIT macro each time you open a new SAMPJCL member. To edit all SAMPJCL members simultaneously, read and follow the instructions in the AW0EDALL member.

2. Open the SAMPJCL member AW01ALL in an edit session and execute the AW0SEDIT macro from the command line.
3. Submit AW01ALL.

   The job produces the following results:

   • The target and distribution data sets for the BASE and OPTIONAL CA Common Services components are created.
4. Complete the following substeps for each pax file that contains components you want to install.

   xxx represents the following three-character codes:

   CCS - LEGACY components

   NSM - MFNSM components

   1. Open the SAMPJCL member xxx1ALL in an edit session and execute the AW0SEDIT macro from the command line.

      xxx1ALL is customized.
      

   2. Submit xxx1ALL.

   These jobs produce the following results:

   • The target and distribution data sets for LEGACY and MFNSM CA Common Services components are created.
5. If you install Agent Technology, Event Management, or the version of Tomcat that is shipped with CA Common Services, complete the following substeps for each of these products. Instances of ccc in this step represent the following three-character FMID-based component codes:

   B6D - MFNSM - Agent Technology

   D5I - MFNSM - Event Management

   EG1 - OPTIONAL - Tomcat

   1. (For the Agent Technology installations only). If the group AWGROUP has never been defined on your system, update SAMPJCL member B6D1ALLU. Ensure that the format of the zFS file does not include -group AWGROUP. This update is required for the RO and RW zFS files. The JCL appears as follows:

         //FMTRW EXEC PGM=IOEAGFMT,REGION=0M,
         // PARM=('-aggregate &CAI..RW.CB6DZFS -compat')
      

   2. Open the SAMPJCL member ccc1ALLU in an edit session and execute the AW0SEDIT macro from the command line.

      ccc1ALLU is customized.

   3. Submit ccc1ALLU.

      This job allocates your zFS data sets.

   4. Open the SAMPJCL member ccc2MKD in an edit session and execute the AW0SEDIT macro from the command line.

      ccc2MKD is customized.

   5. Submit ccc2MKD.

      This job creates all directories and mounts the file system.

6. Install all CA Common Services components into the same SMP/E CSI. This JCL creates the CSI for all CA Common Services components. Open the SAMPJCL member AW02CSI in an edit session and execute the AW0SEDIT macro from the command line.

   AW02CSI is customized.

7. Submit AW02CSI.

   This job produces the following results:

   • The CSI data set is defined.
   • Unique SMPLTS, SMPMTS, SMPSCDS, and SMPSTS data sets for this target zone are created.
   • The SMPPTS and SMPLOG data sets are allocated.
   • The global, target, and distribution zones are initialized.
   • The DDDEFs for the required SMP/E data sets are created.
8. Complete the following substeps for each pax file that contains components you want to install: xxx represents the following three-character codes.
   • AW0 – BASE and OPTIONAL component DDDEFs
   • CCS - LEGACY components DDDEFs
   • NSM - MFNSM components DDDEFs
   1. Open the SAMPJCL member xxx2CSID in an edit session and execute the AW0SEDIT macro from the command line.

      xxx2CSID is customized.

   2. Submit xxx2CSID.

      These jobs produce the following results:

      • The DDDEF entries for CA Common Services component data sets are created.
9. If you install Agent Technology, Event Management, or the version of Tomcat that is shipped with CA Common Services, complete the following substeps for each of these products you install.
   1. Open the SAMPJCL member ccc3CSIU in an edit session and execute the AW0SEDIT macro from the command line.

      ccc3CSIU is customized.

      Note: All instances of ccc in this section indicate a three-character FMID-based component code.

   2. Submit ccc3CSIU.

      This job customizes the CSI by adding the DDDEFs associated with the USS target paths.

Important! Only install CA Common Services components into the existing CA Common Services SMP/E environment using the same zone names (defaults are CAIT and CAID). Do not later install any of the following software into these same zones: CA Chorus, CMDB Connector, NetMaster, OPS/MVS WebCenter, or SOLVE.