{                                                                                                             
{   The purpose of this request is to find the cycle entry for a particular                                   
{ cycle from among those contained in a cycle array.  The array index for the                                 
{ selected cycle is returned.  The version 2 cycle array subrecord contains                                   
{ more information than the cycle array which is returned by                                                  
{ PFP$FIND_CYCLE_ENTRY.                                                                                       
{                                                                                                             
{       PFP$FIND_CYCLE_ENTRY_VERSION_2 (P_CYCLE_ARRAY, CYCLE_SELECTOR,                                        
{             CYCLE_INDEX, STATUS)                                                                            
{                                                                                                             
{ P_CYCLE_ARRAY: (input)  This parameter specifies the cycle array that is to                                 
{       be searched to find a particular cycle entry.                                                         
{                                                                                                             
{ CYCLE_SELECTOR: (input)  This parameter selects the permanent file cycle for                                
{       which the cycle entry is desired.  If PFC$LOWEST_CYCLE is specified,                                  
{       the cycle entry for the lowest numbered cycle in the cycle array will                                 
{       be found.  If PFC$HIGHEST_CYCLE is specified, the cycle entry for the                                 
{       highest numbered cycle in the cycle array will be found.  If a specific                               
{       cycle is specified, the cycle entry for that cycle number will be found                               
{       in the cycle array.                                                                                   
{                                                                                                             
{ CYCLE_INDEX: (output)  This parameter returns the index into the cycle array                                
{       of the desired cycle entry.                                                                           
{                                                                                                             
{ STATUS: (output) This parameter returns the request status.                                                 
{       If the pfe$unknown_cycle condition is returned, it is the callers                                     
{       responsibility to reset the status to correctly set both file name                                    
{       and cycle number.                                                                                     
{                                                                                                             
{       CONDITIONS:                                                                                           
{             pfe$unknown_cycle                                                                               
{             pfe$bad_cycle_option                                                                            
{             pfe$bad_cycle_number                                                                            
{                                                                                                             
