Maintain Products Using CSM

Use the procedures in this topic to receive, apply, and accept maintenance for your products using CSM.
CA CSM
provides a product list that lets you display the list of licensed product maintenance packages and to download these packages. You can also manage external maintenance packages that were acquired outside of
CA CSM
so that they can be applied using
CA CSM
.
During your initial product installation, apply all product maintenance. Otherwise, you may have to repeat the deployment and configuration processes.
The following diagram shows the maintenance process using
CA CSM
:
This image shows the workflow for a systems programmer to acquire and install product maintenance using CA CSM. This process starts with the step to configure the automatic download of HOLDDATA and ends with the ACCEPT step.
After you complete this process, the maintenance packages for your products are accepted.
You have deployed and configured a product across your enterprise. Now you are applying maintenance to this product. Create a deployment and a configuration for this product to get this maintenance to your target systems.

Configure Automatic HOLDDATA Download

You can configure
CA CSM
to download automatically the available HOLDDATA that it uses for each maintenance installation. You then have current information about what maintenance packages are marked as PE (PTF in Error).
  1. Select the
    Settings
    tab, and select the
    Software Catalog
    link under
    System Settings
    in the
    Settings
    section on the left side.
  2. In the
    HOLDDATA Settings
    section, select the
    Enable Automatic Updates
    checkbox.
  3. Set up values for the following fields, and select
    Apply
    :
    • Owner of Update Task
      Specifies the TSO user ID under which the update task is run.
    • Recurrence
      Specifies how often the task recurs.
    • Update Software Catalog Every
      number of
      Days
      or
      Update Software Catalog On
      day of week
      Every
      number of
      Weeks
      Specifies the frequency of downloading HOLDDATA to your software catalog, in days or weeks, depending on the value the
      Recurrence
      field.
      Example
      : Imagine you set the recurrence for a specific number of days and you set the time that precedes the current time. Then the first update occurs in the specified number of days at the specified time. For example, on Monday at 10.30 am, you set the number of days to 3 and time to 07.00. The first update then occurs on the third day, Thursday, at 7.00 am. When you set the time past the current time, the first update occurs on the same day at the time set. For example, on Monday at 10.30 am, you set the number of days to 3 and time to 11.00. The first update then occurs on that Monday at 11.00 am.
    • System Time
      Specifies the system time when an automatic update occurs. The system time reflects your
      CA CSM
      application server time zone. The TZ parameter within Tomcat startup libraries defines the time zone. If the TZ parameter is not defined, the
      CA CSM
      application server time zone defaults to GMT - Greenwich Mean Time.
      Local time is calculated based on the system time that you set.
    To download available HOLDDATA to the software catalog immediately, select
    Update Immediately
    .
    The automatic HOLDDATA download is configured.

Configure
CA CSM
to Reject Unneeded Maintenance from the SMP/E Environment

During the regular, FIXCAT, or
maintenance wizard execution,
CA CSM
may receive maintenance. Some maintenance packages may not be directly associated with the maintenance that you want to apply.
You can configure
CA CSM
to reject the maintenance that was received but not applied during the wizard execution.
  • If you exit the wizard before the maintenance installation started,
    CA CSM
    rejects the maintenance that has been received during the wizard execution. The SMP/E environment is restored to the state that it had before you started the wizard.
  • If you navigated through the wizard steps, started the maintenance installation task, and the task completed successfully,
    CA CSM
    rejects the received but not applied maintenance that is not directly associated with the maintenance that you have applied.
This process ensures that your SMP/E environments do not contain unneeded received maintenance.
  1. Select the
    Settings
    tab, and select the
    Software Installation
    link under
    System Settings
    on the left side.
  2. In the
    Maintenance Installation
    section, select the
    Reject Received Maintenance
    checkbox.
  3. Select
    Apply
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
    While a task is in progress, you can perform other work. Select
    Hide
    to exit the dialog and view the task status later on the
    Tasks
    tab.
    CA CSM
    is configured to reject unneeded maintenance.

