{
{   The purpose of this request is to mark a file cycle which has been
{ duplicated on archive media as a candidate for release.  The mark can be used
{ by an archiving application to indicate that the data for the file cycle can
{ be released after the integrity of the archive media has been established.
{ For example, marking for release is used when archiving to the NOS/170
{ permanent file base to indicate that the NOS/170 file which contains a copy
{ of the file has been backed up.  Data is actually released from mass storage
{ by calling PFP$RELEASE_DATA.  Note that PFP$RELEASE_DATA does not require
{ that the file cycle be marked in order to release it's data from mass
{ storage.
{
{       PFP$MARK_RELEASE_CANDIDATE (PATH, CYCLE_SELECTOR, PASSWORD,
{         ARCHIVE_IDENTIFICATION, 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 released.  If PFC$LOWEST_CYCLE is specified, the lowest cycle
{       of the file will be released.  If PFC$HIGHEST_CYCLE is specified, the
{       highest cycle of the file will be released.  If a specific cycle is
{       specified, that cycle will be released.
{
{ PASSWORD: (input)  This parameter specifies a password that must match the
{       password registered with the file.  If a blank password is specified,
{       it will be considered a match only if no password was registered with
{       the file.
{
{ ARCHIVE_IDENTIFICATION: (input)  This parameter specifies the identification
{       of the archiving application.  The identification consists of an
{       application identifier and a media identifier.  The application
{       identifier identifies the archiving application.  The media identifier
{       consists of a media device class and a media volume identifier.  The
{       entire archive identification is used to locate the archive entry which
{       is to be marked.
{
{ STATUS: (output) This parameter returns the request status.
{
{        CONDTIONS:  pfe$bad_archive_identification
{                    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$incorrect_password
{                    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
{
