Previous Topic: 5.1.1 Create a CA MICS Complex from an Existing Complex

Next Topic: 5.2 Change ISPF Library Names

5.1.2 Create a CA MICS Unit from an Existing Unit

************************* Important *************************
*                                                           *
*  Read this entire section before you attempt to build an  *
*  alternate unit from an existing unit.  Follow the        *
*  instructions carefully.                                  *
*                                                           *
*  Ensure that each job submitted throughout this           *
*  checklist completes with a condition code of zero.       *
*  If MICSLOG is present, ensure that it does not contain   *
*  any error messages.                                      *
*                                                           *
*************************************************************

__  1. Execute COPYLIBS (Build Alternate Unit Libraries)


       Submit the following job:

        'sharedprefix.MICS.CNTL(COPYLIBS)'

      +-----------------------------------------------------+
      | Reference(s): Section 3.5.2.1                       |
      +-----------------------------------------------------+

__  2. Copy Data Sets (Alternate Prefix)


       Copy the following data sets using the alternate
       prefix names:

       UNIT-LEVEL DATA SETS

       prefix.MICS.PARMS   (Use ISPF)
       prefix.MICS.MUOLIB  (Use SAS PROC COPY)
       prefix.MICS.USER.SOURCE

__  3. (CONDITIONAL) Create Alternate Unit

 
       (CONDITIONAL) Choose to create an alternate unit from
       an existing unit with data or without data by
       performing one of the following:

       __ (WITH DATA) Use SAS PROC COPY to create an
          alternate unit with SAS data libraries from the
          data in the production unit SAS data libraries.

          These data libraries are:

           prefix.MICS.CHECKPT.DATA
           prefix.MICS.DETAILn
           prefix.MICS.DAYSn
           prefix.MICS.MONTHSn
           prefix.MICS.WEEKSn
           prefix.MICS.YEARSn
           prefix.MICS.ccc.IUDETAIL
           prefix.MICS.ccc.IUDAYS

          Edit the alternate prefix.MICS.CHECKPT.DATA by
          changing the prefix name defined on the first line
          in column 164 through column 185.

       OR

       __ (WITHOUT DATA) Although the prefix libraries listed
          above may be copied from the production unit, you
          may choose to generate an alternate unit with empty
          data libraries.  If you do so, you must submit the
          ALLOCATE job later in this checklist to create the
          SAS data libraries.

       NOTE:  For the rest of this checklist, any references
              to prefix libraries are directing you to the
              alternate prefix libraries.

__  4. Edit prefix.MICS.PARMS(JCLDEF)


       Change the PREFIX, TAPEPREFIX and UNIT ID parameters
       to reflect the alternate prefix and tapeprefix for
       this unit database.

       If a user PROCLIB contains the alternate complex
       PROCs, change the PROCLIB parameter in JCLDEF to
       specify the correct PROCLIB library.

__  5. Edit Other prefix.MICS.PARMS Members


       Edit the members USERJCL, INPUTccc, and IMSSPND (if
       IMS is installed) in the alternate prefix.MICS.PARMS
       and change old prefix references to the alternate
       prefix name.

       If a user PROCLIB contains the alternate complex
       PROCs, change the PROCLIB parameter in USERJCL to
       specify the correct PROCLIB library.

__  6. Edit prefix.MICS.PARMS(JCLNAMES)


       Change the old prefix references to the alternate
       prefix name.

__  7. Delete prefix.MICS.USER.SOURCE(PREFIX)

__  8. Edit and execute JCLGENA


       Point to the correct complex and unit-level data sets
       and submit the following job:

         'prefix.MICS.CNTL(JCLGENA)'
__  9. Review JCL in PROCJOB2


       Check the JCL generated by JCLGENA by examining
       the following members in prefix.MICS.CNTL:

         PROCJOB2   MICSNDB   MICSDU

       If the JCL and JES parameters do not meet your
       installation's standards, update the
       prefix.MICS.PARMS members JCLDEF or USERJCL and
       resubmit JCLGENA.

       +---------------------------------------------------+
       | Reference(s): Section 3.3.3                       |
       +---------------------------------------------------+
__ 10. Execute PROCJOB2

       Move the first group of CA MICS cataloged JCL
       procedures to the PROC library of the alternate
       complex by submitting the following job:

         'prefix.MICS.CNTL(PROCJOB2)'

       +---------------------------------------------------+
       | Reference(s): Section 3.5.4                       |
       +---------------------------------------------------+

__ 11. (CONDITIONAL) Execute JCLGENF

       If this is a SPECIAL unit database, complete this
       step.


       Generate the special database installation jobs.  For
       background execution, submit the following job:

         'prefix.MICS.CNTL(JCLGENF)'
__ 12. Review UNITGEN Options


        Review sharedprefix.MICS.PARMS(UNITGEN) for the
        options in effect.

        +---------------------------------------------------+
        |  Reference(s):  Section 5.6.1                     |
        +---------------------------------------------------+
       Also, in the alternate complex, delete member
       prefix.MICS.PARMS(UGLIST) if it exists.

