{
{   The purpose of this request is to add an archive entry to the archive list
{ for a specified file cycle.  The archive entry is placed at the front of the
{ list of archive entries for the file cycle (the archive media descriptor
{ which is associated with the archive entry is stored in a separate container
{ in the permanent file catalog).
{
{       PFP$PUT_ARCHIVE_ENTRY (PATH, CYCLE_SELECTOR, P_ARCHIVE_ARRAY_ENTRY,
{         P_AMD, STATUS)
{
{ PATH: (input)  This parameter specifies the identification of a file for
{       which an archive entry is to be stored 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 an
{       archive entry is to be stored 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 an archive entry is to be added to the archive list.
{
{ P_ARCHIVE_ARRAY_ENTRY: (input)  This parameter specifies a pointer to the
{       archive entry which is to be stored in the catalog.  The entry pointed
{       to is in the format in which PFP$GET_ITEM_INFO retrieves it.
{
{ P_AMD: (input)  This parameter specifies a pointer to the archive media
{       descriptor which is to be stored with the archive entry.
{
{ 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
{
