{
{    The purpose of this request is to change the residence of permanent file
{ cycle from 'offline' to 'releasable' after data for the cycle has been
{ successfully retrieved to mass storage.  The cycle only becomes available
{ when the residence has been changed to 'releasable'.  After an unsuccessful
{ retrieval, the residence remains 'offline' to prevent access to a partially
{ retrieved cycle which can occur as the result of an error while restoring the
{ data.
{
{       PFP$CHANGE_RES_TO_RELEASABLE (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 for
{       which the residence is to be changed.  If PFC$LOWEST_CYCLE is
{       specified, the residence of the lowest cycle of the file will be
{       changed to releasable.  If PFC$HIGHEST_CYCLE is specified, the highest
{       cycle of the file will be changed to releasable.  If a specific cycle
{       is specified, that cycle will be changed to releasable
{
{ 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.
{
{        CONDTIONS:  pfe$bad_cycle_number
{                    pfe$bad_cycle_option
{                    pfe$bad_family_name
{                    pfe$bad_master_catalog_name
{                    pfe$bad_nth_subcatalog_name
{                    pfe$bad_password
{                    pfe$bad_permanent_file_name
{                    pfe$data_not_immediate_released
{                    pfe$data_not_releasable
{                    pfe$incorrect_password
{                    pfe$invalid_ring_access
{                    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
{
