# pbs_msgjob

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
DIAGNOSTICS

## NAME

| pbs_msgjob - record a message for a running pbs batch job

## SYNOPSIS

| #include <pbs_error.h> #include <pbs_ifl.h>

    int pbs_msgjob(int connect, char *job_id, int file, char *message,
    char *extend)

## DESCRIPTION

| Issue a batch request to write a message in an output file of a batch job.

| A Message Job batch request is generated and sent to the server over the connection specified by connect which is the return value of pbs_connect().

| The argument, job_id, identifies the job to which the message is to be sent; it is specified in the form: sequence_number.server

| The parameter, file, indicates the file or files to which the message string is to be written. The following values are defined in pbs_ifl.h:

| #define MSG_ERR 2

| directs the message to the standard error stream of the job.

| #define MSG_OUT 1

| directs the message to the standard output stream of the job.

| The parameter, message, is the message string to be written.

| The parameter, extend, is reserved for implementation defined extensions.

## SEE ALSO

| qmsg(1B) and pbs_connect(3B)

## DIAGNOSTICS

| When the batch request generated by pbs_msgjob() function has been completed successfully by a batch server, the routine will return 0 (zero). Otherwise, a non zero error is returned. The error number is also set in pbs_errno.