Download Product Maintenance Packages

You can download maintenance packages for installed products through the
Products
tab. You can download:
  • All maintenance packages for a product
  • Only maintenance packages that have been released from the time the product release was updated last
The information for HIPERs and new maintenance on the Software
Status tab
is based on the current information in your software catalog. Update the product list on a daily or weekly basis to keep it current.
You can also download maintenance using the
. This option uses the IBM SMP/E RECEIVE ORDER command to download
mainframe product maintenance over the Internet, by securely submitting an order for PTFs and HOLDDATA to a remote
server. This service eliminates the manual steps that are required to download maintenance from
Broadcom
. The orders are fulfilled based on the status of your SMP/E environments. Based on your order criteria, all PTFs and their requisites are downloaded automatically and received to your system.
To use this download option, complete the procedures to configure the
as described in the Mainframe Common Maintenance Procedures documentation. After you set up this service, you can use
CA CSM
to apply and accept your maintenance.
  1. Verify that your
    CA CSM
    login user name is associated with a registered user of
    Broadcom
    on the
    Software Acquisition Settings
    page.
    CA CSM
    uses the credentials to access
    Broadcom
    .
  2. Select the name of the product for which you want to download maintenance in the product list on the left side.
    Maintenance information about the product appears in the Releases section on the right side.
  3. For the product release for which you want to download maintenance, select the
    Actions
    drop-down list to the right of the release. Complete
    one
    of the following steps:
    • Select
      Update Product Release
      to download all maintenance packages for the product release.
    • Select
      Get Latest Maintenance
      to download only maintenance packages that have been released from the time the product release was updated last.
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the Progress tab to close this dialog. The task output browser opens, and you can view the action details.
The maintenance packages are downloaded.

Configure
CA CSM
to Perform Automatic Maintenance Updates

You can configure
CA CSM
to perform automatic maintenance updates (downloading and receiving maintenance) for products that are installed in an SMP/E environment.

Manage Maintenance Downloaded Outside of
CA CSM

Sometimes you acquire maintenance packages, such as unpublished maintenance, PTF, APARs, and USERMODs, outside of
CA CSM
. For example, you are validating a test PTF released for a product. You can add information about these maintenance packages to
CA CSM
from the Products tab.
Adding these maintenance packages to
CA CSM
provides you with a complete view of all the maintenance for a product release. After a package is migrated, you can use
CA CSM
to apply the maintenance.
Usually, the maintenance is placed as a single package. However, some
mainframe products still have older aggregated maintenance packages that were released before December 31, 2013. An
aggregated package
is a file that comprises several single maintenance packages (nested packages). When you add an aggregated package,
CA CSM
inserts all the nested packages and the aggregated package itself. In the list of maintenance packages, the aggregated package is marked with the CUMULATIVE type.
When you insert an aggregated package,
CA CSM
assigns a fix number to it. The fix number is unique and contains eight characters. The first two characters are AM (for Aggregated Maintenance) and a unique six-digit number follows. The number value increases by 1 with each added aggregated package.
If the aggregated maintenance package has the same fix number as one of its nested packages, only the nested package is added. The aggregated package itself is not available in the list of maintenance packages.
  1. Select the
    Products
    tab, and select the product release for which the maintenance applies.
  2. Select the
    Add External Maintenance
    button.
  3. Specify one of the following package types and package details:
    • Data Set
      Adds a maintenance package that is located in a z/OS data set with an LRECL of 80 and RECFM of FB.
    • UNIX File
      Adds a maintenance package that is located in a USS directory in binary mode.
    • FTP File
      Adds a maintenance package that is not published on
      Broadcom
      . This option is intended for downloading a PTF to validate it.
      • FTP Host
        Specifies the FTP server where the maintenance package is located. Select a server from the list, or provide your FTP server host.
      • FTP Port
        Specifies the FTP port number for the FTP server.
      • FTP Path
        Defines the FTP path where the maintenance package is located. Start the path with a forward slash (/). Enter only a forward slash to specify the root directory.
        Example:
        /outgoing/
      • Maintenance Name
        Defines the maintenance package name.
        Example:
        RO01111.bin
      • User Name
        Defines a valid user name to access the FTP location.
      • Password
        Defines a valid password to access the FTP location.
    • Solution
      Adds a published solution on
      Broadcom
      .
    To add several data sets or UNIX file packages from the same location, use masking.
  4. Select
    OK
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
The maintenance package with the related information is saved in the
CA CSM
database. To see the added package, refresh the page.

