{
{   The purpose of this request is to alter the permanent file name, cycle
{ number, password, log selection, retention period and/or charge attributes
{ associated with a permanent file.  The permanent file name, password, log
{ selection and charge identifications are attributes which are common to all
{ cycles of a permanent file.  The cycle number and retention period are
{ attributes which are unique for each cycle of a permanenet file.
{
{   This request can only be issued by a user with CONTROL permission.
{
{       PFP$CHANGE (PATH, CYCLE_SELECTOR, PASSWORD, CHANGE_LIST, 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 changed.  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 changed.  If PFC$LOWEST_CYCLE is specified, the lowest cycle
{       of the file will be changed.  If PFC$HIGHEST_CYCLE is specified, the
{       highest cycle of the file will be changed.  If a specific cycle is
{       specified, that cycle will be changed.  Cycle selection is only
{       applicable for changes to cycle related information such as cycle
{       number and retention period.
{
{ 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.
{
{ CHANGE_LIST: (input) This parameter specifies an array of change
{       descriptors.  Each change descriptor specifies which attribute
{       is to be changed and what the new value of the attribute is to
{       be.  The attributes that can be changed are:  permanent file
{       name, password, cycle number, retention period, logging selection,
{       charge information and cycle damage conditions.
{       If a charge change is specified, the
{       account and project of the job making the request will be used as
{       the new ones to be charged for the file.
{
{ STATUS: (output) This parameter returns the request status.
{
{        CONDITIONS: pfe$bad_change_type
{                    pfe$bad_cycle_number
{                    pfe$bad_cycle_option
{                    pfe$bad_family_name
{                    pfe$bad_log_option
{                    pfe$bad_master_catalog_name
{                    pfe$bad_nth_subcatalog_name
{                    pfe$bad_password
{                    pfe$bad_permanent_file_name
{                    pfe$bad_permanent_file_name
{                    pfe$bad_retention_period
{                    pfe$catalog_full
{                    pfe$duplicate_cycle
{                    pfe$incorrect_damage_condition
{                    pfe$incorrect_password
{                    pfe$name_already_permanent_file
{                    pfe$name_already_subcatalog
{                    pfe$name_already_used
{                    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_master_catalog
{                    pfe$unknown_nth_subcatalog
{                    pfe$unknown_permanent_file
{                    pfe$usage_not_permitted
{
{        IDENTIFIER: pfc$permanent_file_manager_id
{
