Using NS3000/iX Network Services (36920-90008)

Chapter 7 147
Remote Process Management
RPMKILL
RPMKILL
Terminates a process created by the RPMCREATE intrinsic. Process
Handling (PH) capability is required.
Syntax
RPMKILL ( pd[,location][,loclen][,result])
Parameters
pd (input) 16-byte array, by value. The program descriptor
returned by the RPMCREATE intrinsic.
location (input) Character array, by reference. The node name or
environment ID indicating where the process to be
killed is located.
loclen (input) 32-bit integer, by value. The length in bytes of the
location name.
result (output) 32-bit integer, by reference. The error code
returned; zero if no error.
Description
The RPMKILL intrinsic terminates a process that was created by
RPMCREATE. It also deletes the remote environment if that environment
was established by RPMCREATE. Any process on any node may call
RPMKILL to kill a remote RPM process, as long as it has the correct
program descriptor. To kill a process on your local node that utilizes
another session, you must have configured the network for software
loopback. To kill a local process in your session, you must be the creator
of that process.
The only required parameter is pd (option variable).
The location and loclen parameters are also required in order to kill a
remote process either if the remote process is independent or if the
calling process is not the creator. RPM needs these to open a new
connection to the remote node before killing the remote process.
Use the RPMKILL intrinsic only to terminate perpetually running
remote processes. Otherwise, use the “Shutting Down Sockets and
Connections” procedure described in the NetIPC 3000/XL
Programmer's Reference Manual.