Keeping track of changes to the LIBRARY configuration

Use the audit log to determine changes to the LIBRARY configuration in a CICS® system

About this task

Messages DFHLD0555I and DFHLD0556I are written to the CSLB transient data queue, to provide an audit log of changes to the LIBRARY configuration. The messages are issued to show the current LIBRARY search order each time a change has occurred that might affect the search order. Message DFHLD0555I is issued followed by one instance of message DFHLD0556I for each LIBRARY that is active in the search order. Use the audit log to determine changes to the LIBRARY configuration in a CICS system, such as the following:
  • A new LIBRARY is installed.
  • A LIBRARY is removed (discarded) from CICS.
  • The ranking, critical status, or enablement status of a LIBRARY is changed.
  • The overall LIBRARY search order is changed.

Procedure

  1. Examine the audit log, which is written to the CSLB transient data queue, to see changes to a LIBRARY configuration in a CICS system and the resulting LIBRARY search order. The audit log also shows changes to the LIBRARY configuration for LIBRARY concatenations that are defined as part of an application installed on a platform. These LIBRARY configurations, which are private to the application, are shown in their search order for the application, but they are not part of the search order for the CICS system.
  2. Optionally, use a utility, developed in-house or by a vendor, to analyze and interpret the audit log for this system or for multiple systems.

Results

DFHLD0555I and DFHLD0556I show the new LIBRARY search order resulting after a change has occurred that might affect the search order. There is one instance of message DFHLD0556I for each LIBRARY that is active in the search order. There are a number of scenarios in which these messages will be displayed even though the search order is unchanged. For example, changing the ranking value of a disabled LIBRARY will not affect the search order because a disabled LIBRARY does not participate in the search order, but the change will trigger these messages. Similarly, changing the ranking of an enabled LIBRARY to a number that still lies between the rankings of the LIBRARYs on either side of it in the search order will trigger these messages, but not change the order.


dfhp3_library_usecase13.html | Timestamp icon Last updated: Monday, 5 June 2017