{
{   The purpose of this request is to provide information about the items
{ registered in a catalog.  The catalog selected is determined by the path
{ parameter.  Information may be requested for subcatalogs, files or both.
{ The catalog_info_selections parameter determines what information will be
{ returned for the subcatalogs registered in the catalog.  The
{ file_info_selections parameter determines what information will be returned
{ for the files registered in the catalog.
{
{   Information will be returned for a subcatalog item only if the user making
{ the request is the owner of the catalog or has been granted access, via the
{ permit mechanism, to one or more files registered in the subcatalog or a
{ subcatalog below it in the permanent file system tree.  Information will be
{ returned for a file item only if the user making the request is the owner
{ of the catalog or has been granted access to the file via the permit
{ mechanism.  Only the owner of an item will be given information relative to
{ another user.
{
{   In addition to returning information about items in a catalog this
{ interface will attach each cycle that satisfies the criteria specified
{ in the p_cycle_reservation_criteria parameter.  The cycles will be attached
{ with access_mode=(read) and share_mode=(read execute).  These attachments
{ are registered in the catalog only, the ATTACHED_PF_TABLE and BAM tables
{ are not modified.  Cycles attached in this manner must be detached using
{ the pfp$detach_reserved_cycles interface.
{
{   This interface is designed to improve the performance of the
{ BACKUP_PERMANENT_FILES utility and should not be used by any other product
{ without permission of the PERMANENT_FILES project.
{
{       PFP$GET_RESERVED_ITEM_INFO (PATH, GROUP, CATALOG_INFO_SELECTIONS,
{             FILE_INFO_SELECTIONS, P_CYCLE_RESERVATION_CRITERIA, P_INFO,
{             STATUS)
{
{ PATH: (input) This parameter specifies the identification of the desired
{       catalog.  The path parameter consists of an array of names which
{       identify the path leading through a catalog hierarchy to the desired
{       catalog.  The first two names specify the family name and master
{       catalog name portion of the path.  By convention, the name of a
{       user's master catalog is the same as the user name.  Subsequent
{       names would specify subcatalogs as applicable.  Information is
{       returned for items registered in the catalog specified by the last
{       name in the path.  Null names are allowed only for the family name
{       and 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.
{
{ GROUP: (input) This parameter allows the information returned to be limited
{       to that pertaining to a user or group of users.  The group can include
{       all users (public), all users of a particular family, all users of a
{       particular account, all users of a particular project, a specific user,
{       a specific user while running under a specific account, or a specific
{       user while running under a specific account and project.  Only the
{       owner of an item will be given information relative to another user.
{
{ CATALOG_INFO_SELECTIONS: (input) This parameter specifies a set of the
{       possible pieces of catalog information that is to be returned by the
{       request for subcatalog items registered in the selected catalog.
{
{ FILE_INFO_SELECTIONS: (input) This parameter specifies a set of the possible
{       pieces of file information that is to be returned by the request for
{       file items registered in the selected catalog.
{
{ P_CYCLE_RESERVATION_CRITERIA: (input) This parameter specifies the criteria
{       which will determine if cycles in the specified catalog will be
{       reserved.  If a NIL pointer is supplied for this parameter, no cycles
{       will be reserved.
{
{ P_INFO: (output) This parameter specifies a container to hold the information
{       returned by the request.
{
{ STATUS: (output) This parameter returns the request status.
{
{       CONDITIONS:
{            pfe$bad_account_name
{            pfe$bad_family_name
{            pfe$bad_group_type
{            pfe$bad_last_subcatalog_name
{            pfe$bad_master_catalog_name
{            pfe$bad_nth_subcatalog_name
{            pfe$bad_project_name
{            pfe$bad_user_name
{            pfe$info_full
{            pfe$last_name_not_subcatalog
{            pfe$nth_name_not_subcatalog
{            pfe$path_too_short
{            pfe$pf_system_error
{            pfe$unknown_family
{            pfe$unknown_last_subcatalog
{            pfe$unknown_master_catalog
{            pfe$unknown_nth_subcatalog
{
