job-mutators.c

/***************************************************************************
 *  This file is automatically generated by gen-get-set.  Be sure to keep
 *  track of any manual changes.
 *
 *  These generated functions are not expected to be perfect.  Check and
 *  edit as needed before adding to your code.
 ***************************************************************************/

#include <string.h>
#include <ctype.h>
#include <stdbool.h>        // In case of bool
#include <stdint.h>         // In case of int64_t, etc
#include <xtend/string.h>   // strlcpy() on Linux
#include "job-private.h"


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for job_id member in a job_t structure.
 *      Use this function to set job_id in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      job_id is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_job_id      The new value for job_id
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      unsigned long   new_job_id;
 *
 *      if ( job_set_job_id(&job, new_job_id)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_job_id(job_t *job_ptr, unsigned long new_job_id)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->job_id = new_job_id;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for array_index member in a job_t structure.
 *      Use this function to set array_index in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      array_index is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_array_index The new value for array_index
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      unsigned long   new_array_index;
 *
 *      if ( job_set_array_index(&job, new_array_index)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_array_index(job_t *job_ptr, unsigned long new_array_index)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->array_index = new_array_index;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for job_count member in a job_t structure.
 *      Use this function to set job_count in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      job_count is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_job_count   The new value for job_count
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      unsigned        new_job_count;
 *
 *      if ( job_set_job_count(&job, new_job_count)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_job_count(job_t *job_ptr, unsigned new_job_count)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->job_count = new_job_count;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for processors_per_job member in a job_t structure.
 *      Use this function to set processors_per_job in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      processors_per_job is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_processors_per_job The new value for processors_per_job
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      unsigned        new_processors_per_job;
 *
 *      if ( job_set_processors_per_job(&job, new_processors_per_job)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_processors_per_job(job_t *job_ptr, unsigned new_processors_per_job)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->processors_per_job = new_processors_per_job;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for threads_per_process member in a job_t structure.
 *      Use this function to set threads_per_process in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      threads_per_process is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_threads_per_process The new value for threads_per_process
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      unsigned        new_threads_per_process;
 *
 *      if ( job_set_threads_per_process(&job, new_threads_per_process)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_threads_per_process(job_t *job_ptr, unsigned new_threads_per_process)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->threads_per_process = new_threads_per_process;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for phys_mib_per_processor member in a job_t structure.
 *      Use this function to set phys_mib_per_processor in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      phys_mib_per_processor is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_phys_mib_per_processor The new value for phys_mib_per_processor
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          new_phys_mib_per_processor;
 *
 *      if ( job_set_phys_mib_per_processor(&job, new_phys_mib_per_processor)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_phys_mib_per_processor(job_t *job_ptr, size_t new_phys_mib_per_processor)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->phys_mib_per_processor = new_phys_mib_per_processor;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for chaperone_pid member in a job_t structure.
 *      Use this function to set chaperone_pid in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      chaperone_pid is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_chaperone_pid The new value for chaperone_pid
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      pid_t           new_chaperone_pid;
 *
 *      if ( job_set_chaperone_pid(&job, new_chaperone_pid)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_chaperone_pid(job_t *job_ptr, pid_t new_chaperone_pid)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->chaperone_pid = new_chaperone_pid;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for job_pid member in a job_t structure.
 *      Use this function to set job_pid in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      job_pid is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_job_pid     The new value for job_pid
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      pid_t           new_job_pid;
 *
 *      if ( job_set_job_pid(&job, new_job_pid)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_job_pid(job_t *job_ptr, pid_t new_job_pid)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->job_pid = new_job_pid;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for state member in a job_t structure.
 *      Use this function to set state in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      state is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_state       The new value for state
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      job_state_t     new_state;
 *
 *      if ( job_set_state(&job, new_state)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_state(job_t *job_ptr, job_state_t new_state)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->state = new_state;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for user_name member in a job_t structure.
 *      Use this function to set user_name in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      user_name is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_user_name   The new value for user_name
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_user_name;
 *
 *      if ( job_set_user_name(&job, new_user_name)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_user_name(job_t *job_ptr, char * new_user_name)

{
    if ( new_user_name == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->user_name = new_user_name;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of user_name member in a job_t
 *      structure. Use this function to set job_ptr->user_name[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the user_name array
 *      new_user_name_element The new value for user_name[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_user_name_element;
 *
 *      if ( job_set_user_name_ae(&job, c, new_user_name_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_USER_NAME_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_user_name_ae(job_t *job_ptr, size_t c, char  new_user_name_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->user_name[c] = new_user_name_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for user_name member in a job_t structure.
 *      Use this function to set user_name in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_user_name to job_ptr->user_name.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_user_name   The new value for user_name
 *      array_size      Size of the user_name array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_user_name;
 *      size_t          array_size;
 *
 *      if ( job_set_user_name_cpy(&job, new_user_name, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_USER_NAME(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_user_name_cpy(job_t *job_ptr, char * new_user_name, size_t array_size)

{
    if ( new_user_name == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->user_name, new_user_name, array_size);
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for primary_group_name member in a job_t structure.
 *      Use this function to set primary_group_name in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      primary_group_name is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_primary_group_name The new value for primary_group_name
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_primary_group_name;
 *
 *      if ( job_set_primary_group_name(&job, new_primary_group_name)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_primary_group_name(job_t *job_ptr, char * new_primary_group_name)

{
    if ( new_primary_group_name == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->primary_group_name = new_primary_group_name;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of primary_group_name member in a job_t
 *      structure. Use this function to set job_ptr->primary_group_name[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the primary_group_name array
 *      new_primary_group_name_element The new value for primary_group_name[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_primary_group_name_element;
 *
 *      if ( job_set_primary_group_name_ae(&job, c, new_primary_group_name_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_PRIMARY_GROUP_NAME_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_primary_group_name_ae(job_t *job_ptr, size_t c, char  new_primary_group_name_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->primary_group_name[c] = new_primary_group_name_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for primary_group_name member in a job_t structure.
 *      Use this function to set primary_group_name in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_primary_group_name to job_ptr->primary_group_name.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_primary_group_name The new value for primary_group_name
 *      array_size      Size of the primary_group_name array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_primary_group_name;
 *      size_t          array_size;
 *
 *      if ( job_set_primary_group_name_cpy(&job, new_primary_group_name, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_PRIMARY_GROUP_NAME(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_primary_group_name_cpy(job_t *job_ptr, char * new_primary_group_name, size_t array_size)

{
    if ( new_primary_group_name == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->primary_group_name, new_primary_group_name, array_size);
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for submit_node member in a job_t structure.
 *      Use this function to set submit_node in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      submit_node is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_submit_node The new value for submit_node
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_submit_node;
 *
 *      if ( job_set_submit_node(&job, new_submit_node)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_submit_node(job_t *job_ptr, char * new_submit_node)

{
    if ( new_submit_node == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->submit_node = new_submit_node;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of submit_node member in a job_t
 *      structure. Use this function to set job_ptr->submit_node[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the submit_node array
 *      new_submit_node_element The new value for submit_node[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_submit_node_element;
 *
 *      if ( job_set_submit_node_ae(&job, c, new_submit_node_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_SUBMIT_NODE_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_submit_node_ae(job_t *job_ptr, size_t c, char  new_submit_node_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->submit_node[c] = new_submit_node_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for submit_node member in a job_t structure.
 *      Use this function to set submit_node in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_submit_node to job_ptr->submit_node.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_submit_node The new value for submit_node
 *      array_size      Size of the submit_node array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_submit_node;
 *      size_t          array_size;
 *
 *      if ( job_set_submit_node_cpy(&job, new_submit_node, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_SUBMIT_NODE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_submit_node_cpy(job_t *job_ptr, char * new_submit_node, size_t array_size)

{
    if ( new_submit_node == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->submit_node, new_submit_node, array_size);
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for submit_dir member in a job_t structure.
 *      Use this function to set submit_dir in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      submit_dir is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_submit_dir  The new value for submit_dir
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_submit_dir;
 *
 *      if ( job_set_submit_dir(&job, new_submit_dir)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_submit_dir(job_t *job_ptr, char * new_submit_dir)

{
    if ( new_submit_dir == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->submit_dir = new_submit_dir;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of submit_dir member in a job_t
 *      structure. Use this function to set job_ptr->submit_dir[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the submit_dir array
 *      new_submit_dir_element The new value for submit_dir[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_submit_dir_element;
 *
 *      if ( job_set_submit_dir_ae(&job, c, new_submit_dir_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_SUBMIT_DIR_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_submit_dir_ae(job_t *job_ptr, size_t c, char  new_submit_dir_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->submit_dir[c] = new_submit_dir_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for submit_dir member in a job_t structure.
 *      Use this function to set submit_dir in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_submit_dir to job_ptr->submit_dir.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_submit_dir  The new value for submit_dir
 *      array_size      Size of the submit_dir array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_submit_dir;
 *      size_t          array_size;
 *
 *      if ( job_set_submit_dir_cpy(&job, new_submit_dir, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_SUBMIT_DIR(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_submit_dir_cpy(job_t *job_ptr, char * new_submit_dir, size_t array_size)

{
    if ( new_submit_dir == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->submit_dir, new_submit_dir, array_size);
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for script_name member in a job_t structure.
 *      Use this function to set script_name in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      script_name is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_script_name The new value for script_name
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_script_name;
 *
 *      if ( job_set_script_name(&job, new_script_name)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_script_name(job_t *job_ptr, char * new_script_name)

{
    if ( new_script_name == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->script_name = new_script_name;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of script_name member in a job_t
 *      structure. Use this function to set job_ptr->script_name[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the script_name array
 *      new_script_name_element The new value for script_name[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_script_name_element;
 *
 *      if ( job_set_script_name_ae(&job, c, new_script_name_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_SCRIPT_NAME_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_script_name_ae(job_t *job_ptr, size_t c, char  new_script_name_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->script_name[c] = new_script_name_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for script_name member in a job_t structure.
 *      Use this function to set script_name in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_script_name to job_ptr->script_name.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_script_name The new value for script_name
 *      array_size      Size of the script_name array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_script_name;
 *      size_t          array_size;
 *
 *      if ( job_set_script_name_cpy(&job, new_script_name, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_SCRIPT_NAME(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_script_name_cpy(job_t *job_ptr, char * new_script_name, size_t array_size)

{
    if ( new_script_name == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->script_name, new_script_name, array_size);
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for compute_node member in a job_t structure.
 *      Use this function to set compute_node in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      compute_node is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_compute_node The new value for compute_node
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_compute_node;
 *
 *      if ( job_set_compute_node(&job, new_compute_node)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_compute_node(job_t *job_ptr, char * new_compute_node)

{
    if ( new_compute_node == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->compute_node = new_compute_node;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of compute_node member in a job_t
 *      structure. Use this function to set job_ptr->compute_node[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the compute_node array
 *      new_compute_node_element The new value for compute_node[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_compute_node_element;
 *
 *      if ( job_set_compute_node_ae(&job, c, new_compute_node_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_COMPUTE_NODE_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_compute_node_ae(job_t *job_ptr, size_t c, char  new_compute_node_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->compute_node[c] = new_compute_node_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for compute_node member in a job_t structure.
 *      Use this function to set compute_node in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_compute_node to job_ptr->compute_node.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_compute_node The new value for compute_node
 *      array_size      Size of the compute_node array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_compute_node;
 *      size_t          array_size;
 *
 *      if ( job_set_compute_node_cpy(&job, new_compute_node, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_COMPUTE_NODE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_compute_node_cpy(job_t *job_ptr, char * new_compute_node, size_t array_size)

{
    if ( new_compute_node == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->compute_node, new_compute_node, array_size);
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for log_dir member in a job_t structure.
 *      Use this function to set log_dir in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      log_dir is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_log_dir     The new value for log_dir
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_log_dir;
 *
 *      if ( job_set_log_dir(&job, new_log_dir)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_log_dir(job_t *job_ptr, char * new_log_dir)

{
    if ( new_log_dir == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->log_dir = new_log_dir;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of log_dir member in a job_t
 *      structure. Use this function to set job_ptr->log_dir[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the log_dir array
 *      new_log_dir_element The new value for log_dir[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_log_dir_element;
 *
 *      if ( job_set_log_dir_ae(&job, c, new_log_dir_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_LOG_DIR_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_log_dir_ae(job_t *job_ptr, size_t c, char  new_log_dir_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->log_dir[c] = new_log_dir_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for log_dir member in a job_t structure.
 *      Use this function to set log_dir in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_log_dir to job_ptr->log_dir.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_log_dir     The new value for log_dir
 *      array_size      Size of the log_dir array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_log_dir;
 *      size_t          array_size;
 *
 *      if ( job_set_log_dir_cpy(&job, new_log_dir, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_LOG_DIR(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_log_dir_cpy(job_t *job_ptr, char * new_log_dir, size_t array_size)

{
    if ( new_log_dir == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->log_dir, new_log_dir, array_size);
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for pull_command member in a job_t structure.
 *      Use this function to set pull_command in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      pull_command is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_pull_command The new value for pull_command
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_pull_command;
 *
 *      if ( job_set_pull_command(&job, new_pull_command)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_pull_command(job_t *job_ptr, char * new_pull_command)

{
    if ( new_pull_command == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->pull_command = new_pull_command;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of pull_command member in a job_t
 *      structure. Use this function to set job_ptr->pull_command[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the pull_command array
 *      new_pull_command_element The new value for pull_command[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_pull_command_element;
 *
 *      if ( job_set_pull_command_ae(&job, c, new_pull_command_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_PULL_COMMAND_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_pull_command_ae(job_t *job_ptr, size_t c, char  new_pull_command_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->pull_command[c] = new_pull_command_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for pull_command member in a job_t structure.
 *      Use this function to set pull_command in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_pull_command to job_ptr->pull_command.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_pull_command The new value for pull_command
 *      array_size      Size of the pull_command array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_pull_command;
 *      size_t          array_size;
 *
 *      if ( job_set_pull_command_cpy(&job, new_pull_command, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_PULL_COMMAND(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_pull_command_cpy(job_t *job_ptr, char * new_pull_command, size_t array_size)

{
    if ( new_pull_command == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->pull_command, new_pull_command, array_size);
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for push_command member in a job_t structure.
 *      Use this function to set push_command in a job_t object
 *      from non-member functions.  This function performs a direct
 *      assignment for scalar or pointer structure members.  If
 *      push_command is a pointer, data previously pointed to should
 *      be freed before calling this function to avoid memory
 *      leaks.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_push_command The new value for push_command
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_push_command;
 *
 *      if ( job_set_push_command(&job, new_push_command)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      (3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_push_command(job_t *job_ptr, char * new_push_command)

{
    if ( new_push_command == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->push_command = new_push_command;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for an array element of push_command member in a job_t
 *      structure. Use this function to set job_ptr->push_command[c]
 *      in a job_t object from non-member functions.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      c               Subscript to the push_command array
 *      new_push_command_element The new value for push_command[c]
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      size_t          c;
 *      char *          new_push_command_element;
 *
 *      if ( job_set_push_command_ae(&job, c, new_push_command_element)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_PUSH_COMMAND_AE(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_push_command_ae(job_t *job_ptr, size_t c, char  new_push_command_element)

{
    if ( false )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	job_ptr->push_command[c] = new_push_command_element;
	return JOB_DATA_OK;
    }
}


/***************************************************************************
 *  Library:
 *      #include <job.h>
 *      
 *
 *  Description:
 *      Mutator for push_command member in a job_t structure.
 *      Use this function to set push_command in a job_t object
 *      from non-member functions.  This function copies the array pointed to
 *      by new_push_command to job_ptr->push_command.
 *
 *  Arguments:
 *      job_ptr         Pointer to the structure to set
 *      new_push_command The new value for push_command
 *      array_size      Size of the push_command array.
 *
 *  Returns:
 *      JOB_DATA_OK if the new value is acceptable and assigned
 *      JOB_DATA_OUT_OF_RANGE otherwise
 *
 *  Examples:
 *      job_t           job;
 *      char *          new_push_command;
 *      size_t          array_size;
 *
 *      if ( job_set_push_command_cpy(&job, new_push_command, array_size)
 *              == JOB_DATA_OK )
 *      {
 *      }
 *
 *  See also:
 *      JOB_SET_PUSH_COMMAND(3)
 *
 *  History: 
 *  Date        Name        Modification
 *  2025-01-06  gen-get-set Auto-generated from job-private.h
 ***************************************************************************/

int     job_set_push_command_cpy(job_t *job_ptr, char * new_push_command, size_t array_size)

{
    if ( new_push_command == NULL )
	return JOB_DATA_OUT_OF_RANGE;
    else
    {
	// FIXME: Assuming char array is a null-terminated string
	strlcpy(job_ptr->push_command, new_push_command, array_size);
	return JOB_DATA_OK;
    }
}