pbs_relnodesjob(3B)

NAME
pbs_relnodesjob - release some or all of the non-primary-execution-host vnodes assigned to a PBS job

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

int pbs_relnodesjob (int connect, char *job_id, char *node_list, char *extend)

DESCRIPTION
Issue a batch request to release some or all of the vnodes not on the primary execution host that are assigned to a batch job.

A RelnodesJob 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 whose vnodes are to be released; it is specified in the form:
    <sequence number>.<server>

The parameter, node_list, is a list of vnode names separated by plus signs ("+") whose parent MoM is not the MoM on the primary execution host. If node_list is NULL, it refers to all the vnodes that are not on the primary execution host that are assigned to the job. The parameter, extend, is reserved for implementation-defined extensions.

SEE ALSO
pbs_connect(3B)

DIAGNOSTICS
When the pbs_relnodesjob() 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.