{
{   The purpose of this request is to purge a subcatalog from a catalog.  The
{ name of the subcatalog is identified by the last name of the path parameter.
{ The catalog in which the subcatalog is registered is identified by the
{ remainder of the path parameter.
{
{   Before a catalog may be purged, it must be empty.  This can be achieved
{ by purging all files and subcatalogs registered in it.
{
{   This request only allows subcatalogs to be purged from a catalog owned by
{ the user making the request.  In addition, this request does not allow a
{ master catalog to be purged.  Master catalogs are purged as a function of
{ the administer_validations utility.
{
{       PFP$PURGE_CATALOG (PATH, STATUS)
{
{ PATH: (input) This parameter specifies the identification of a subcatalog.
{       The path parameter consists of an array of names which identify the
{       path leading through a catalog hierarchy to the desired subcatalog.
{       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
{       subcatalog that is 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.
{
{ STATUS: (output) This parameter returns the request status.
{       CONDITIONS:
{             pfe$bad_family_name
{             pfe$bad_last_subcatalog_name
{             pfe$bad_master_catalog_name
{             pfe$bad_nth_subcatalog_name
{             pfe$cannot_purge_master_catalog
{             pfe$catalog_not_empty
{             pfe$last_name_not_subcatalog
{             pfe$not_master_catalog_owner
{             pfe$nth_name_not_subcatalog
{             pfe$path_too_short
{             pfe$pf_system_error
{             pfe$unknown_family
{             pfe$unknown_last_subcatalog
{             pfe$unknown_master_catalog
{             pfe$unknown_nth_subcatalog
{
