Switching between two LIBRARY concatenations

Introduce one LIBRARY to CICS® and take another LIBRARY offline, so that a program in the new LIBRARY is loaded to replace that program in the old LIBRARY.

About this task

  • A LIBRARY containing the program or various program artifacts making up an application is currently installed in CICS.
  • A new version of the program or application is available in one or more PDS or PDSE data sets.
  • The person who performs this action has the appropriate access authorization.

Procedure

  1. Define a CICSPlex® SM LIBRARY definition (LIBDEF) that includes the new application data set or data sets, using CICSPlex SM BAS.
  2. Install the new LIBRARY.
  3. Issue a PROGRAM NEWCOPY or PHASEIN command to start using the new copy of the program or programs.
  4. Disable the old LIBRARY resource and discard it, if it is not likely to be used again.
  5. Optionally, change the ranking of the new LIBRARY using the SET LIBRARY command, the WUI, or the CICSPlex SM API, back to that of the old LIBRARY.

Results

CICS runs with the new LIBRARY and new version of the application.