View Aggregated Package Details

You can view which nested packages are included in the aggregated package. The information includes the fix number, package type, and package description.
Aggregated maintenance packages were discontinued December 31, 2013. However, some
mainframe products have aggregated maintenance packages that were released before this date.
  1. Select the
    Products
    tab, and select the product release that has the aggregated package whose details you want to view.
  2. Select the
    Fix #
    link for the aggregated package.
    The Maintenance Package Details dialog opens.
  3. Select the
    Nested Packages
    tab.
    A list of nested packages that the aggregated package contains appears.

Receive Maintenance

After maintenance has been downloaded for a product, you can receive the maintenance to the global zone of an SMP/E environment where the related products are installed. Once received, maintenance packages can be applied.
While you work with an SMP/E environment, the environment is locked and other
CA CSM
users cannot perform any action against it. When the task finishes, logging out from
CA CSM
, or a
CA CSM
session is inactive for more than 10 minutes, the lock releases.
  1. Select the
    SMP/E Environments
    tab, and select the SMP/E environment where you want to receive maintenance packages.
  2. Select
    Maintenance
    . If you do not see any maintenance packages, verify that you have maintenance view criteria defined.
  3. Select the maintenance packages that you want to receive, and select the Receive link.
    The maintenance wizard opens to the Introduction step.
    If you select an SMP/E environment being used in
    CA CSM
    by another user, a notification message appears. You are prevented from performing any actions on the SMP/E environment. Wait until the notification message disappears and the SMP/E environment becomes available, or select Cancel to select another SMP/E environment.
  4. Review the information about the receiving, and select
    Next
    .
  5. Review and adjust the receive list selections as required, and select
    Next
    .
  6. Review the summary, and select
    Receive
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
The maintenance packages are received to the SMP/E environment global zone.

Reject Maintenance

You can reject a received maintenance package. Information about the maintenance package is removed from the SMP/E environment global zone.
While you work with an SMP/E environment, the environment is locked and other
CA CSM
users cannot perform any action against it. When the task finishes, logging out from
CA CSM
, or a
CA CSM
session is inactive for more than 10 minutes, the lock releases.
  1. Select the
    SMP/E Environments
    tab, and select the SMP/E environment from which you want to reject maintenance.
  2. Select
    Maintenance
    . If you do not see any maintenance packages, verify that you have maintenance view criteria defined.
  3. Select the maintenance packages that you want to reject, and select the
    Reject
    link. You can filter out only received packages.
    The maintenance wizard opens to the Introduction step.
    If you select an SMP/E environment being used in
    CA CSM
    by another user, a notification message appears. You are prevented from performing any actions on the SMP/E environment. Wait until the notification message disappears and the SMP/E environment becomes available, or select Cancel to select another SMP/E environment.
  4. Review the information about the rejection, and select
    Next
    .
  5. Review and adjust the rejected list selections as required, and select
    Next
    .
  6. Review the summary, and select
    Reject
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
The maintenance packages are rejected. Information about the maintenance packages is removed from the SMP/E environment global zone.

Apply Maintenance

