qmsg(1) - f37

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

NAME

6       qmsg - send message to pbs batch jobs
7

SYNOPSIS

9       qmsg [-E] [-O] message_string job_identifier ...
10

DESCRIPTION

12       To  send  a  message  to a job is to write a message string into one or
13       more output files of the job.  Typically  this  is  done  to  leave  an
14       informative message in the output of the job.
15
16       The  qmsg  command  writes messages into the files of jobs by sending a
17       Message Job batch request to the batch server that owns the  job.   The
18       qmsg  command does not directly write the message into the files of the
19       job.
20

OPTIONS

22       -E             Specifies that the message is written  to  the  standard
23                      error of each job.
24
25       -O             Specifies  that  the  message is written to the standard
26                      output of each job.
27
28       If neither the -E nor the -O option is specified, the message  will  be
29       written to the standard error of the job.
30

OPERANDS

32       The  first  operand,  message_string, is the message to be written.  If
33       the string contains blanks, the string must be quoted.   If  the  final
34       character  of  the string is not a newline, a newline character will be
35       added when written to the job's file.
36
37       All following operands are job_identifiers which specify  the  jobs  to
38       receive  the  message  string.   The  qmsg  command accepts one or more
39       job_identifier operands of the form:
40           sequence_number[.server_name][@server]
41

STANDARD ERROR

43       The qmsg command will write a diagnostic message to standard error  for
44       each error occurrence.
45

EXIT STATUS

47       Upon  successful  processing  of all the operands presented to the qmsg
48       command, the exit status will be a value of zero.
49
50       If the qmsg command fails to process any  operand,  the  command  exits
51       with a value greater than zero.
52