PK48565: TO ADD FUNCTIONS FOR BATCH AUDIT REPORTS AND CSD CLEAN-UP.

APAR status

• Closed as new function.

Error description

• To provide enhancements to CICS Configuration Manager in the
  form of CSD clean-up and Batch Audit reports.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS Configuration Manager.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: To ship enhancements and provide        *
  *                      resolutions to minor problems.          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The following enhancements have been introduced:
  1. Audit changes to resource definitions. The new batch CICS
     Resource Definition Changes Report shows changes to resource
     definitions that CICS Configuration Manager records in its
     journal.
  2. Analyze relationships between resource definitions.  New
     options under primary menu option 4 Reports displays resource
     definitions based on relationship criteria:
     - matching names or checksums;
     - orphan groups or ResGroups (that do not belong to any
       lists or ResDescs);
     - orphan CICSPlex SM resource definitions (that do not
       belong to any ResGroups);
     - and shared CICSPlex SM resource definitions (that belong
       to multiple ResGroups).
  3. Show only duplicate, unique, "different", or "missing"
     resource definitions.  The new Show action bar choice and
     corresponding primary command allow you to filter a list
     panel of resource definitions to show only duplicates, based
     either on their combination of name and resource type,
     or on a checksum calculated from their attribute values.
     Similarly, you can filter a list panel to show only unique
     resource definitions.
     On list panels under option 4.1 Multiple Configs, the Show
     action bar choice contains two additional choices:
     - 'Show different' shows resource definitions that have the
       same name and resource type but different checksum values.
     - 'Show missing' shows resource definitions whose
       combination of name and resource type exist in some but
       not all of the selected CICS configurations.
  4. View detailed change package history.  The History processing
     option under primary menu option 3 Packages of the ISPF
     dialog now provides additional details.
     For example, selecting a Migrate, Import, or Backout command
     on the History list panel displays the command details, with
     the option of displaying a list panel of the resource
     definitions that the command updated.
  5. Samples for the standards-enforcement exit (CCVXPRAx samples
     for RANAxxxx exit points) have been enhanced.
     The new samples:
     - may exempt specific API commands or functions (ie deletes)
     - provide improved diagnostic tracing and error handling
     - correct other minor usage problems.
  6. A generic ENQMODEL has been added to the CICS CM resource
     group to avoid conflicts with other ENQMODELs that may have
     been installed in the server.
  7. CCM's internal trace facility has been extended to record
     data for SAF calls.
  8. The restriction criteria handler for journal records now
     allows for an incomplete date/time string.  A greater-than
     or less-than condition may use a shortened date, for example
     only the year or year-month to retrieve data.
  9. Journal search facilities have been extended to allow full
     masking of the name and group fields specified as
     JNLCRITERIA.
  10.Backout may now be applied to the Import of resources for a
     change package.
  11.Journal search using filters returns all objects where the
     case-sensitivity of the object name is ignored (that is,
     'trna', 'TRNA', 'TrNa' etc are considered equivalent).
     However, a journal search using restriction criteria only
     returns an exact match for object name.  Restriction
     criteria processing for journal object name has been
     modified to exhibit the same behaviour as the filters.
  12.Sample XML schemas have been updated.
  ****************************************************************
  The following problems have been resolved:
  1. Some CICS CM enqueues were requested with 'NOHANDLE', which
     masks the 'ENQBUSY' condition causing incorrect handling of
     enqueues.
  2. Under some conditions, the reason code field in the change
     package and package scheme records' history data contained an
     invalid MODID value.
  3. Some security failures were incorrectly reported as 'service
     failure' by the CCM server, instead of 'authorisation failed'
     or 'undefined SAF class'.
  4. Users of the supplied sample resource attribute validation
     exit program, CCVXPRA, may experience 'Analyser Abend' when
     creating CP/SM RESDESC or RESGROUP objects.
  5. CICS objects with long character fields (eg, BeanName in a
     RequestModel) could suffer 'Service failed' or truncated data
     if the string contained characters that have to be encoded to
     be sent in the XML string.  The server only allowed for 256
     bytes of data, but encoded characters require three bytes to
     represent each character, leading to truncation.  The server
     has been modified to allow for longer strings.
  6. Security checking when CCM security is activated had no
     provision for checking a change of functional security SAF
     PREFIX and incorrectly used the prefix defined at CCM
     start-up.  This has been corrected so that the correct prefix
     is used.  In addition, CCM attempted to protect the user from
     activating security if that user would not then be able to
     turn security off, but the checks were not always sufficient.
     To be able to activate CCM security, the user must be able to
     inquire and update the sytems options record, and, where
     either or both of the functional SAF class or SAF prefix is
     changed, be able to inquire and update the systems options
     using the new class/prefix.
  7. Several minor issues with object security, such as 'service
     failure' reported in place of 'authorisation failed' have
     been cleaned up.
  8. MIGRATE returns RC-FAIL and RSN-NULL-MIGRATION-LIST if a
     transform rule results in all objects in the package being
     suppressed.  This has been modified to RC-WARN to reflect
     the fact that this is a normal outcome from the rule rather
     than a failure.
  9. COPY failures caused by functional security were incorrectly
     reported as severe error with a reason of 'illogic'.
     This has been corrected so that they are now reported as
     security failures.
  10.Data set name validation for the CICS Configuration data
     takeup utility (CCVBTKUP) has been improved.
  11.The following ISPF online dialog problems are corrected:
  11.1  Some minor inaccuracies in Help text have been corrected.
  11.2  Validation of the TDqueue definition's TypeFile
        attribute for values RDBACK/READBACK has been corrected.
  11.3  Application of default values to TDqueue defintions
        considers differences between CSD and CP/SM based
        repositories.
  11.4  Definition for export files no longer requires the CICS
        TS release parameter.
  11.5  PrevPage/NextPage scrolling issues an information
        message if no additional data is viewable
  11.6  The CONFIG filter is now automatically uppercased on
        the 4.1 Reports, Mulitple Configurations when filtering
        for CICS Configurations.
  11.7  Various ISPF messages have been introduced, improved,
        or corrected.
  11.8  Error handling in socket-connection processing has been
        improved or corrected.
  11.9  Word-wrap processing in various exception message
        pop-up panels has been improved or corrected.
  11.10 Various ISPF skeletons or samples have been adjusted to
        conform with the documented syntax guidelines.
  11.11 The ISPF skeleton for a batch UNREADY command now
        includes the KEYRING parameter for SSL connections.
  11.12 The option 1.2 Administer, CICS Configurations list
        panel now defaults to the view last displayed by the
        user.
  11.13 The ISPF command line now takes precedence over line
        action processing in various list panels.
  11.14 The option 2.X.XR report (CICS Resources, Expand Lists,
        Expand Resources) failed to show results when SEARCH
        was activated.
  11.15 Viewing of version histories for CP/SM ResGroup
        definitions previously resulted in an 'internal error'.
  11.16 SEARCH message counts may have been incorrect for CP/SM
        related searches.
  11.17 The option 4.1.S REL report (Reports, Multiple
        Configurations, Display Resources with the RELATED line
        action) failed with a required attribute missing from
        the XML request.
  

Problem conclusion

Temporary fix

Comments

• To provide enhancements and resolve minor problems with CICS
  Configuration Manager.
  ž**** PE08/04/24 PTF IN ERROR. SEE APAR PK65043  FOR DESCRIPTION
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK32672 UK32681 UK32682

Modules/Macros

• CCVAADD  CCVAALT  CCVAAPP  CCVABACK CCVABCH4
  CCVABVIE CCVABVI2 CCVACMDA CCVACOPY CCVACRE  CCVADISA CCVADI
  
  ***This field was truncated.  To obtain the full apar record, please contact your local support center.***
  

Fix information

• Fixed component name

  CICS CONFIG MGR

• Fixed component ID

  5697I7800

Applicable component levels

• R12E PSY UK32681

     UP08/01/12 P F801

• R12K PSY UK32682

     UP08/01/12 P F801

• R120 PSY UK32672

     UP08/01/12 P F801