After maintenance has been downloaded for a product, you can apply the maintenance to products that are installed in an SMP/E environment.
Before you apply maintenance, ensure that required file systems are mounted and that you have specified the correct path to the DDDEFs that are contained in the file systems. The path must be the mount point of the zFS file system, plus the directory /CA. For example, if the zFS file system is mounted at /broadcom/abc, the DDDEF path must be /broadcom/abc/CA.
As an option,
CA CSM
lets you verify that the maintenance packages can be applied to the selected target zones without applying the packages.
While you work with an SMP/E environment, the SMP/E environment is locked and other
CA CSM
users cannot perform any action against it. When the task finishes, logging out from
CA CSM
, or a
CA CSM
session is inactive for more than 10 minutes, the lock releases.
  1. Select the
    SMP/E Environments
    tab, and select the SMP/E environment whose products you want to apply maintenance to.
  2. Select
    Maintenance
    . If you do not see any maintenance packages, verify that you have maintenance view criteria defined.
  3. Select the maintenance packages that you want to apply, and select the
    Apply
    link.
    If you select an SMP/E environment being used in
    CA CSM
    by another user, a notification message appears. You are prevented from performing any actions on the SMP/E environment. Wait until the notification message disappears and the SMP/E environment becomes available, or select Cancel to select another SMP/E environment.
  4. Follow the instructions on the wizard to navigate through the wizard steps.
  5. From the
    Summary
    step, review the summary, and select
    Check and Apply
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
CA CSM
verifies and applies the maintenance packages to the selected target zones.
If the task fails, navigate to the Tasks tab and review SMPOUT in the task output to identify and correct problems. Rerun the wizard.
You have completed acquiring and applying maintenance. You can accept the applied maintenance (except USERMODs) from the SMP/E Environments, Maintenance tab.

USERMODs

A product USERMOD can be provided as a published maintenance package downloaded during the Update Product process. When
CA CSM
downloads a package including a ++USERMOD statement, it is loaded under the product with a USERMOD type. You can install these packages using
CA CSM
but cannot accept them because they are not intended to be permanent.
You can create a USERMOD manually, or we can provide an unpublished maintenance package as a USERMOD. In this case, the USERMOD file, which contains the ++USERMOD statement and the body of the USERMOD, must be managed as an externally downloaded package.

Unresolved HOLDDATA Processing

When you apply maintenance, review and process any unresolved HOLDDATA for the applied maintenance and its prerequisites. The maintenance wizard displays all unresolved HOLDDATA and lets you review the HOLDDATA and details about the HELD maintenance. You can then bypass the HOLDDATA or exclude the HELD maintenance.
CA CSM
determines unresolved HOLDDATA by running SMP/E APPLY GROUP/GROUPEXTEND CHECK.
In the maintenance wizard, you can perform the following actions:
  • Select HOLDDATA (HOLDDATA TYPE, REASON, or maintenance) to bypass it.
  • Leave HOLDDATA unselected to exclude it. If you do not select a HOLDDATA entry checkbox,
    CA CSM
    excludes the HELD maintenance from the processing.
If you exclude at least one HELD maintenance package,
CA CSM
runs an appropriate SMP/E APPLY GROUP/GROUPEXTEND CHECK command to verify the processing.
CA CSM
verifies whether other maintenance requires the excluded maintenance. If so,
CA CSM
also excludes it from processing.
If the SMP/E APPLY GROUP/GROUPEXTEND CHECK command discovers further unresolved HOLDDATA, you are notified about all unresolved HOLDDATA again. Select what HOLDDATA to bypass and what HELD maintenance to exclude.
This iterative process repeats until all HOLDDATA is resolved or bypassed. You can then proceed to the next step.
A list of maintenance packages that are excluded during the processing of unresolved HOLDDATA is displayed in the Summary step.

Apply
Maintenance

