{
{   The purpose of this request is to delete a permanent file cycle.
{
{   Only a user with control access permission may delete a file cycle.
{
{   If the file cycle is in use at the time the purge is requested, the actual
{ deletion is not done until all accessors have detached the cycle.  Permanent
{ file requests to access the cycle will not be accepted once a purge has been
{ initiated.  Once all cycles of the file have been deleted, the file is no
{ longer registered in the catalog.
{
{       PFP$PURGE (PATH, CYCLE_SELECTOR, PASSWORD, STATUS)
{
{ PATH: (input) This parameter specifies the identification of the permanent
{       file.  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 specifies the permanent file
{       that is to be purged.  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.
{
{ CYCLE_SELECTOR: (input) This parameter selects the permanent file cycle that
{       is to be purged.  If pfc$lowest_cycle is specified, the lowest cycle
{       of the file will be purged.  If pfc$highest_cycle is specified, the
{       highest cycle of the file will be purged.  If a specific cycle is
{       specified, that cycle will be purged.
{
{ PASSWORD: (input) This parameter specifies a password that must match the
{       password registered with the file.  If a blank password is specified,
{       it will only match if no password was registered with the file.
{
{ STATUS: (output) This parameter returns the request status.
{       CONDITIONS:
{             ame$damaged_file_attributes
{             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_password
{             pfe$bad_permanent_file_name
{             pfe$incorrect_password
{             pfe$invalid_ring_access
{             pfe$last_name_not_subcatalog
{             pfe$name_not_permanent_file
{             pfe$nth_name_not_subcatalog
{             pfe$path_too_short
{             pfe$pf_system_error
{             pfe$unknown_cycle
{             pfe$unknown_family
{             pfe$unknown_last_subcatalog
{             pfe$unknown_master_catalog
{             pfe$unknown_nth_subcatalog
{             pfe$unknown_permanent_file
{             pfe$usage_not_permitted
{
