{
{   The purpose of this request is to replace the first archive entry in the
{ archive list for the file cycle which has an archive identification which
{ matches the archive identification specified by the ARCHIVE_IDENTIFICATION
{ parameter.
{
{       PFP$REPLACE_ARCHIVE_ENTRY (PATH, CYCLE_SELECTOR,
{         ARCHIVE_IDENTIFICATION, 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 replaced 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 replaced 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 replaced in the permanent file catalog.
{       The cycle number determined by this parameter will be used rather than
{       the cycle number contained in the cycle_array_entry parameter.
{
{ ARCHIVE_IDENTIFICATION: (input)  This parameter specifies the identification
{       of the archiving application.  The identification consists of the
{       archive application name and a media identifier.  The archive
{       identification is used to locate an archive entry which belongs to the
{       archiving application which owns one of the archive entries for the
{       file.  The media identifier consists of a media device class and a
{       media volume identifier.  If the media device class is specified as
{       OSC$NULL_NAME, the most recently created archive entry belonging to the
{       archive application will be replaced.  If the media volume identifier
{       is specified as OSC$NULL_NAME, it will be ignored in the search for a
{       matching archive entry.  If the media device class and the media volume
{       identifier are both not OSC$NULL_NAME, the most recently created
{       archive entry which matches both will be replaced.
{
{ P_ARCHIVE_ARRAY_ENTRY: (input)  This parameter specifies a pointer to the
{       archive entry which is to replace the existing archiving entry 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 replace the existing archive media descriptor
{       associated 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
{
