{
{   The purpose of this request is to delete the first archive entry in a file
{ cycle's archive list which has an archive identification which matches the
{ archive identification specified by the ARCHIVE_IDENTIFICATION parameter.
{
{       PFP$DELETE_ARCHIVE_ENTRY (PATH, CYCLE_SELECTOR, ARCHIVE_IDENTIFICATION,
{         STATUS)
{
{ PATH: (input)  This parameter specifies the identification of a file for
{       which archive entries are to be deleted.  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
{       deleted.  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 deleted.
{
{ ARCHIVE_IDENTIFICATION: (input)  This parameter specifies the identification
{       of the archiving application.  The identification consists of an
{       application identifier and a media identifier.  The application
{       identifier identifies the archiving application.  The media identifier
{       consists of a media device class and a media volume identifier.  The
{       entire archive identification is used to locate the archive entry which
{       is to be deleted.
{
{ 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$invalid_archive_appl_name
{                    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
{
