xenial (1) qmsg.1B.gz

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)