{
{   The purpose of this request is to put archive entries contained in an info
{ record into the permanent file catalog for a file cycle.  The format of the
{ info record is the the same as the format of the list returned by
{ PFP$GET_ITEM_INFO.  The info record may contain one or more archive entries
{ created by one or more archiving applications.  If one or more archive
{ entries already exist for the file cycle, normal status is returned and the
{ existing archive entries will be unchanged.
{
{       PFP$PUT_ARCHIVE_INFO (PATH, CYCLE_SELECTOR, P_INFO_RECORD, STATUS)
{
{ PATH: (input)  This parameter specifies the identification of a file for
{       which archive entries are to be placed in the permanent file catalog.
{       The path parameter consists of an array of names which identify the
{       path leading through a catalog hierarchy to the desired file.  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 file for which
{       archive entries are to be placed in the permanent file catalog.  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.  The file must
{       already exist.
{
{ CYCLE_SELECTOR: (input)  This parameter selects the permanent file cycle for
{       which information is to be registered.  The cycle number determined by
{       this parameter will be used rather than the cycle number contained in
{       the cycle_array_entry parameter.
{
{ P_INFO_RECORD: (input)  This parameter specifies a pointer to the archive
{       list which is to be placed in the permanent file catalog.  The list in
{       the same format as the information returned by PFP$GET_ITEM_INFO.
{
{ STATUS: (output) This parameter returns the request status.
{
{        CONDITIONS: pfe$bad_archive_identification
{                    pfe$bad_cycle_number
{                    pfe$bad_cycle_option
{                    pfe$bad_family_name
{                    pfe$bad_last_subcatalog_name
{                    pfe$bad_master_catalog_name
{                    pfe$bad_nth_subcatalog_name
{                    pfe$bad_permanent_file_name
{                    pfe$catalog_full
{                    pfe$name_not_permanent_file
{                    pfe$nth_name_not_subcatalog
{                    pfe$path_too_short
{                    pfe$pf_system_error
{                    pfe$unknown_archive_application
{                    pfe$unknown_archive_ident
{                    pfe$unknown_family
{                    pfe$unknown_last_subcatalog
{                    pfe$unknown_master_catalog
{                    pfe$unknown_nth_subcatalog
{                    pfe$unknown_permanent_file
{
