CA Endevor Integration for the Natural Environment › The Natural Development Lifecycle › How to Configure a Natural Lifecycle in CA Endevor SCM › How to Add Site Symbolics to Associate Natural with CA Endevor SCM › Associate Any Natural Libraries to CA Endevor SCM Inventory Locations

Associate Any Natural Libraries to CA Endevor SCM Inventory Locations

You can map your Natural libraries to CA Endevor SCM inventory locations using a indirect method of symbolic substitution, if your Natural library names do not follow a standard naming convention. The following method lets you define your Natural libraries to CA Endevor SCM locations, using standard CA Endevor SCM location symbolics and recursive symbol substitution.

To associate any Natural library names to CA Endevor SCM inventory locations

1. Define the symbolics #NTGTLIB and #NSRCLIB using recursive symbol substitution. You can use the following $ESYMBOL definitions provided as JCL member SITESYME to associate any Natural library name to a CA Endevor SCM location.

   $ESYMBOL SYMNAME=#NTGTLIB,
        SYMDATA='&&#N&&C1EN(1,1)&&C1S#&&C1SU' 
   $ESYMBOL SYMNAME=#NSRCLIB,
        SYMDATA='&&#N&&C1SENVMNT(1,1)&&C1SSTGNUM&&C1SSUBSYS'
   

   The #NSRCLIB symbolic indirectly defines the source Natural library from which Natural objects will be moved. The #NTGTLIB symbolic indirectly defines the target Natural library when the following actions are performed: delete, generate, or move. The symbols resolve to a series of other symbols, defined using the #Nxysubsys symbolic, which you must also code in your site symbol table.

2. Define one #Nxysubsys symbolic for each stage and subsystem combination that you want to control using CA Endevor SCM.

   $ESYMBOL SYMNAME=#Nxysubsys,
        SYMDATA='Natural_library_name'
   

   #Nxysubsys

   • x – first character of the environment
   • y – stage number (1 or 2)
   • subsys – subsystem name

   The symbolics #NSRCLIB and #NTGTLIB, when set using recursive symbol substitution, resolve to the series of symbols you define using the #Nxysubsys symbolic. The #Nxysubsys symbolic defines your Natural libraries, which can reside in any combination of one to n FUSER files, where n is the number of stages in your lifecycle. For more information, see Associate Each CA Endevor SCM Stage to a Specific Natural FUSER/FDIC Combination.

Example: Associate Natural Libraries to CA Endevor SCM Inventory Locations Using Indirect Symbolic Substitution

This example uses an indirect method of symbolic substitution to associate Natural library names to CA Endevor SCM locations, assuming that your site's lifecycle is configured as follows:

• It has two environments (QA and PRD) and four stages (two stages in each environment) in the following order:

  QA/1 -> QA/2 -> PRD/1 -> PRD/2

• The subsystem name is NSUB for all stages.
• The library names are not the same.

Define the following site symbolics in your site symbol table (double ampersands are required in the site symbol table):

$ESYMBOL SYMNAME=#NTGTLIB,                                  
     SYMDATA='&&#N&&C1EN(1,1)&&C1S#&&C1SU'               
$ESYMBOL SYMNAME=#NSRCLIB,                                  
     SYMDATA='&&#N&&C1SENVMNT(1,1)&&C1SSTGNUM&&C1SSUBSYS'
$ESYMBOL SYMNAME=#NQ1NSUB,                                
     SYMDATA='NATLIB1'                                     
$ESYMBOL SYMNAME=#NQ2NSUB,                                
     SYMDATA='NATLIB2'                                     
$ESYMBOL SYMNAME=#NP1NSUB,                                
     SYMDATA='NATLIB3'                                     
$ESYMBOL SYMNAME=#NP2NSUB,                                
     SYMDATA='NATLIB4'   

Coding these symbolics, has the following effects:

• The target and source library symbolics #NTGTLIB and #NSRCLIB resolve to the following stage symbols:

  Note: #N is not defined as a site symbol so no substitution takes place.

  • &#NQ1NSUB
  • &#NQ2NSUB
  • &#NP1NSUB
  • &#NP2NSUB
• The value of the secondary symbols resolve to the assigned Natural library name:
  • #NQ1NSUB=NATLIB1
  • #NQ2NSUB=NATLIB2
  • #NP1NSUB=NATLIB3
  • #NP2NSUB=NATLIB4
• Therefore, the symbolics resolve to the following libraries:
  • At QA/1, &#NTGTLIB and &#NSRCLIB resolve to NATLIB1 as your Natural library name.
  • At QA/2, &#NTGTLIB and &#NSRCLIB resolve to NATLIB2 as your Natural library name.
  • At PRD/1, &#NTGTLIB and &#NSRCLIB resolve to NATLIB3 as your Natural library name.
  • At PRD/2, &#NTGTLIB and &#NSRCLIB resolve to NATLIB4 as your Natural library name.