Compaq SC RMS Server User Manual


 
rms_prgsuspend(3)
NAME
rms_prgsuspend, rms_prgresume, rms_prgsignal – Suspend or resume the
processes in a program, deliver a signal to all processes in a program
SYNOPSIS
cc [ flag ... ] file ... -lrmscall [ library ... ]
#include <rms/rmscall.h>
int rms_prgsuspend(int id);
int rms_prgresume(int id);
int rms_prgsignal(int id, int signo);
PARAMETERS
id Program identifier.
signo Signal number.
DESCRIPTION
rms_prgsuspend() suspends all of the processes in a program. The RMS suspends a
parallel program by calling rms_prgsuspend() on each node that it is using.
rms_prgsuspend() requires administrator privileges. rms_prgresume() resumes all
of the processes in a program. The RMS resumes a parallel program by calling
rms_prgresume() on each node that it is using. rms_prgresume() requires
administrator privileges.
rms_prgsignal() sends a signal to all of the processes in a program. The RMS delivers
signals to a parallel program by calling rms_prgsignal() on each node that it is using.
The function is also used to confirm that all processes belonging to a program have
exited. rms_prgsignal() can be called by the owner of the program or a process with
administrator privileges.
RETURN VALUES
Upon successful completion, rms_prgsuspend(), rms_prgresume() and
rms_prgsignal() return 0. Otherwise, they return -1 and set errno to indicate the
error.
C-8 RMS Kernel Module