RAP_LONGSYN_PCT keyword

Use the RAP_LONGSYN_PCT keyword to specify a threshold setting for the percentage of RAPs that have a long synonym chain among all the RAPs that are used. With this keyword, you specify a threshold value and the lower bound for synonym chain length.

FPA evaluates all the RAPs that are used, calculates the percentage of the RAPs that have a longer synonym chain than the lower bound, and compares the calculated value against the threshold. If the value exceeds the threshold, FPA issues a warning message.

RAP_LONGSYN_PCT is an optional keyword for the THRESHOLD subcommand, and can be used with the TUNE command.

Related keywords:
SYN_PCT_LEN keyword
Format:
Read syntax diagramSkip visual syntax diagramRAP_LONGSYN_PCT=( threshold, lower_bound)
threshold
Specify the threshold value in the range of 0 - 100 for the percentage of RAPs that have a long synonym chain.
lower_bound
Specify the lower bound in the range of 1 - 99. FPA regards any RAP that has the number of synonyms equal to or greater than the lower bound as a RAP with a long synonym chain.

FPA evaluates the threshold by using the following expression:

                    max
                    ∑(Number of RAPs that have n root segments)
                    n=lower_bound + 1
PCT(lower_bound) = ──────────────────────────────────────────────────────── * 100 > threshold
                    max
                    ∑(Number of RAPs that have n root segments)
                    n=1

For example, assuming that the ROOTS PER RAP DISTRIBUTION GRAPH section in the DEDB Area Analysis reports displays the following graph:

ROOTS PER RAP DISTRIBUTION GRAPH                                      
                                                            1         
               1    2    3    4    5    6    7    8    9    0         
               0    0    0    0    0    0    0    0    0    0   % RAPS
           --------------------------------------------------         
   #    0-|********************   (48050)                             
        1-|******************   (43996)                               
   R    2-|********   (20056)                                         
   O    3-|***   (6201)                                               
   O    4-|*   (1364)                                                 
   T    5-|*   (280)                                                  
   S    6-|*   (41)                                                   
        7-|*   (9)                                                    
   /    8-|*   (3)                                                    
        9-|                                                           
   R   10-|                                                           
   A   11-|                                                           
   P   12-|

You specify RAP_LONGSYN_PCT=(10,2). Then, the percentage of RAPs that have two or more synonyms is calculated as follows:

                   (6201 + 1364 + 280 + 41 + 9 + 3)
PCT(lower_bound) = ────────────────────────────────────────────────────────── * 100 = 10.98%
                   (43996 + 20056 + 6201 + 1364 + 280 + 41 + 9 + 3)

Because the resulted value exceeds the value that you specified with the threshold parameter, which is 10, FPA issues a warning message.

FPA calculates the percentage of RAPs by using the Synonym Chain Analysis table. Therefore, if the value of the SYNTBL keyword that is specified in the HFPAPARM DD or the default value of the SYNTBL keyword is less than or equal to the lower_bound value of the RAP_LONGSYN_PCT keyword, FPA replaces the value of the SYNTBL keyword with the lower_bound value plus 1.

Default:
None.
Site default support:
Not supported.
Alias:
RLP
Keyword abbreviation:
Supported.