CA 2E library order with Y2 libraries higher in list than Y1

Products

• CA 2E

Issue/Introduction

The documentation notes mention that "Ensure that the CA 2E libraries starting with Y2 are higher in library list than CA 2E Toolkit libraries starting with Y1."

In our existing models from version 8.7.0,  Y1 appears above Y2 in the library list. Additionally, the sample R874SMPMDL 8.7.4 model provided by Broadcom in the install also has the Y1 libraries positioned above the Y2 libraries.  

Please clarify if the library order is important for the install process.

Environment

Release 8.7.4

Cause

The ordering of the libraries, favouring the Y2 prefixed models to take precedence over Y1 prefixed models, has to do with a service program called YSTRPRC1S, which was introduced in 2E version r8.7.1.

Resolution

As part of changes done to REST web service processing in r8.7.1, we made some changes to the YSTRPRC1S service program. Previously, this service program only existed in the 2E Toolkit library. However, as part of r8.7.1 REST web service processing, a copy was taken to the 2E PTF library and changes were made. 1 of the existing bound module  - strGetWord, was modified and add 3 new bound modules - strRplInvalidChars, chkIFSDir, sendtoJoblog to this service program.

Since we wanted the version from the 2E PTF library to take precedence, rather than the version from 2E Toolkit, for ensuring REST web service functionality works fine, a note was added to documentation stating that Y2* libraries should be higher in the library list than Y1* libraries.

That said, the same modified object now exists in both the 2E PTF libraries and 2E Toolkit PTF libraries. Therefore, the sequence of libraries as mentioned in documentation will not really matter. If we have the 2E PTF (Y287nAC) and 2E Toolkit PTF (Y187nAC) libraries above the 2E (Y2SY) and 2E Toolkit (Y1SY) product libraries, as mentioned in documentation, we should be good.

In summary, the ordering of the libraries has mainly to do with REST web services.  The ordering of the libraries is of no consequence in practise as far as the upgrade activity is concerned. 

Additional Information

 If there is an interest though to edit and reorder the model library list, you can always use the YWRKLIBLST or YEDTLIBLST commands.