{
{   The purpose of this request is to provide information about an item in the
{ permanent file system.  The item may be a catalog or a file.  If the item is
{ a catalog, the catalog_info_selections parameter determines what information
{ will be returned for the catalog.  If the item is a file, the
{ file_info_selections parameter determines what information will be returned
{ for the file.  If the type of the item is not known by the program making
{ the request, options from both the catalog_info_selections and the
{ file_info_selections can be selected.  The type of the item can then be
{ determined from the directory information returned by the request.
{
{   Information will be returned for a catalog 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 catalog 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 file 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.
{
{       PFP$GET_ITEM_INFO (PATH, GROUP, CATALOG_INFO_SELECTIONS,
{                            FILE_INFO_SELECTIONS, P_INFO, STATUS)
{
{ PATH: (input) This parameter specifies the identification of an item for
{       which information is to be provided.  The path parameter consists of
{       an array of names which identify the path leading through a catalog
{       hierarchy to the desired item.  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.
{       The last name in the path specifies the item for which information is
{       to be provided.  The item may be a catalog or a file.  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 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 if the item is a 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 if
{       the item is a file.
{
{ 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$pf_system_error
{                    pfe$bad_family_name
{                    pfe$bad_user_name
{                    pfe$bad_account_name
{                    pfe$bad_project_name
{                    pfe$bad_group_type
{                    pfe$bad_master_catalog_name
{                    pfe$bad_nth_subcatalog_name
{                    pfe$unknown_family
{                    pfe$unknown_master_catalog
{                    pfe$unknown_nth_subcatalog
{                    pfe$nth_name_not_subcatalog
{                    pfe$path_too_short
{                    pfe$bad_item_name
{                    pfe$unknown_item
{                    pfe$info_full
{
