Rechercher une page de manuel
pbs_alterjob.3B
Langue: en
Version: (ubuntu - 08/07/09)
Section: 3 (Bibliothèques de fonctions)
NAME
pbs_alterjob - alter pbs batch jobSYNOPSIS
#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 which is the return value of pbs_connect().
The argument, identifies which job is to be altered, it is specified in the form:
sequence_number.server
The parameter, 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 list is terminated by the first entry where is a null pointer.
The member points to a string which is the name of the attribute. The 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 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 in the attrl structure. All other attribute types should have a pointer to a null string ("") for
If the resource of the specified resource name is already present in the job's 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, 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.Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre