{
{   The purpose of this request is to put information about a file cycle into
{ the permanent file system.  The cycle will be created in an "undefined data"
{ state.  It will not be possible to attach the cycle until a "define_data"
{ request is used to establish data for the cycle.
{
{       PFP$PUT_CYCLE_INFO (PATH, CYCLE_SELECTOR, PASSWORD_SELECTOR,
{             CYCLE_ARRAY_ENTRY, STATUS)
{
{ PATH: (input) This parameter specifies the identification of a file for which
{       cycle information is to be registered.  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 in the path specifies the file for which cycle information is to
{       be registered.  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.
{       If the file does not currently exist it will be created.
{
{ CYCLE_SELECTOR: (input) This parameter selects the permanent file cycle for
{       which information is to be registered.  The cycle number determined by
{       this parameter will be used rather than the cycle number contained in
{       the cycle_array_entry parameter.  If PFC$LOWEST_CYCLE is specified, a
{       cycle one less than the current lowest cycle will be created.  If
{       PFC$HIGHEST_CYCLE is specified, a cycle one greater than the current
{       highest cycle will be created.  If a specific cycle is specified, that
{       cycle will be created.
{
{ PASSWORD_SELECTOR: (input) This parameter specifies a password that must match the
{       password registered with the file.  If pfc$default_password_option is
{       specified,  it will only match for the system or family administrator,
{       or file owner, or for the non-owner if no password is registered
{       with the file.  If pfc$specific_password_option is selected, the
{       supplied password must match the password registered with the
{       file.
{
{ CYCLE_ARRAY_ENTRY: (input) This parameter specifies the information about a
{       cycle that is to be registered for the file identified by the path
{       parameter.  The cycle number field of this parameter is ignored.
{
{ STATUS: (output) This parameter returns the request status.
{
{        CONDITIONS: 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$catalog_full
{                    pfe$cycle_overflow
{                    pfe$cycle_underflow
{                    pfe$duplicate_cycle
{                    pfe$incorrect_password
{                    pfe$name_not_permanent_file
{                    pfe$nth_name_not_subcatalog
{                    pfe$path_too_short
{                    pfe$pf_system_error
{                    pfe$unknown_family
{                    pfe$unknown_master_catalog
{                    pfe$unknown_nth_subcatalog
{                    pfe$unknown_permanent_file
{
{        IDENTIFIER: pfc$permanent_file_manager_id
{
