# qmsg

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
OPERANDS
STANDARD ERROR
EXIT STATUS
SEE ALSO

## 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)