VMS Help
System Services, $FORCEX
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
Causes an Exit ($EXIT) service call to be issued on behalf of a
specified process.
Format
SYS$FORCEX [pidadr] ,[prcnam] ,[code]
C Prototype
int sys$forcex (unsigned int *pidadr, void *prcnam, unsigned
int code);
pidadr
OpenVMS usage:process_id
type: longword (unsigned)
access: modify
mechanism: by reference
Process identification (PID) of the process to be forced to exit.
The pidadr argument is the address of a longword containing the
PID.
The pidadr argument can refer to a process running on the local
node or a process running on another node in the OpenVMS Cluster
system.
The pidadr argument is optional but must be specified if the
process that is to be forced to exit is not in the same UIC group
as the calling process.
prcnam
OpenVMS usage:process_name
type: character-coded text string
access: read only
mechanism: by descriptor-fixed-length string descriptor
Process name of the process that is to be forced to exit. The
prcnam argument is the address of a character string descriptor
pointing to the process name string. A process running on the
local node can be identified with a 1- to 15-character string.
To identify a process on a particular node in a cluster, specify
the full process name, which includes the node name as well as
the process name. The full process name can contain up to 23
characters.
The prcnam argument can be used only on behalf of processes in
the same UIC group as the calling process. To force processes in
other groups to exit, you must specify the pidadr argument. This
restriction exists because the operating system interprets the
UIC group number of the calling process as part of the specified
process name; the names of processes are unique to UIC groups.
code
OpenVMS usage:cond_value
type: longword (unsigned)
access: read only
mechanism: by value
Completion code value to be used as the exit parameter. The
code argument is a longword containing this value. If you do
not specify the code argument, the value 0 is passed as the
completion code.
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.