Taking a LIBRARY offline or removing an application from a CICS system

Take a LIBRARY offline; for example to compress a PDS or remove an application from a running CICS system.

About this task

  • The application is in a known data set or set of data sets in a dynamic LIBRARY resource.
  • The person who performs the action has the appropriate access authorization.

Procedure

  1. Disable the LIBRARY using the EXEC CICS SET LIBRARY command, CEMT, the CICSPlex® SM WUI, or the CICS Explorer®.
  2. When all uses of the application have completed, perform an operation to cause the loaded copies of the programs to be removed, for example a SET PROGRAM NEWCOPY, or let them fail at the next reload.
  3. One reason for disabling the LIBRARY might be to compress the data set and then re-enable the LIBRARY or reinstall the LIBRARY definition to start using the application again. After re-enabling the LIBRARY, issue PROGRAM NEWCOPY or PHASEIN to use the programs again.

Results

While the LIBRARY is disabled, no new users can use the application, unless a copy exists in another LIBRARY that comes after the disabled LIBRARY in the search order, in which case it is loaded from there.