Customization and Postinstallation Steps for CA IPC

To execute sample jobs properly, they must be executed in sequential order by name and number. Review, edit, execute, and complete each installation step before proceeding to the next step.
cadts151
To execute sample jobs properly, they must be executed in sequential order by name and number. Review, edit, execute, and complete each installation step before proceeding to the next step.
Follow these guidelines when installing:
  • SMP/E Installation Phase
    Perform the SMP/E jobs as outlined in Installing Your Product Using CA CSM or Installing Your Product from Pax-ESD.
  • Customization Phase
    Before performing either a new installation or an upgrade, execute the members that have names that start with VQCUS.
  • New Installation Phase
    If you are installing
    CA IPC
    for the first time, execute members whose names start with 
    VQNEW
    . After all VQNEW jobs have executed successfully, the
    CA IPC
    product environment is ready for use.
  • Upgrade
    Installation Phase
    If you are performing an upgrade installation, execute members whose name start with 
    VQUPG
    . When the VQUPG jobs have executed successfully, the upgrade is complete and the
    CA IPC
    product environment is ready for use.
  • Post-installation Phase
    Set up your CICS environment and execute the steps in the installation verification script. When all steps are completed, the
    CA IPC
    components are successfully installed.
This page contains the following topics:
Customize New Installation or Upgrade Installation Jobs
Perform the jobs in this section before performing the steps in either the upgrade or new install sections. You can run these jobs multiple times for as many
CA IPC
environments as needed.
The following list summarizes the steps that are explained in this section.
Step
Description
Purpose
1
Enter and submit the VQCUS00. From CAVQSAMP, perform changes as directed and submit the JCL.
Copy the sample JCL from the target library into the INSTJCL library.
2
Retrieve VQCUS01 from INSTJCL, perform changes as directed, and submit the JCL.
Perform IPC custom assemblies.
3
Retrieve VQCUS02 from INSTJCL, Perform changes as directed, and submit the JCL.
Add the JCL library members.
Step 1. Copy the JCL from Target to INSTJCL Library
This step creates the INSTJCL library and copies the new and upgrade JCL from the target library to the INSTJCL library. After you complete this step, you can perform any mass edits to the JCL using the $DCOMEDT macro.
  1. Retrieve member VQCUS00 from your CAVQSAMP library.
  2. Make all required global changes that are shown in the instruction block of the member or use $DCVQEDT.
    Do
    not
    save this member in the CAVQSAMP library.
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion.
Step 2. Prepare Product Custom Assemblies
The custom assemblies, SC00TRAN and SC00OPTS, are required for the Session Control Facility (SCF) and are prepared using this step.
  1. Retrieve member VQCUS01 from your INSTJCL PDS.
  2. Make the required global changes (see the instruction block) or use $DCVQEDT.
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion.
For instructions to modify the SCF options in this step for your site, see How to Set SCF Site and Session Options.
Step 3. Add JCL Library Members
This step executes IEBUPDTE to add the customized JCL library members to the CUSPROC library for
CA IPC
.
  1. Retrieve member VQCUS02 from your INSTJCL PDS.
  2. Make the required global changes (see the instruction block) or use $DCVQEDT.
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion.
Be sure to review, edit, run, and complete this step before you continue your installation.
Note regarding PSSUTIL cataloged in VQCUS02:
To use the
CA Ideal™ for CA Datacom®
PRINT command to direct output to DESTINATION SYSTEM LOCAL:
Catalog a PSS (Print SubSystem) procedure to execute program SCPSUTIL with the corresponding
CA IPC
15.0 ADRPNL and ADROUT files. The PSS procedure name is specified in
CA Ideal™ for CA Datacom®
from the SET OUT SITE screen. The
CA Ideal™ for CA Datacom®
JOBCARD must specify the PROCLIB where the PSS procedure has been cataloged.
New Installation Phase
If you are upgrading, see the Upgrade Installation Phase information at the beginning of this topic to continue your installation.
The procedures required for a new installation 
only
 are detailed in this section. Perform these steps after completing the required steps for all installations. Run the INSTJCL PDS members whose names start with 
VQNEW
 for this phase of the installation.
