Guardian Procedure Calls Reference Manual

CREATEPROCESSNAME Procedure (Superseded by
PROCESSNAME_CREATE_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Condition Code Settings
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The CREATEPROCESSNAME procedure returns a unique process name suitable for passing to the
NEWPROCESS and NEWPROCESSNOWAIT procedures. This type of naming (as opposed to 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 (for example, in an application run as several process pairs). This
process name must be passed in the name parameter, not the file-name parameter, of the
NEWPROCESS procedure.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL CREATEPROCESSNAME ( process-name ); ! o
Parameter
process-name
output
INT:ref:3
is an array where a system-generated process name returns. The process-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."
CREATEPROCESSNAME ensures that the character position after the last a is a blank.
Condition Code Settings
indicates that the address passed for process-name is out of bounds.< (CCL)
indicates the CREATEPROCESSNAME was successful.= (CCE)
indicates there were no unused names in the reserved name space ($Xname, $Yname, and $Zname,
where name is 1 through 4 alphanumeric characters) for CREATEPROCESSNAME to use.
> (CCG)
CREATEPROCESSNAME Procedure (Superseded by PROCESSNAME_CREATE_ Procedure) 239