1pbs_msgjob(3B)                        PBS                       pbs_msgjob(3B)
2
3
4

NAME

6       pbs_msgjob - record a message for a running pbs batch job
7

SYNOPSIS

9       #include <pbs_error.h>
10       #include <pbs_ifl.h>
11
12       int pbs_msgjob(int connect, char *job_id, int file, char *message,
13       char *extend)
14

DESCRIPTION

16       Issue  a  batch request to write a message in an output file of a batch
17       job.
18
19       A Message Job batch request is generated and sent to  the  server  over
20       the  connection  specified  by  connect  which  is  the return value of
21       pbs_connect().
22
23       The argument, job_id, identifies the job to which  the message is to be
24       sent; it is specified in the form: sequence_number.server
25
26       The  parameter,  file, indicates the file or files to which the message
27       string  is  to  be  written.   The  following  values  are  defined  in
28       pbs_ifl.h:
29
30              #define MSG_ERR 2
31                     directs  the  message to the standard error stream of the
32                     job.
33
34              #define MSG_OUT 1
35                     directs the message to the standard output stream of  the
36                     job.
37
38       The parameter, message, is the message string to be written.
39
40       The  parameter,  extend,  is reserved for implementation defined exten‐
41       sions.
42

SEE ALSO

44       qmsg(1B) and pbs_connect(3B)
45

DIAGNOSTICS

47       When the batch request generated by pbs_msgjob() function has been com‐
48       pleted  successfully  by  a  batch  server,  the  routine will return 0
49       (zero).  Otherwise, a non zero error is returned.  The error number  is
50       also set in pbs_errno.
51
52
53
54
55Local                                                           pbs_msgjob(3B)