Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-173
CREATEREMOTENAME Procedure
(Superseded by PROCESSNAME_CREATE_
Parameters
name output
INT:ref:3
is an array where CREATEREMOTENAME returns a system-generated process
name (in local form) that is unique for the designated system. The
name
parameter is of the form:
$zaaaa
where
“z” is the letter Z, Y, or X.
“a” represents an alphanumeric character except “o” and “i.”
CREATEREMOTENAME ensures that the character position after the last “a” is a
blank.
sysnum input
INT:value
is a value that specifies the system number for which the process name is to be
created.
Condition Code Settings
< (CCL) indicates that the remote destination control table (DCT) could not be
accessed or the address passed for
name is out of bounds.
= (CCE) indicates that CREATEREMOTENAME was successful.
> (CCG) indicates there were no unused names in the reserved name space
($X
name, $Yname, and $Zname, where name is 1 through 4
alphanumeric characters) for CREATEREMOTENAME to use.
Considerations
•
Remote process name characteristics
CREATEREMOTENAME creates a process name in local form. This name can be
passed directly to the NEWPROCESS[NOWAIT] procedure as the
name parameter
in order to create a remote process having that name. It is unnecessary to append
a system name to the process name since the physical location of the program file
specified in the NEWPROCESS
file-name includes the system number.
•
HP reserved process names
The operating system reserved process name space includes the following names:
$X
name, $Yname, and $Zname, where name is 1 through 4 alphanumeric
characters. Do not use names of this form in any applications.