CA CSM
lets you track and apply
maintenance for your products.
is a set of maintenance packages that have been tested in a mainframe-integrated system test environment. Install
maintenance to keep your products current.
releases
maintenance regularly. The release date determines the
maintenance level.
To learn about new
maintenance that is available, download the files that are listed for published
maintenance. You can configure
CA CSM
to download these files automatically, or add CARS files manually. You can filter this maintenance in the
SMP/E Environments, Maintenance
section based on information that is in the files. You can also select the packages that are applicable within a
level.
You can apply particular
maintenance packages. You can update all products in an SMP/E environment.
A
file can list a maintenance package that the HOLDDATA marked as PE (PTF in Error). The
file can also reflect a corrective maintenance package for this PE that is not listed in this
file. This situation can occur if a maintenance package is found in error after the
file is published. The
processing continues as expected, and the maintenance package that is marked as PE is not applied. However, the
level for the product is not updated to the current level until you apply the corrective maintenance package to the SMP/E environment.
Configure Automatic
File Download
You can configure
CA CSM
to download available
files automatically. After download, the files are stored in a USS directory under the software catalog.
  1. Select the
    Settings
    tab, and select the
    Software Catalog
    link under
    System Settings
    in the
    Settings
    section on the left side.
  2. In the
    CARS Setting
    section, select the
    Enable Automatic Updates
    checkbox.
  3. Set up field values and select
    Apply
    .
    To download available
    files to the software catalog immediately, select
    Update Immediately
    .
    The automatic
    file download is configured.
Add a
File
If you cannot automatically download available
files, add them to the software catalog manually. Use the
Add CARS File
link. The files that were added manually are stored in the same USS directory as other files.
  1. Download the
    file using FTP from the
    file server directly to your USS directory.
    1. Connect to the FTP site at the following location:
      ftp://ftp.broadcom.com
    2. Log in to ftp.broadcom.com as follows:
      user name: anonymous
      password:
      your-email-address
    3. Change to the following directory:
      /pub/ASSIGNS
    4. Change your download mode to ASCII.
    5. Download the
      file. These files appear in the format:
      CAR
      yymm
      .TXT
  2. In the
    CA CSM
    web-based interface, select the
    Products
    tab, and select the
    Add CARS File
    link in the Actions section on the left side.
  3. Specify the USS path to the
    file you want to add, and select OK.
    Information about the
    file is saved in the
    CA CSM
    Software Catalog USS database.
Apply
Maintenance to an SMP/E Environment
You can upgrade products that are installed in an SMP/E environment to a specific
level. During processing,
CA CSM
verifies that maintenance packages that are associated with the selected CARS level can be applied to the products, and then applies the packages.
As an option,
CA CSM
lets you verify that the maintenance packages can be applied to the selected target zones without applying the packages.
While you work with an SMP/E environment, the environment is locked and other
CA CSM
users cannot perform any action against it. When the task finishes, logging out from
CA CSM
, or a
CA CSM
session is inactive for more than 10 minutes, the lock releases.
  1. Select the
    SMP/E Environments
    tab.
  2. From the list on the right, locate the SMP/E environment whose products you want to upgrade the
    level for. Select the
    Actions
    drop-down list to the right of the SMP/E environment, and select
    Upgrade CARS Level
    .
    If you select an SMP/E environment being used in
    CA CSM
    by another user, a notification message appears. You are prevented from performing any actions on the SMP/E environment. Wait until the notification message disappears and the SMP/E environment becomes available, or select
    Cancel
    to select another SMP/E environment.
  3. Follow the instructions on the wizard to navigate through the wizard steps.
  4. From the
    Summary
    step, review the summary and select
    Check and Apply
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
CA CSM
verifies and applies the
maintenance packages to the selected target zones.
If the task fails, navigate to the Tasks tab and review SMPOUT in the task output to identify and correct problems. Rerun the wizard.
You can accept the applied maintenance (except USERMODs) from the
SMP/E Environments, Maintenance
tab.

Apply FIXCAT Maintenance

CA CSM
lets you select and apply maintenance for your products according to FIXCAT.
FIXCAT (fix category) associates a maintenance package to one or more categories of PTFs (for example, installation, function, z/OS version, or communication).
FIXCAT data is provided in the same file as error HOLDDATA. Error HOLDDATA contains FIXCAT HOLDDATA statements that assign a maintenance package to a category. Select a category, and
CA CSM
determines and applies associated maintenance packages to the selected products installed in an SMP/E environment.
Masking Maintenance Categories
When you select maintenance categories in the wizard, you can use masking.
Use an asterisk (*), or a percent sign (%), or both to specify naming masks. An asterisk substitutes for any number of symbols. A percent sign substitutes for one symbol.
For example:
  • System.z/OS.*
    Selects all the categories whose names start with System.z/OS.
  • System.z/OS.%%
    Selects all the categories under System.z/OS whose last segment consists of two symbols.
