# pbs_alterjob

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
DIAGNOSTICS

## NAME

| pbs_alterjob - alter pbs batch job

## SYNOPSIS

| #include <pbs_error.h> #include <pbs_ifl.h>

    int pbs_alterjob(int connect, char *job_id, struct attrl *attrib,
    char *extend)

## DESCRIPTION

| Issue a batch request to alter a batch job.

| A Modify Job batch request is generated and sent to the server over the connection specified by connect which is the return value of pbs_connect().

| The argument, job_id, identifies which job is to be altered, it is specified in the form: sequence_number.server

| The parameter, attrib, is a pointer to an attrl structure which is defined in pbs_ifl.h as:

        struct attrl {
            char *name;
            char *resource;
            char *value
            struct attrl *next;
        };
The attrib list is terminated by the first entry where next is a null pointer.

| The name member points to a string which is the name of the attribute. The value member points to a string which is the value of the attribute. The attribute names are defined in pbs_ifl.h:

| #define ATTR_a "Execution_Time"

| Alter the job's execution time.

| #define ATTR_A "Account_Name"

| Alter the account string.

| #define ATTR_c "Checkpoint"

| Alter the checkpoint interval.

| #define ATTR_e "Error_Path"

| Alter the path name for the standard error of the job.

| #define ATTR_g "Group_List"

| Alter the list of group names under which the job may execute.

| #define ATTR_h "Hold_Types"

| Alter the hold types.

| #define ATTR_j "Join_Path"

| Alter if standard error and standard output are joined (merged).

| #define ATTR_k "Keep_Files"

| Alter which output of the job is kept on the execution host.

| #define ATTR_l "Resource_List"

| Alter the value of a named resource.

| #define ATTR_m "Mail_Points"

| Alter the points at which the server will send mail about the job.

| #define ATTR_M "Mail_Users"

| Alter the list of users who would receive mail about the job.

| #define ATTR_N "Job_Name"

| Alter the job name.

| #define ATTR_o "Output_Path"

| Alter the path name for the standard output of the job.

| #define ATTR_p "Priority"

| Alter the priority of the job.

| #define ATTR_r "Rerunable"

| Alter the rerunable flag.

| #define ATTR_S "Shell_Path_List"

| Alter the path to the shell which will interprets the job script.

| #define ATTR_u "User_List"

| Alter the list of user names under which the job may execute.

| #define ATTR_v "Variable_List"

| Alter the list of environmental variables which are to be exported to the job.

| #define ATTR_depend "depend"

| Alter the inter-job dependencies.

| #define ATTR_stagein "stagein"

| Alter the list of files to be staged-in before job execution.

| #define ATTR_stageout "stageout"

| Alter the list of files to be staged-out after job execution.

| If attrib itself is a null pointer, then no attributes are altered.

| Associated with an attribute of type ATTR_l (the letter ell) is a resource name indicated by resource in the attrl structure. All other attribute types should have a pointer to a null string ("") for resource.

| If the resource of the specified resource name is already present in the job's Resource_List attribute, it will be altered to the specified value. If the resource is not present in the attribute, it is added.

| Certain attributes of a job may or may not be alterable depending on the state of the job; see qalter(1B).

| The parameter, extend, is reserved for implementation defined extensions.

## SEE ALSO

| qalter(1B) , qhold(1B) , qrls(1B) , qsub(1B) , pbs_connect(3B) , pbs_holdjob(3B) , and pbs_rlsjob(3B)

## DIAGNOSTICS

| When the batch request generated by pbs_alterjob() function has been completed successfully by a batch server, the routine will return 0 (zero). Otherwise, a non zero error is returned. The error number is also set in pbs_errno.