A fix is available
APAR status
Closed as program error.
Error description
Minor corrective maintenance
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of CICS Configuration Manager. * **************************************************************** * PROBLEM DESCRIPTION: Minor corrective maintenance for CICS * * Configuration Manager for z/OS v5.4. * **************************************************************** This APAR covers the following: 1. APPLDEF resource type is not supported as a resource type filter on the ISPF online dialog panels used for IMPORT processing a CCM format export file. 2. The ISPF online dialog is used for IMPORT processing to a CSD based CICS Configuration for the entire file (no resource or change package filtering). However, the CCM format export/import file only contains CICSPlex SM definitions like APPLDEF, CSYSDEF and WLMDEF. The ISPF dialog fails with errors including the following: CEE3798I ATTEMPTING TO TAKE A DUMP FOR ABEND U4082 TO DATA SET: CEE0374C CONDITION=CEE3204S TOKEN=<token> WHILE RUNNING PROGRAM CCVOPRIM IRX0251E User abend code 4082, reason code 00000002. 3. The CICS Configuration Manager for z/OS DFHCSDUP audit feature includes new messages that may contain reason codes. These reason codes are not documented, and do not conform with the standard reason codes. For example: CCV5686E Unexpected failure in module CCVCSDUA, Return code=12, Reason code=2. 4. The CICS Configuration Manager for z/OS DFHCSDUP audit feature occasionally fails with message: CCV5686E Unexpected failure in module CCVCSDUP, Return code=12, Reason code=16. This occurs when processing aged CSD records last updated by CICS TS releases 3.2 or earlier. When the problem occurs, no audit collection is performed for the aged CSD record. Unnecessary validation of the ChangeAgRel attribute on the resource definition is being done. ChangeAgRel was introduced in CICS TS 4.1, and therefore earlier CSD records fail the validation. 5. The DFHCSDUP audit feature encounters an audit collect failure. The System Option 'Error handling' for DFHCSDUP audit specifies WARN, thereby indicating that the DFHCSDUP job step return code should be set to a minimum of 4. However, in some error cases, the DFHCSDUP completes normally with a return code of zero. 6. The ISPF online help panel describing the System Option 'Error handling' is unclear regarding processing implications when errors occur. 7. CCVBMAIN utility DEPLOY reporting fails during RUNTIME data collection performed using CICSPlex SM services with the errors: CCV9175E A collection phase for Deployment Analysis has failed. CCV9186E The CICS resource type is not valid. The failure occurs following collection of URIMAP information. 8. A single request to ALTER, DISCARD or NEWCOPY resources for a context-based CICS Configuration only processes the first 256 resource entries. Feedback on the remaining resources is inconsistent or in error. 9. The CCVBMAIN utility COLDSTARTCOMPARE report is run to compare CSD or CICSPlex SM resource definitions with the runtime resources in an active CICS region. The report identifies some TERMINALs found in the candidates list (those from the CSD or context) as new definitions, however their matching CICS region runtime resources exist. 10. The listing or viewing of SYSLINK resources is incomplete, in error, or fails in various ISPF dialog displays: 10.1. Listing SYSLINK resources within a CCM-format export file displays incomplete information: - The NAME is shown as blanks, whereas the assigned alias value should be used as is the case for other compound-key resource types like APPLDEF, RASINDSC, and so on. - The GROUP appears as -SPACES- for SYSLINK and other resources without group values, whereas blanks appear elsewhere in the dialog. 10.2. Viewing (action V) SYSLINK resources within a CCM-format export file displays incorrect values for the resource attributes. 10.3. Viewing (action V) change package assigned SYSLINK resources (via change package, list options) fails with 'Error in API request'. 11. A processing command to REMOVE a CICSPlex SM resource from a RESGROUP is defined for a change package. The package is then MIGRATE'd to a CCM-format export file. Next, the export file is processed by IMPORT with the option REGISTERCPID=YES (Register change packages on import) turned on. The IMPORT executes the command, registers the change package, and propagates the command to the change package. Subsequently, the change package registered by IMPORT is used by MIGRATE to apply the resources and commands to other targets. However, the command whilst appearing correct, is not applied correctly by the MIGRATE. The MIGRATE fails: - RC=08 RSN=0003 (record not found condition) - ISPF dialog reports: CCVE462 The request failed because a definition required to complete the request was not found. The missing definition may have been named as an input parameter value in the API command request, or it may be implicitly related to input parameters used in the command request. HELP (default F1) to learn more. - CCVBMAIN batch reports: CCV9406E A required definition was not found This occurred because the import program (CCVAIMP) incorrectly set the 'container' field in the propagated command (CMDASSOC) record to nulls, whereas it should be spaces. 12. The ISPF dialog SESSION edit panel (CCVPCSEE) shows NOTAPPLIC as a valid value for PROTOCOL when editing CSD resources. However, NOTAPPLIC is only valid for CICSPlex SM SESSION definitions. 13. ISPF dialog provides a SAVE LIST function to save the resource list appearing on the panel to a data set. The SAVE LIST function is invoked from the FILE Action Bar pull down choice 'SAVE LIST' or by the primary command: SAVE <dsname>. However, the SAVE LIST does not save the list information for some CICSPlex SM specific resource types. 14. The DFHCSDUP audit collection feature has been implemented by relinking DFHCSDUP with CICS Configuration Manager modules according to SCCVSAMP samples: CCVXDUP5 (Relink DFHCSDUP outside of SMP/E controls) CCVXDUP6 (Define and link the DFHCSDUP termination exit) CCVXDUP9 (SMP/E ++USERMOD to relink DFHCSDUP) After an SMP/E APPLY of maintenance to the audit collection modules and then relinking DFHCSDUP, the updated maintenance does not take effect.
Problem conclusion
CICS Configuration Manager is corrected as follows: 1. The ISPF online dialog panels for IMPORT processing now accept resource type filter values for APPLDEF and other CICSPlex SM specific types like SYSLINK, CSYSDEF, WLMDEF and so on. 2. The Server IMPORT program CCVAIMP is changed to process the import file correctly. 3. The DFHCSDUP audit programs now issue reason codes in the normal CICS Configuration Manager for z/OS format, and the documented list of reason codes is updated in the: - ISPF online help Action Bar choice: Help Topic: Tutorial Index Help article: CICS Configuration Manager Reason codes - IBM Knowledge Center Product: CICS Configuration Manager for z/OS 5.4, Topic: Messages and codes Subtopic: Reason codes 4. The validation check for ChangeAgRel is removed. 5. The DFHCSDUP audit programs now propagate a minimum DFHCSDUP job step return code of 4 if the System Option 'Error handling' specifies WARN and an audit collection error is encountered. 6. The ISPF online help panel CCVHSYJE (Error handling - Help) is improved. 7. The program CCVSCPCR used for interacting with CICSPlex SM for runtime resource collection is corrected. 8. The programs performing the ALTER, DISCARD and NEWCOPY services are corrected to handle more than 256 objects. 9. The program (CCVSNCCR) collecting the CICS region runtime resources is corrected. 10. The ISPF dialog displays are corrected to enable consistent listing and viewing of SYSLINK resources. 11. The import program (CCVAIMP) now sets the 'container' field to spaces rather than nulls. 12. The SESSION edit panel now allows the PROTOCOL value NOTAPPLIC only for CICSPlex SM context based Configurations. 13. The SAVE LIST function is now implemented for the following CICSPlex SM specific resource type lists, invoked via ISPF option 2 (CICS Resources) for a context based CICS Configuration. ISPF Menu Option Action Category Option Resource Type ------ ------ -------- ------ ------------- 2 F FF-BAS 4 RASGNDEF 5 Platforms 6 Applications 7 RASINDSC 8 SYSLINK 9 RDSCPROC View 10 RASPROC View 11 SYSRES View 2 T Topology 1 CSYSDEF 2 CSYSGRP 3 PERIODEF 4 CSGLCGCS 5 CSGLCGCG 2 W Workload 1 WLMSPEC 2 WLMGROUP 3 WLMDEF 4 TRANGRP 5 LNKSWSCS 6 LNKSWSCG 7 WLMINSPC 8 WLMINGRP 9 DTRINGRP 14. The SCCVSAMP samples that relink DFHCSDUP specified the use of the CICS Configuration Manager SMP/E distribution library ACCVMOD. However, ACCVMOD is not updated by the SMP/E APPLY process. The SCCVSAMP samples CCVXDUP5, CCVXDUP6 and CCVXDUP9 are corrected to use SMP/E target zone libraries which are updated by the SMP/E APPLY process.
Temporary fix
Comments
×**** PE18/09/11 FIX IN ERROR. SEE APAR PH02675 FOR DESCRIPTION
APAR Information
APAR number
PI98849
Reported component name
CICS CONFIG MGR
Reported component ID
5697CIC00
Reported release
540
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-06-06
Closed date
2018-06-19
Last modified date
2018-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI56678 UI56679 UI56680
Modules/Macros
CCVAALT CCVADISC CCVAIMP CCVANCPY CCVBMAIN CCVCSDEX CCVCSDUA CCVCSDUD CCVCSDUP CCVCSDUT CCVHCIM1 CCVHCIM4 CCVHCODE CCVHFTT4 CCVHSEPR CCVHSYJE CCVOADMN CCVOPRIM CCVPCIM1 CCVPCIM4 CCVPCSEA CCVPCSEE CCVSCPCR CCVSLITE CCVSLITK CCVSMDDD CCVSMSGE CCVSMSGK CCVSNCCR CCVXDUP5 CCVXDUP6 CCVXDUP9
Fix information
Fixed component name
CICS CONFIG MGR
Fixed component ID
5697CIC00
Applicable component levels
R540 PSY UI56678
UP18/06/22 P F806
R54E PSY UI56679
UP18/06/22 P F806
R54K PSY UI56680
UP18/06/22 P F806
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SS2L7A","label":"CICS Configuration Manager for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 October 2018