Re: Upgrading from V5R1 to V5R2

[Al Barsa <barsa@xxxxxxxxxxxxxxxxxxx>]

See this from one of my COMMON pitches.  It can be a killer when you go
from V5R1 to higher:


     The correct spelling of the word "enhancement" is "fiasco".

     In response to numerous customer and ISV requests, IBM is increasing
     the length of the user portion of the library list from 25 to 250
     libraries effective in V5R1.  Although IBM developers understand that
     this change will impact some users, they contend that this is in the
     best interest of the long-term interest of the platform.  The speaker
     disagrees, and feels that this could break your applications.  This
     would be the significant first change in the history of the System/38,
     AS/400, iSeries platform that will break users code, forcing you to
     make changes to keep existing applications working in the event that
     those application encountered more than 25 libraries on the userâs
     portion of the library list.

     The following is an example of some pseudo code that would have to
     ultimately be changed:

                      DCL        VAR(&USRLIBL) TYPE(*CHAR) LEN(275)
                      DCL        VAR(&CMD) TYPE(*CHAR) LEN(6000)
                      RTVJOBA    USRLIBL(&USRLIBL)
                      CHGLIBL    LIBL(MYLIB1 MYLIB2 QGPL QTEMP)

         /*  Do my thing, sing my song, yada, yada, yada
     */

                      CHGVAR     &CMD ('CHGLIBL LIBL(' *CAT &USRLIBL *TCAT
     ')')
                      CALL       PGM(QCMDEXC) PARM(&CMD 6000)

     If you did not have access to your source code, or did not have
     support from your ISV, the above code would break.  Retrieving a user
     library list into a variable of insufficient length would cause a new
     escape message of CPF098A.


     Remediation of the Problem:

     V5R1:

     To minimize the impact of this change, IBM has created a new data area
     in V5R1 (QLILMTLIBL in QUSRSYS) that acts as a system wide switch only
     allowing access to the first 25 libraries in the all commands that
     support a library list parameter.  The data area will not be shipped
     in V5R2.

     V5R2:

     Each limiting jobâs usage of the longer library list is controlled by
     the contents of the data area QLMTUSRLIB, as found in the jobs library
     list.  If that one byte character data area contains a â0â, long
     library lists are enabled for that job.  If it contains a â1â, the
     library list is restricted to 25 libraries.  IBM ships this data area
     in QGPL in V5R1, and the setting of QLILMTLIBL is ignored.  IBM leaves
     QLILMTLIBL on your system to use additional disk space.

     Detailed documentation about this change can be found at:

     
http://www-919.ibm.com/servers/eserver/iseries/developer/os400/lib_list.html





     The correct way to fix this problem would have been to create a job
     attribute, which defaulted from a job description, which defaulted
     from a system value.


     SCNLIBL - A TAA Tool to Help you Fix Your Code:

     The TAA Tool, Scan Library List (SCNLIBL) command will analyze your
     programs using the Display Command Usage (DSPCMDUSG) command and your
     programâs source, looking for the usage of the RTVJOBA command, and
     the USRLIBL parameter.  This tool will attempt to determine the length
     of the receiving parameter.  Although the tool is not perfect, it does
     an adequate solution.  Detailed documentation about this change can be
     found at:

     http://www.taatool.com/document/L_scnlibl.htm



Al Barsa, Jr.
Barsa Consulting Group, LLC

400>390

"i" comes before "p", "x" and "z"
e gads

Our system's had more names than Elizabeth Taylor!

914-251-1234
914-251-9406 fax

http://www.barsaconsulting.com
http://www.taatool.com
http://www.as400connection.com



                                                                           
             "Luis Rodriguez"                                              
             <luisrodriguez@fa                                             
             stmail.fm>                                                 To 
             Sent by:                  "Midrange"                          
             midrange-l-bounce         <midrange-l@xxxxxxxxxxxx>           
             s@xxxxxxxxxxxx                                             cc 
                                                                           
                                                                   Subject 
             01/11/2005 08:32          Upgrading from V5R1 to V5R2         
             AM                                                            
                                                                           
                                                                           
             Please respond to                                             
             Midrange Systems                                              
                 Technical                                                 
                Discussion                                                 
             <midrange-l@midra                                             
                 nge.com>                                                  
                                                                           
                                                                           




Hi all,

I'm about to upgrade an iSeries 830 from V5R1 to V5R2.
Does anyone have any tips (besides the obvious as checking PTFs, reading
the manuals, etc) about this?

Thanks,

Luis Rodriguez,

Caracas, Venezuela
--
This is the Midrange Systems Technical Discussion (MIDRANGE-L) mailing list
To post a message email: MIDRANGE-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: http://lists.midrange.com/mailman/listinfo/midrange-l
or email: MIDRANGE-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at http://archive.midrange.com/midrange-l.