Guardian Procedure Calls Reference Manual

PROCESSNAME_CREATE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Related Programming Manual
Summary
The PROCESSNAME_CREATE_ procedure returns a unique process name that is suitable for passing
to the PROCESS_LAUNCH_, PROCESS_CREATE_, or PROCESS_SPAWN_ procedure. This type
of naming (as opposed to using a predefined process name) is used when the name of a process
pair does not need to be known to other processes in the system or network.
Syntax for C Programmers
#include <cextdecs(PROCESSNAME_CREATE_)>
short PROCESSNAME_CREATE_ ( char *name
,short maxlen
,short *namelen
,[ short name-type ]
,[ const char *nodename ]
,[ short length ]
,[ short options ] );
The parameter length specifies the length in bytes of the character string pointed to by nodename.
The parameters nodename and length must either both be supplied or both be absent.
Syntax for TAL Programmers
error := PROCESSNAME_CREATE_ ( name:maxlen ! o:i
,namelen ! o
,[ name-type ] ! i
,[ nodename:length ] ! i:i
,[ options ] ); ! i
Parameters
name:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the process name.
maxlen is the length in bytes of the string variable name.
namelen
output
INT .EXT:ref:1
contains the actual length in bytes of the name being returned.
PROCESSNAME_CREATE_ Procedure 1153