{
{   The purpose of this request is to put information about an item into the
{ permanent file system.  The item may be either a catalog or a file, depending
{ on the contents of the info record specified with the p_info_record
{ parameter.  The name of the item is determined from the path parameter.  If
{ the item is a catalog, an empty catalog is created.  If the item is a file,
{ each cycle of the file will be created in an "undefined data" state, depending
{ on the cycle_selection_criteria parameter.  If archive information is
{ contained in the info record, it is only placed in the catalog entry for the
{ file cycle if the RESTORE_ARCHIVE_INFORMATION parameter is specified as TRUE.
{ Unless a current archive entry exists for a cycle (permitting retrieval of its
{ data from an archive media), it will not be possible to attach the cycle until
{ a PFP$DEFINE_DATA request is used to establish data for it.
{
{   This request only allows subcatalogs to be registered in a catalog owned by
{ the user making the request.  In addition, this request does not allow
{ creation of master catalogs.  Master catalogs are created as a function of
{ the administer utility.
{
{       PFP$PUT_ITEM_INFO (PATH, P_INFO_RECORD, RESTORE_ARCHIVE_INFORMATION,
{         CYCLE_SELECTION_CRITERIA, STATUS)
{
{ PATH: (input)  This parameter specifies the identification of an item for
{       which information is to be registered.  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
{       registered.  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.
{
{ P_INFO_RECORD: (input)  This parameter specifies an info record containing
{       information about an item that is to be registered in the permanent
{       file system.  The info record may be of type pfc$item_info_record,
{       pfc$catalog_group_record or pfc$file_group_record.  This parameter
{       determines if the item to be registered is to be a catalog or a file.
{
{ RESTORE_ARCHIVE_INFORMATION: (input)  This parameter specifies whether or not
{       archive information contained in the info record is to be put into the
{       catalog entry for the file.
{
{ CYCLE_SELECTION_CRITERIA: (input)  This parameter specifies the date and time
{       criteria to be checked when creating the cycles of a file item.  If none
{       of the file's cycles meet the criteria, the file item will be removed.
{       For more information about these criteria, refer to the description of
{       the INCLUDE_CYCLES subcommand of the RESTORE_PERMANENT_FILES utility.
{
{ STATUS: (output) This parameter returns the request status.
{
{       CONDITIONS: pfe$bad_account_name
{                   pfe$bad_cycle_number
{                   pfe$bad_family_name
{                   pfe$bad_group_type
{                   pfe$bad_info_record_format
{                   pfe$bad_item_name
{                   pfe$bad_log_option
{                   pfe$bad_master_catalog_name
{                   pfe$bad_nth_subcatalog_name
{                   pfe$bad_password
{                   pfe$bad_project_name
{                   pfe$bad_user_name
{                   pfe$catalog_full
{                   pfe$info_offset_range_error
{                   pfe$name_already_permanent_file
{                   pfe$name_already_subcatalog
{                   pfe$nth_name_not_subcatalog
{                   pfe$path_too_short
{                   pfe$pf_system_error
{                   pfe$too_many_catalogs_in_path
{                   pfe$unknown_catalog_description
{                   pfe$unknown_cycle
{                   pfe$unknown_cycle_array
{                   pfe$unknown_family
{                   pfe$unknown_file_description
{                   pfe$unknown_info_record
{                   pfe$unknown_master_catalog
{                   pfe$unknown_nth_subcatalog
{