Apply Maintenance by FIXCAT Category
You can select and apply maintenance for your products based on FIXCAT using
CA CSM
.
As an option,
CA CSM
lets you verify that the maintenance packages can be applied to the selected target zones without applying the packages.
While you work with an SMP/E environment, the environment is locked and other
CA CSM
users cannot perform any action against it. When the task finishes, logging out from
CA CSM
, or a
CA CSM
session is inactive for more than 10 minutes, the lock releases.
  1. Select the
    SMP/E Environments
    tab.
  2. From the list on the right, locate the SMP/E environment whose products you want to apply FIXCAT maintenance. Select the
    Actions
    drop-down list to the right of the SMP/E environment, and select
    Update Using Fix Categories
    .
    If you select an SMP/E environment being used in
    CA CSM
    by another user, a notification message appears. You are prevented from performing any actions on the SMP/E environment. Wait until the notification message disappears and the SMP/E environment becomes available, or select
    Cancel
    to select another SMP/E environment.
  3. Follow the instructions on the wizard to navigate through the wizard steps.
  4. From the
    Summary
    step, review the summary, and select
    Check and Apply
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
CA CSM
verifies and applies the FIXCAT maintenance packages to the selected target zones.
If the task fails, navigate to the Tasks tab and review SMPOUT in the task output to identify and correct problems. Rerun the wizard.
You can accept the applied maintenance (except USERMODs) from the SMP/E Environments, Maintenance tab.

Restore Maintenance

You can restore (back out) an applied maintenance package (but not an accepted maintenance package).
While you work with an SMP/E environment, the environment is locked and other
CA CSM
users cannot perform any action against it. When the task finishes, logging out from
CA CSM
, or a
CA CSM
session is inactive for more than 10 minutes, the lock releases.
  1. Select the
    SMP/E Environments
    tab, and select the SMP/E environment from which you want to restore maintenance.
  2. Select
    Maintenance
    . If you do not see any maintenance packages, verify that you have maintenance view criteria defined.
  3. Select the maintenance packages that you want to restore, and select the
    Restore
    link. You can filter out only applied packages.
    If you select an SMP/E environment being used in
    CA CSM
    by another user, a notification message appears. You are prevented from performing any actions on the SMP/E environment. Wait until the notification message disappears and the SMP/E environment becomes available, or select
    Cancel
    to select another SMP/E environment.
  4. Review the information about the restoring, and select
    Next
    .
  5. Review and adjust the list selections as required. Select Zones to review and adjust the zones where the maintenance is restored from. You can only perform maintenance actions on zones you select here. Select
    OK
    to confirm the selection and return to the wizard, and select
    Next
    .
  6. Review the prerequisites if they exist, and select
    Next
    .
    CA CSM
    restores these prerequisites as part of the maintenance restoring process.
  7. Review the summary, and select
    Restore
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
The maintenance packages are restored.

Accept Maintenance

