qmsg man page

qmsg — send message to pbs batch jobs


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


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.


Specifies that the message is written to the standard error of each job.
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.


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:

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)