pbs_msgjob man page
pbs_msgjob — record a message for a running pbs batch job
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.