{       PFP$COLLECT_FILE_INFORMATION
{
{
{   The purpose of this request is to collect information about files and
{ sub-catalogs that appear in a catalog.  This request selects what
{ information to collect.  After collecting the information, the user enters
{ a PFP$GET_NEXT_FILE_SELECTION request to extract the collected information.
{   Information will only be collected for one level of catalog.  Repeated
{ calls to pfp$collect_file_information must be made to traverse the catalog
{ structure.
{
{       PFP$COLLECT_FILE_INFORMATION (PATH, FILE_SELECTIONS, SELECTION_ID,
{                                     STATUS)
{
{ PATH: (input) This parameter specifies the identification of a catalog.
{       The path parameter consists of an array of names which identify the
{       path in the catalog hierarchy to the desired catalog.  The first name
{       specifies the family name.  The second name specifies the master
{       catalog name.  By convention the name of a user's master catalog
{       name is the same as the user name.  Subsequent names specify any
{       additional sub-catalogs.  The last name in the path specifies the
{       catalog to which the file selections will apply.  Null names are
{       allowed only for the family name and the master catalog name.  If the
{       family name is OSC$NULL_NAME, the family name of the job making the
{       request will be used.  If the master catalog name is OSC$NULL_NAME,
{       the user name of the job making the request will be used.
{
{ FILE_SELECTIONS: (input) This parameter specifies what information is to be
{       collected.  If there is no information of the selected type(s) in the
{       catalog, the error pfe$no_records_collected will be returned.  The
{       following selections are available:
{
{           Selection            Meaning
{
{           pfc$catalog_names    Collect sub-catalog names.
{           pfc$file_names       Collect file names.
{           pfc$file_cycles      Collect file names and cycle numbers.
{
{ SELECTION_ID: (output) This parameter returns the identifier assigned to
{       this instance of the pfp$collect_file_information request.
{
{ STATUS: (output) This parameter returns the request status.
{
{       CONDITIONS: pfe$collection_limit_exceeded
{                   pfe$no_records_collected
{                   pfe$null_file_selections
{
{       IDENTIFIER: pfc$permanent_file_manager_id
{
