{
{   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.
{
{       PFP$FIND_CYCLE_ENTRY (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
{