After maintenance has been applied, you can accept the maintenance for products that are installed in an SMP/E environment. You cannot accept USERMODs.
Use this procedure to accept the maintenance in GROUP mode.
Before you start, update the HOLDDATA in your software catalog. To do so, select
Update HOLDDATA
in the
Actions
section on the
Software Catalog
page. You can also set up the automatic HOLDDATA download as described previously in this article.
While you work with an SMP/E environment, the environment is locked and other
CA CSM
users cannot perform any action against it. When the task finishes, logging out from
CA CSM
, or a
CA CSM
session is inactive for more than 10 minutes, the lock releases.
  1. Select the
    SMP/E Environments
    tab, and select the SMP/E environment whose products you want to accept maintenance.
  2. Select
    Maintenance
    . If you do not see any maintenance packages, verify that you have maintenance view criteria defined.
  3. Select the maintenance packages that you want to accept, and select the
    Accept
    link.
    If you select an SMP/E environment being used in
    CA CSM
    by another user, a notification message appears. You are prevented from performing any actions on the SMP/E environment. Wait until the notification message disappears and the SMP/E environment becomes available, or select Cancel to select another SMP/E environment.
  4. Review the information about the maintenance, and select
    Next
    .
  5. Review and adjust the accept list selections as required. Select
    Zones
    to review and adjust the zones where the maintenance is accepted. You can only perform maintenance actions on zones you select here. Select
    OK
    to confirm the selection and return to the wizard, and select
    Next
    .
  6. Select the installation mode for the selected maintenance, and select
    Next
    .
  7. Perform one of the following actions to address prerequisites:
    • If no prerequisites exist, select
      Next
      . A list of HOLDDATA appears.
    • If prerequisites exist and are available, review them, and Select
      Next
      . A list of HOLDDATA appears. The prerequisites are accepted as part of the process.
    • If a prerequisite is
      not
      available, the wizard cannot continue. Select
      Cancel
      to exit the wizard. Acquire the prerequisite and restart the process.
  8. Review HOLDDATA entries, if they exist. Select
    Export Table
    to open all HOLDDATA information for all selected maintenance in a separate browser window. Selecting
    Export Table
    is similar to running the LIST SYSMODS HOLDDATA command within your SMP/E environment.
  9. Select
    Next
    .
    SMP/E work DDDEFs of SMPWRK
    x
    and SYSUT
    x
    , with their allocation parameters, are listed.
  10. Review the work DDDEF allocation parameters, and edit them, if necessary, to verify that sufficient space is allocated for them during the maintenance acceptance:
    Changes in the allocation parameters apply to the current maintenance processing only.
    1. Select
      Override
      for a DDDEF to edit its allocation parameters.
      A pop-up window opens.
    2. Make the necessary changes, and select
      OK
      to confirm.
      The pop-up window closes, and the DDDEF entry is selected in the list indicating that the allocation parameters have been overridden.
    You can also:
    • Update allocation parameters for the DDDEFs automatically by select Resolve Overrides.
      CA CSM
      provides values for all DDDEFs based on the total size of the selected maintenance packages being accepted. All DDDEF entries are selected in the list indicating that the allocation parameters have been overridden.
      To edit the allocation parameters for a DDDEF after automatically updating them with the Resolve Overrides button, select
      Override
      . Make the necessary changes. Select
      OK
      to confirm and return to the wizard.
    • Cancel a parameter update for any DDDEF by clearing its checkbox.
  11. (Optional) Select
    View SMP/E Work DDDEFs
    to review SMP/E work DDDEF and their allocation parameters for the selected SMP/E environment zones. Select
    Close
    to return to the wizard.
    Sometimes, the allocation parameters differ from the allocation parameters that you obtained using the
    Resolve Overrides
    button.
    Select
    Next
    .
  12. Review the summary, and select
    Accept
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens and you can view the action details.
The maintenance packages are accepted.

Accept Maintenance in GROUPEXTEND Mode

CA CSM
lets you invoke the SMP/E utility with the GROUPEXTEND option enabled for accepting maintenance.
When you accept maintenance in GROUPEXTEND mode, the following installation modes are available:
  • Accept Check
    Checks if the maintenance can be accepted to the selected SMP/E environment in GROUPEXTEND mode.
  • Accept
    Accepts the maintenance to the selected SMP/E environment in GROUPEXTEND mode.
  • Accept Check and Accept
    Checks if the maintenance can be accepted to the selected SMP/E environment in GROUPEXTEND mode. Then accepts it if possible.
