Compaq SC RMS Server User Manual


 
rms_prgcreate(3)
NAME
rms_prgcreate, rms_prgdestroy – Create, destroy program descriptions
SYNOPSIS
cc [ flag ... ] file ... -lrmscall [ library ... ]
#include <rms/rmscall.h>
int rms_prgcreate(int id, uid_t uid, int cpus);
int rms_prgdestroy(int id);
PARAMETERS
id Program identifier.
uid Owner of the program.
cpus Number of CPUs allocated.
DESCRIPTION
rms_prgcreate() creates a new program description with the current process as its
root process. Any children of this process will belong to this program.
rms_prgdestroy() destroys an existing program description. Calls to
rms_prgdestroy() will fail if processes belonging to this program are still running.
Creating or destroying program descriptions requires administrator privileges. The
rmsd creates a new program description for each parallel program. The program
identifier is the unique identifier for the parallel job, that is to say, it is common across
nodes.
RETURN VALUES
Upon successful completion, rms_prgcreate() and rms_prgdestroy() return 0.
Otherwise, they return -1 and set errno to indicate the error.
EACCESS Caller is not permitted to perform this operation.
ENOMEM Insufficient memory to perform this operation.
C-4 RMS Kernel Module