The following list summarizes the steps that are involved in the
CA IPC
installation process for a new installation only.
Step
Description
Purpose
1
Retrieve VQNEW01 from INSTJCL, perform changes as directed, and submit the JCL.
Allocate, format, and initialize new
CA IPC
ADRPNL and ADRLIB for VLS.
Step 1. Allocate/Format/Load
CA IPC
Libraries and Files
Allocate, format, and initialize the
CA IPC
VLS files ADRPNL and ADRLIB and the data sets ADROUT and ADRTRC.
  1. Retrieve member VQNEW01 from your INSTJCL PDS.
  2. Make the required global changes (see the instruction block) or use $DCVQEDT.
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion.
Be sure you review, edit, run, and complete this step before continuing.
Upgrade Installation Phase
If you are not upgrading, skip this section.
The required steps for upgrade installations 
only
 are covered in this section. Perform these steps after completing the steps required by all installations.
Run the INSTJCL PDS members whose names start with VQUPG for this phase of installation.
The following list summarizes the steps involved in the
CA IPC
installation process for an upgrade installation only. Review this list before attempting an installation with this product.
Step
Description
Purpose
1
Retrieve VQUPG01 from INSTJCL, perform changes as directed, and submit the JCL.
Format and initialize the ADRPNL, ADRLIB, ADROUT, and ADRTRC.
Step 1. Format/Initialize the ADRPNL, ADRLIB, ADROUT, and ADRTRC data sets
Allocate, format, and initialize the
CA IPC
VLS files ADRPNL and ADRLIB and the data sets ADROUT and ADRTRC.
Because ADRLIB contains user jobcards and other site-specific members, allocate the ADRLIB for this release with the same SPACE requirements as your previous version ADRLIB.
  1. Retrieve member VQUPG01 from your INSTJCL PDS.
  2. Make the required global changes (see the instruction block) or use $DCVQEDT.
  3. Submit the JCL to complete this step.
  4. Review the output for successful completion.
Post-Installation Steps
Perform the following steps after you have installed
CA IPC
.
Step 1. CICS Modifications
Include a DD statement for the
CA IPC
Custom Load Library (CUSLIB) and the
CA IPC
Target Load Library (CAVQLOAD) in the DFHRPL concatenation of the CICS Startup JCL.
To ensure that the correct code is accessed, concatenate the
CA IPC
CAVQLOAD before the CA Common Services target load library in the DFHRPL of the CICS startup JCL.
CICS requires the addition of DD statements for the
CA IPC
files. The
CA IPC
installation creates these statements for you. Fetch the IPCFILE member from the Custom Macro Library (CUSMAC) and insert it into the CICS startup JCL.
The
CA IPC
installation also produces all source members for CICS table modification. These source members are in the CAVQSAMP library and contain all the CICS table entries required.
For those sites using an existing CICS that already uses an earlier release of
CA IPC
, replace the CICS groups for the earlier version. Using the chart that is provided in the following CICS Source Copybooks, replace all references to the previous copybooks. Then reassemble and relink your CICS table DFHFCTxx and add the new CICS groups to your DFHCSD.
Although it is included for illustration only, use the VQCICS JCL member in the INSTJCL library to define programs, transactions, and files for CICS Transaction Services.
CICS Source Copybooks
The source copybooks for each
CA IPC
component are in the target sample library (CAVQSAMP) for all CICS tables and CSD definitions. Using these copybooks, you can update your CICS using site-standard jobs instead of running the installation jobs. To update your CSD for transactions and programs and to prepare the File Control Table (FCT), retrieve the CICS copybooks. Verify these copybooks to verify that they meet your site requirements.
The following list identifies the library members by component:
Component
RDO Entries
MRO RDO Entries
FCT
 
VQ15CSD
VQ15CSDT
VQ15FCT
Step 2. Perform Verification
After completing the steps to install or upgrade
CA IPC
, perform the following to verify that
CA IPC
is installed properly.
Press the Clear key to return to the main menu.
  1. Sign on to CICS.
  2. From native CICS, enter:
    IPCV
    Press Enter to access the
    CA IPC
    sign-on screen. No password is needed for sign-on.
    If
    CA IPC
    is installed properly, the 
    CA IPC
     Main Menu appears.
  3. Enter the following command to exit from
    CA IPC
    and return to CICS.
    OFF
Activate 
CA IPC
for
CA Auditor
z/OS Support
For
CA IPC
to be fully auditable by
CA Auditor
, it is necessary to have a specific load module available in the LPA. The CAIXBW5$ module is provided in the CAVQLPA library for this purpose. If you are using the
CA IPC
CAIXBW5$ module, it must reside in the currently active LPA. You can do this in one of two ways:
  1. APF authorize the CAVQLPA library and add it to the LPA.
  2. Copy the CAIXBW5$ module into an APF Authorized library already in the LPA.
See the
CA Auditor
documentation for more information about using the product.