Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-164
PROCESS_SETSTRINGINFO_ Procedure
set-value:length input:input
STRING .EXT:ref:*, INT:value
is the new value for the attribute to be altered. The value of
set-value must be
exactly
length bytes long.
old-value:maxlen output:input
STRING .EXT:ref:*, INT:value
if present and
maxlen is not 0, returns the prior value for the attribute being
altered.
old-value-len output
INT .EXT:ref:1
is the actual length in bytes of
old-value. This parameter must be present when
old-value is present. Otherwise, both must be omitted.
Considerations
•
The caller of PROCESS_SETSTRINGINFO_ must be the super ID, the group
manager of the process access ID, or a process with the same process access ID
as the process or process pair whose attribute is being changed. For information
about the process access ID, refer to the description under “Considerations” for the
PROCESS_GETINFO_ procedure and the
Guardian User’s Guide.
The caller must be local to the same system as the specified process. A process
is considered to be local to the system on which its creator is local. A process is
considered to be remote, even if it is running on the local system, if its creator is
remote. (In the same manner, a process running on the local system whose
creator is also running on the local system might still be considered remote
because it’s creator’s creator is remote.)
A remote process running on the local system can become a local process by
successfully logging on to the local system by a call to USER_AUTHENTICATE_
(or VERIFYUSER). After a process logs on to the local system, processes that it
creates are considered local.
•
set-attr-code
set-attr-code can be one of the following attributes:
* 5 = home terminal
An asterisk (*) indicates that the attribute can be altered only when the caller is the
target process.