RR - Component Reference Rules

The following figure displays the component reference rules that are used to determine how parsed reference names are resolved. These rules set a "priority" for the parsing to resolve the names depending on the source Appl, SubAppl, Stream, and Type, and the potential resolved reference Appl and SubAppl.

M.R               REFERENCE DATA MAINTENANCE (PROD)                UPDATE MODE
Command ===>                                                 Scroll ===> CSR

List Commands: A Add, L Locate Entry, B Browse Mode
Line Commands: S Select, D Delete, C Clone, I Import, E Export
               V View, M Modify, A Activate

  Code N/A      N/A      N/A      Vers Version Description Actv Loaded RefrReq
   RR ________ ________ ________ ____ ____________________   _     _
__ RR                             0000 INSTALL VERSION        Y     Y
******************************* Bottom of data ********************************

Component Reference Rules Definition Screen

A list of component reference rules is displayed, as shown in the following figure, after entering the option RR and selecting a version.

M.RR                 REFERENCE RULES TABLE, ver=0           Row     1 of     4
Command ===>                                                  Scroll ===> CSR

List Commands: A Add Entry, L Locate Entry, B Browse Mode
Line Commands: S Select, D Delete

  Appl     SubAppl Stream   Type     Pr RAppl    RSubAppl
   ________ ________ ________ ________ __ ________ ________
__ *        *        *        *        11 =        =
__ *        *        *        *        12 =        *
__ *        *        *        *        13 *        =
__ PLAY     PLAY     PLAY     *        6 =        *
------------------------------- Bottom of List -------------------------------

Detail Screen

The details displayed when a specific Component Reference Rule is selected from the Reference Rules Table screen, are as shown in the following figure.

M.AR                COMPONENT REFERENCE RULE DETAIL (PROD)
Command ===>



Appl               (KEY) ==> PLAY
Sub Appl           (KEY) ==> PLAY
Stream             (KEY) ==> PLAY
Type               (KEY) ==> *
Priority                 ==> 6
Reference Appl     (KEY) ==> =
Reference SubAppl (KEY) ==> *

Field Descriptions

The following table describes each field used to define a Component Reference Rule.

Field Name	Description
Appl	The Application of source elements which, when parsed, will use this component reference rule. Valid values: * (asterisk) indicates any Appl An existing Appl
SubAppl	The SubApplication of source elements which, when parsed, will use this component reference rule. Valid values: * (asterisk) indicates any SubAppl An existing SubAppl
Stream	The Stream of source elements which, when parsed, will use this component reference rule. Valid values: * (asterisk) indicates any Stream An existing Stream
Type	The Type of source elements which, when parsed, will use this component reference rule. Valid values: * (asterisk) indicates any Type An existing Type
Priority	The priority to assign to a reference that matches the Reference Appl and Reference SubAppl when parsing source components that match the previous values in this table. A reference that matches a smaller (closer to 1) priority-value rule is therefore a "better" reference than one that matches a larger (closer to 99) priority-value rule. Valid values: Numeric values between 1 and 99
Reference Appl	The Application of potential references, which will match this rule. Valid values: * (asterisk) indicates any Appl = (equal) indicates the same Appl as the source Appl An existing Appl
Reference SubAppl	The SubAppl of potential references, which will match this rule. Valid values: * (asterisk) indicates any SubAppl = (equal) indicates the same SubAppl as the source SubAppl An existing SubAppl

How Component Reference Rules Work

Whenever source element are parsed, information identifying the component is sent with the name and category value of each reference from the batch parsing job to the Code Pipeline CM started task. When the CM started task resolves these references, it will use the active Component Reference Rules to determine the matching component in the same stream which has the best priority value (closest to 1). When the CM finds that task, it inserts a reference entry linking the source task to that reference.