{
{    The purpose of this request is to alter the permanent file name, cycle
{ number, password, log selection, retention period, charge attributes, damage
{ conditions, retrieve option, shared queue, site archive option, site backup
{ option and site release option 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, retention period, damage conditions, retrieve option, shared queue,
{ site archive option, site backup option and site release option are
{ attributes which are unique for each cycle of a permanent file.
{
{    This request can only be issued by a user with CONTROL permission.
{
{       FSP$CHANGE_FILE (FILE, PASSWORD, CHANGE_LIST, STATUS)
{
{ FILE: (input)  This parameter specifies the name of the file cycle whose
{       attributes are to be changed.  The cycle reference must be capable of
{       being resolved to an existing cycle or an abnormal status will be
{       returned; therefore, this parameter must not specify a $NEXT cycle
{       reference.
{
{ 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.
{
{ FILE_CHANGES: (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, cycle number,
{       password, log selection, retention period, charge attributes, damage
{       conditions, retrieve option, shared queue, site archive option, site
{       backup option and site release option.  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$change_requires_privilege
{                    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$no_site_option_validation
{                    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
{
