Previous Topic: 5.2 Change ISPF Library Names

Next Topic: 5.4 Convert CA MICS to a New SAS Version

5.3 Update CA MICS for SAS System Changes


************************************************************
* NOTE:  If you are upgrading your CA MICS system to       *
*        a new version of SAS, follow the instructions     *
*        outlined in section 5.4.                          *
*                                                          *
*        This checklist is ONLY used for changing the      *
*        SAS System Library names, typically associated    *
*        with application of SAS System maintenance.       *
*                                                          *
************************************************************

This section provides a procedure for updating CA MICS when
you change SAS System library names.  Typically, library
names change to comply with data set naming standards or when
a new service pack (TSLEVEL) of SAS has been installed at
your site.


__  1. (CONDITIONAL) Stop the Q&R Mainframe Server

       If you are using the CA MICS Q&R Mainframe Server
       with this complex, you must stop the server.

       See the CA MICS Q&R Workstation Administrator
       Guide for general information about stopping the
       Q&R Mainframe Server.

__  2. (OPTIONAL) Create CA MICS SAS Libraries

       Create CA MICS SAS libraries.  You can reference your
       site SAS libraries, and skip this step.

       +----------------------------------------------------+
       | Reference(s): Section 3.3.1 (SAS Libraries)        |
       +----------------------------------------------------+

       Modify the sample job shown below to populate the
       CA MICS SAS libraries from your new SAS installation
       libraries by doing the following:

       __ If you are using SAS 9.2 or above, use the ISASCNTL
          and OSASCNTL DD statements with the CONFIG data set
          by uncommenting them and commenting the ones with
          the CNTL data set.

       __ Change sasprefix to the data set qualifier of the
          new SAS libraries.

          Note that with SAS 9.1.3 or above, sasprefix may
          include language and encoding abbreviation (e.g. W0
          and ENW0).

       __ Change micssasprefix to the data set qualifiers
          that are valid for your CA MICS installation.

       __ Add a JOB statement to the JCL and any installation
          specific JCL.

          //COPY1    EXEC PGM=IEBCOPY,REGION=2M
          //SYSPRINT DD SYSOUT=*
          //SYSUT1   DD UNIT=SYSDA,SPACE=(CYL,(1,1))
          //SYSUT2   DD UNIT=SYSDA,SPACE=(CYL,(1,1))
          //ISASENV  DD DISP=SHR,DSN=saspfx.TKMVSENV
          //ISASAUTO DD DISP=SHR,DSN=saspfx.W0.AUTOLIB
          //ISASCNTL DD DISP=SHR,DSN=saspfx.CNTL
          //*ISASCNTL DD DISP=SHR,DSN=saspfx.CONFIG
          //ISASLIB  DD DISP=SHR,DSN=saspfx.LIBRARY
          //ISASMSG  DD DISP=SHR,DSN=saspfx.ENW0.SASMSG
          //*
          //OSASENV  DD DSN=micssaspfx.TKMVSENV,
          //*           DISP=OLD
          //*           DISP=(,CATLG),LIKE=saspfx.TKMVSENV
          //OAUTOLIB DD DSN=micssaspfx.W0.AUTOLIB
          //*           DISP=OLD
          //*           DISP=(,CATLG),LIKE=saspfx.W0.AUTOLIB
          //OSASCNTL DD DSN=micssaspfx.CNTL
          //*           DISP=OLD
          //*           DISP=(,CATLG),LIKE=saspfx.CNTL
          //*OSASCNTL DD DSN=micssaspfx.CONFIG
          //*           DISP=OLD
          //*           DISP=(,CATLG),LIKE=saspfx.CONFIG
          //OSASLIB  DD DSN=micssaspfx.LIBRARY
          //*           DISP=OLD
          //*           DISP=(,CATLG),LIKE=saspfx.LIBRARY
          //OSASMSG  DD DSN=micssaspfx.ENW0.SASMSG
          //*           DISP=OLD
          //*           DISP=(,CATLG),LIKE=saspfx.SASMSG
          //SYSIN    DD *
            COPY INDD=((ISASENV,R)),OUTDD=OSASENV
            COPY INDD=((ISASAUTO,R)),OUTDD=OSASAUTO
            COPY INDD=((ISASCNTL,R)),OUTDD=OSASCNTL
            COPY INDD=((ISASLIB,R)),OUTDD=OSASLIB
            COPY INDD=((ISASMSG,R)),OUTDD=OSASMSG
          /*
          //COPY2    EXEC PGM=IEBGENER,REGION=1M
          //SYSPRINT DD SYSOUT=*
          //SYSUT1   DD DISP=SHR,DSN=saspfx.ENW0.SASHELP
          //SYSUT2   DD DISP=OLD,DSN=micssaspfx.ENW0.SASHELP
          //SYSIN    DD DUMMY

       __ Submit the job and ensure that it finishes with a
          return code of 0.

__  3. Update JCLDEFC

       Review the reference for information about defining
       JCLGEN parameters for SAS.  Edit
       sharedprefix.MICS.PARMS(JCLDEFC) and update the
       following parameters with information that is
       applicable to the new SAS release or library name:

          SASAUTOS  SASCONFIGx  SASHELP     SASENV
          SASLIB    SASMSG      SASNAME     SASVER

       ******************************************************
       * Reference(s): Section 2.3.1.6.2 (JCLGEN)           *
       ******************************************************

__  4. Rename Libraries

       Edit sharedprefix.MICS.CNTL(JCLGEN0), changing the
       SASPFX= value on the EXEC statement for the MICSDM
       in-stream cataloged procedure.

__  5. Execute JCLGEN0

       Submit the following job:

         'sharedprefix.MICS.CNTL(JCLGEN0)'

       Ensure that there are no error messages in SYSTSPRT or
       in MICSLOG and that the last MICSLOG message is the
       normal termination message, BAS10999.

__  6. Execute PROCJOB1

       The following JCL procedures changed:

         MICSCOM  MICSDM  MICSDOC  MICSDOCH MICSGT  MICSGU
         MICSRPTS MICSSVR MICSASM

       Move them to your CA MICS PROCLIB by submitting the
       following job:

         'sharedprefix.MICS.CNTL(PROCJOB1)'

       Ensure that there are no error messages and that the
       job completes with a condition code of zero.  If you
       maintain PROCs in a production PROCLIB, copy the
       regenerated procedures listed above to your production
       PROCLIB.

__  7. (CONDITIONAL) Execute JCLGEN1

       Perform this step only if you have the CA MICS
       Accounting and Chargeback product installed.

       Submit the following job:

         'sharedprefix.MICS.CNTL(JCLGEN1)'

       Ensure that there are no error messages in SYSTSPRT or
       in MICSLOG and that the last MICSLOG message is the
       normal termination message, BAS10999.

__  8. (CONDITIONAL) Execute JCLGEN3

       Perform this step only if you use CA MICS
       Q&R Workstation.

       Submit the following job:

         'sharedprefix.MICS.CNTL(JCLGEN3)'

       Ensure that there are no error messages in SYSTSPRT or
       in MICSLOG and that the last MICSLOG message is the
       normal termination message, BAS10999.

__  9. (CONDITIONAL) Execute TMPLTJOB

       Perform this step only if you use CA MICS
       Q&R Workstation.

       Submit the following job:

         'sharedprefix.MICS.CNTL(TMPLTJOB)'

       Ensure that the job completes with a condition code 0.

*************************************************************
*  Repeat the following steps for each database unit.       *
*************************************************************

__ 10. Suspend Production Operations

       NOTE: If you are upgrading from SAS Version 8 to
       SAS 9.1.3 or above and you enabled incremental
       update for one or more products in any of the unit
       databases, make sure the final DAILY job was run.


       Suspend production operations for the unit database by
       using the Operational Status and Tracking SUSPEND
       command in MWF to deactivate production scheduling.

__ 11. Edit JCLDEF

       Edit prefix.MICS.PARMS(JCLDEF) and update the
       following parameters with information that is
       applicable to the new SAS release or library name:

         SASAUTOS  SASCONFIGx  SASHELP     SASENV
         SASLIB    SASMSG      SASNAME     SASVER

       ******************************************************
       * Note:  If you are taking advantage of JCLGEN       *
       *        parameter sharing, then these parameters    *
       *        might not be specified in                   *
       *        prefix.MICS.PARMS(JCLDEF).                  *
       *                                                    *
       *        If SASVER is the only parameter that        *
       *        required a change, proceed to the final     *
       *        step in this checklist.                     *
       ******************************************************

       ******************************************************
       * Reference(s): Section 2.3.3.2 (JCLGEN)             *
       *               Section 2.3.1.6.7 (Parameter Sharing)*
       ******************************************************


       Suspend production operations for the unit database by
       using the Operational Status and Tracking SUSPEND
       command in MWF to deactivate production scheduling.

__ 12. Execute JCLGENA

       Regenerate the CNTL members by submitting the
       following job:

         'prefix.MICS.CNTL(JCLGENA)'

       Ensure that there are no error messages in SYSTSPRT or
       in MICSLOG and that the last MICSLOG message is the
       normal termination message, BAS10999.

__ 13. (CONDITIONAL) Execute PROCJOB2

       The following JCL procedures changed:

         MICSDUx  MICSNDBx

       Move them to your CA MICS PROCLIB by submitting the
       following job:

         'prefix.MICS.CNTL(PROCJOB2)'

       Ensure that there are no error messages and that the
       job completes with a condition code of zero.

       If you maintain PROCs in a production PROCLIB, copy
       the regenerated procedures listed above to your
       production PROCLIB.

__ 14. Execute JCLGENC

       Regenerate the CNTL members by submitting the
       following job:

         'prefix.MICS.CNTL(JCLGENC)'

       Ensure that there are no error messages in SYSTSPRT or
       in MICSLOG and that the last MICSLOG message is the
       normal termination message, BAS10999.

__ 15. (CONDITIONAL) Execute PROCJOB3

       The following JCL procedures changed:

         MICSDBx  MICSSHRx

       Move them to your CA MICS PROCLIB by submitting the
       following job:

         'prefix.MICS.CNTL(PROCJOB3)'

       Ensure that there are no error messages and that the
       job completes with a condition code of zero.  If you
       maintain PROCs in a production PROCLIB, copy the
       regenerated procedures listed above to your production
       PROCLIB.

__ 16. Execute JCLGEND

       Submit the following job:

         'prefix.MICS.CNTL(JCLGEND)'

       Ensure that there are no error messages in MICSLOG;
       that the last message is the normal termination
       message, BAS10999; and that the job completes with a
       condition code of zero.

__ 17. Resume Daily Operations

       Resume the CA MICS Daily operation of the current
       database unit.

*************************************************************
*  Repeat the above steps for each database unit.           *
*************************************************************

__ 18. (CONDITIONAL) Start the Q&R Mainframe Server

       If you are using the CA MICS Q&R Mainframe Server
       with this complex, restart the server.

__ 19. (CONDITIONAL) Activate CLIST

       If the name of the CA MICS SAS load library has
       changed, review the reference on the CA MICS
       Workstation Facility (MWF) startup CLIST.

       ******************************************************
       * Reference(s): Section 3.3.6.2                      *
       ******************************************************

__ 20. Review Instructions

       Review the instructions on updating MWF with the new
       SAS version's parameter and data set name information.

       ******************************************************
       * Reference(s): Section 4.4.2.3                      *
       ******************************************************