__ 13. Execute UNITGEN


       Submit the following job:

         'prefix.MICS.CNTL(UNITGEN)'

       Ensure that there are no error messages in MICSLOG or
       SYSTSPRT and that the MICSLOG contains the normal
       termination messages, BAS10999I or BAS11999I.

       If the UNITGEN NOAUTOSUBMIT, or UNITGEN AUTOSUBMIT and
       NOOPJCL parameters have been specified, UNITGEN will
       complete with a normal return code of 4.  Otherwise,
       UNITGEN and UNITGEN1 should complete with a return
       code of 0.
__ 14. (CONDITIONAL) Execute UNITGEN1


       Perform this step only if your installation has
       specified

       UNITGEN NOAUTOSUBMIT

       You must manually submit the UNITGEN1 job to perform
       the required JCL and parameter generations.

       After the UNITGEN job from the previous step
       completes successfully, submit the following job:

         'prefix.MICS.CNTL(UNITGEN1)'
__ 15. Verify UNITGEN1 Results


       Verify that the UNITGEN1 job executed successfully.

       The UNITGEN1 job contains multiple steps that perform
       COPYLIBU, CYCLEGEN, JCLGEN, cccPGEN, and GDGSGEN
       processing or part of it.

       Ensure that there are no error messages in MICSLOG or
       SYSTSPRT and that the MICSLOG contains the normal
       termination messages, BAS10999I or BAS11999I.

       All steps should complete with a return code of zero.

       If errors are encountered during UNITGEN1 job
       execution, correct the errors and rerun UNITGEN and
       UNITGEN1 jobs respectively.

       +--------------------------------------------------+
       |  Reference(s):  Sections 5.6 and 5.6.1           |
       +--------------------------------------------------+
__ 16. Execute PROCJOB3

       Move CA MICS database set-up cataloged JCL procedures
       to the PROC library of the alternate complex by
       submitting the following job:

         'prefix.MICS.CNTL(PROCJOB3)'

       +---------------------------------------------------+
       | Reference(s): Section 3.5.4                       |
       +---------------------------------------------------+

__ 17. (CONDITIONAL) Execute JCLGEND


       Perform this step only if your installation has
       specified

       UNITGEN NOOPJCL

       If NOOPJCL is specified, UNITGEN1 did not generate the
       CA MICS operational jobs.

       To generate these jobs, submit the following job:

         'prefix.MICS.CNTL(JCLGEND)'

       Ensure that there are no error messages in MICSLOG or
       SYSTSPRT and that the MICSLOG contains the normal
       termination messages, BAS10999I or BAS11999I.

       All steps should complete with a return code of zero.

       +---------------------------------------------------+
       |  Reference(s):  Section 5.6.1                     |
       +---------------------------------------------------+
__ 18. (CONDITIONAL) Execute cccGDGGN


       If Detail Tape Processing is active in this unit,
       complete the following steps to define the tape GDG:

       __ Edit prefix.MICS.PARMS(JCLGENU) so that it reads:

          cccGDGGN

          If Incremental Update is active, add this:

          INCRccc

       __ Submit prefix.MICS.CNTL(JCLGENU) to regenerate
          the JCL for cccGDGGN and INCRccc (if applicable).

       __ Submit prefix.MICS.CNTL(cccGDGGN) to define
          the tape GDG.

       +---------------------------------------------------+
       | Reference(s): Chapter 7, ccc Analyzer Guide(s)    |
       +---------------------------------------------------+

__ 19. (CONDITIONAL) Execute ALLOCATE (WITHOUT DATA)


        Allocate the Online Database and associated files.

        __ Edit prefix.MICS.CNTL(ALLOCATE) and fill in the
           SPACE, VOLSER, and UNIT keyword values.

        __ Submit the following job:

            'prefix.MICS.CNTL(ALLOCATE)'

        +---------------------------------------------------+
        | Reference(s): Section 3.5.6.2                     |
        +---------------------------------------------------+

__ 20. (CONDITIONAL) Execute CKPTINIT and cccIUALC


       Submit the following jobs:

        prefix.MICS.CNTL(CKPTINIT) (if WITHOUT DATA)
        prefix.MICS.CNTL(cccIUALC) (if WITHOUT DATA)

__ 21. (CONDITIONAL) Execute ACTINITA


       If Accounting and Chargeback is installed in this
       unit, submit the following job:

         'prefix.MICS.CNTL(ACTINITA)'

       Note:  Review component specific features and
              implementation for additional requirements in
              the appropriate analyzer guide, i.e., TAPECSU,
              TAPEDSU, etc.  Special considerations for
              accounting must also be reviewed if the cloned
              unit had accounting installed and active.

__ 22. Test/Execute DAILY


       Test the DAILY by submitting the following job:

         'prefix.MICS.CNTL(DAILY)'

       +---------------------------------------------------+
       | Reference(s): Section 3.5.7 and Chapter 4         |
       +---------------------------------------------------+

__ 23. (OPTIONAL) Back Up All Libraries (Alternate Unit)


       The code and text for the products on the PSP
       distribution medium are copied directly to your
       sharedprefix.MICS and sharedprefix.MICS.PSP libraries.
       To avoid potential space problems, compress your
       sharedprefix.MICS and PSP libraries before loading the
       new product.