NAME

       qmsg - send message to pbs batch jobs

SYNOPSIS

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

DESCRIPTION

       To  send  a message to a job is to write a message string into one or more output files of
       the job.  Typically this is done to leave an informative message in the output of the job.

       The qmsg command writes messages into the files of jobs by sending  a  Message  Job  batch
       request  to  the batch server that owns the job.  The qmsg command does not directly write
       the message into the files of the job.

OPTIONS

       -E             Specifies that the message is written to the standard error of each job.

       -O             Specifies that the message is written to the standard output of each job.

       If neither the -E nor the -O option is specified, the  message  will  be  written  to  the
       standard error of the job.

OPERANDS

       The  first  operand, message_string, is the message to be written.  If the string contains
       blanks, the string must be quoted.  If the final character of the string is not a newline,
       a newline character will be added when written to the job's file.

       All  following  operands are job_identifiers which specify the jobs to receive the message
       string.  The qmsg command accepts one or more job_identifier operands of the form:
           sequence_number[.server_name][@server]

STANDARD ERROR

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

EXIT STATUS

       Upon  successful  processing  of  all the operands presented to the qmsg command, the exit
       status will be a value of zero.

       If the qmsg command fails to process any operand, the command exits with a  value  greater
       than zero.

SEE ALSO

       qsub(1B), pbs_msgjob(3B)