HP NSARPA/1000 RPMCONTROL

RPMCONTROL

Controls the execution of a child program.

RPMCONTROL (pd,nodename,nodelen,reqcode,wrtdata,wrtlen, readdata,readlen,flags,result)

pd	Byte array (Pascal); Word array (FORTRAN),
	by reference. An array of 16 bytes containing the program
	descriptor of the child program to which control requests are
	sent. The program descriptor is a unique value returned from
	the RPMCreate call. Refer to the RPMCreate description in
	this section for more information about pd.
nodename	Packed array of characters (Pascal); word array
	(FORTRAN), by reference. A variable length array
	identifying the node on which the child program resides. The
	syntax of the node name is node[.domain[.organization]],
	which is further described in the NSARPA/1000 User/Programmer
	Reference Manual.
	Default: You may omit the organization, organization and
	domain, or all parts of the node name. When organization or
	organization and domain are omitted, they will default to the
	local organization and/or domain. If the nodelen parameter is
	set to zero, nodename is ignored and the node name defaults
	to the local node.
nodelen	32-bit non-negative integer, by value in
	Pascal, by reference in FORTRAN. The length in
	bytes of the nodename parameter. If nodelen is zero (0), the
	nodename parameter is ignored and the node name defaults to
	the local node. The maximum length of a fullyqualified node
	name length is 50 bytes.
	If nodelen is zero, it is assumed that the parent is either
	sending the RPMControl request to a dependent child
	program that it previously scheduled or to a child program on
	the parent's node (which is the local node).
reqcode	32-bit non-negative integer, by value in
	Pascal, by reference in FORTRAN. The request code
	for the control operation to be performed on the child program.
	The request codes are RTEA specific, and you should refer to
	the RTEA User's Manual and RTEA Programmer's Reference
	Manual for detailed explanations of these RTEA commands
	and calls. The request codes for RPMControl are as follows:
	D 200013Suspend execution of the child program. No data
	is required and none is returned. Therefore, wrtlen and
	readlen must be zero.
	This request is equivalent to the RTEA SS (suspend
	program) command. As in RTEA, if a child program is in
	a state that prevents it from being suspended, the program
	is not suspended until it is in the right state. No error is
	returned in result in this case (similarly as in RTEA).
	D 200023Resume execution of the child program at the
	point it was suspended. No data is required and none is
	returned. Therefore, wrtlen and readlen must be
	zero.
	This request is equivalent to the RTEA GO (resume
	program) command.

Remote Process Management 73