| pbs_msgjob - record a message for a running pbs batch job |
|
#include <pbs_error.h> #include <pbs_ifl.h> |
int pbs_msgjob(int connect, char *job_id, int file, char *message, char *extend) |
| Issue a batch request to write a message in an output file of a batch job. |
| A Message 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 the job to which the message is to be sent; it is specified in the form: sequence_number.server |
| The parameter, file, indicates the file or files to which the message string is to be written. The following values are defined in pbs_ifl.h: |
| #define MSG_ERR 2 |
| directs the message to the standard error stream of the job. |
| #define MSG_OUT 1 |
| directs the message to the standard output stream of the job. |
| The parameter, message, is the message string to be written. |
| The parameter, extend, is reserved for implementation defined extensions. |
| qmsg(1B) and pbs_connect(3B) |
| When the batch request generated by pbs_msgjob() 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. |