For the GROUPEXTEND option,
CA CSM
does not automatically receive and display maintenance or HOLDDATA prerequisites that must be bypassed when accepting the maintenance. Accept check mode lets you check if any prerequisites or HOLDDATA exist and report them in the task output.
How Maintenance in GROUPEXTEND Mode Works
Accept maintenance in GROUPEXTEND mode in the following sequence:
  1. Apply all maintenance packages that you want to include by the GROUPEXTEND option.
  2. Run the maintenance in Accept check mode.
    • If the task fails, review SMPOUT in the task output. Review if there are missing (not applied) maintenance packages or HOLDDATA that must be resolved or bypassed.
    • If the task succeeds, review SMPRPT in the task output. Review what maintenance packages were found and accepted.
  3. Run the maintenance in Accept mode. Specify the maintenance packages that you want to exclude and HOLDDATA that you want to bypass, if any exist.
    The followings options are available for bypassing HOLDDATA:
    • HOLDSYSTEM
    • HOLDCLASS
    • HOLDERROR
    • HOLDUSER
You can run the maintenance in Accept mode in the same
CA CSM
session after Accept check mode is completed. The values that you entered for Accept check mode are then prepopulated on the wizard dialogs.
Accept Maintenance with the GROUPEXTEND Option Enabled
You can accept maintenance (except USERMODs) with the GROUPEXTEND option enabled.
While you work with an SMP/E environment, the environment is locked and other
CA CSM
users cannot perform any action against it. When the task finishes, logging out from
CA CSM
, or a
CA CSM
session is inactive for more than 10 minutes, the lock releases.
  1. Select the
    SMP/E Environments
    tab, and select the SMP/E environment holding the maintenance packages that you want to accept in GROUPEXTEND mode.
  2. Select
    Maintenance
    .
    Maintenance packages available for the products are listed. If you do not see any maintenance packages, verify that you have maintenance view criteria defined.
  3. Select the maintenance packages that you want to accept in GROUPEXTEND mode, and select the Accept GROUPEXTEND link.
    If you select an SMP/E environment that is being used by another user, a notification message appears. You are prevented from performing any actions on the SMP/E environment. Wait until the notification message disappears and the SMP/E environment becomes available, or select
    Cancel
    to select another SMP/E environment.
  4. Review the information about the maintenance, and select
    Next
    .
    The packages that you want to accept are listed.
    Select a link in the Status column for a maintenance package, if available, to review a list of zones. The zones indicate where the maintenance package is received, applied, or accepted. Select
    Close
    to return to the wizard.
  5. Review the packages, and select
    Next
    .
    For the GROUPEXTEND option,
    CA CSM
    does not automatically receive and display maintenance or HOLDDATA prerequisites that must be bypassed when accepting the maintenance. Accept check mode lets you review if any prerequisites or HOLDDATA exist and report them in the task output. Run the maintenance in Accept check mode first.
  6. Read the information that is displayed on this tab, and select
    Next
    .
    The installation options appear.
  7. Specify installation options as follows, and select
    Next
    :
    1. Select the installation mode for the selected maintenance.
    2. Review the GROUPEXTEND options and select the ones that you want to apply to the maintenance:
      • NOAPARS
        Excludes APARs that resolve error reason ID.
      • NOUSERMODS
        Exclude USERMODs that resolve error reason ID.
    3. (Optional) Enter maintenance packages that you want to exclude in the Excluded SYSMODs field. You can enter several packages, separate them by a comma.
    The Bypass HOLDDATA step of the wizard appears.
  8. (Optional) Enter the BYPASS options for the HOLDDATA that you want to bypass during the maintenance installation. You can enter several BYPASS options, separate them by a comma.
  9. Select
    Next
    .
  10. Review the summary, and select
    Accept GROUPEXTEND
    .
    A dialog that shows the progress of the task opens. When the task completes, select
    Show Results
    on the
    Progress
    tab to close this dialog. The task output browser opens, and you can view the action details.
    • If you run the maintenance installation in Accept check mode and the task succeeds, review SMPRPT in the task output. Review what maintenance packages were found and accepted.
    • If you run the maintenance installation in Accept check mode and the task fails, review SMPOUT in the task output. Review if there are missing (not accepted) maintenance packages or HOLDDATA that must be resolved or bypassed.
You completed maintaining products with
CA CSM
.