Guardian Programmer's Guide

Creating and Managing Processes
Guardian Programmer’s Guide — 421922-014
16 - 28
Specifying Process Attributes and Resources
OUTPUT_LIST_LEN);
IF ERROR <> 0 THEN
BEGIN
CASE ERROR OF
BEGIN
'1' -> CALL FILE^ERRORS(ERROR_DETAIL); !To process the
! file-system error
'2' -> CALL PARAM^ERROR(ERROR_DETAIL); !To process the
! parameter error
.
.
END;
END;
Nowait Creation Errors
If you call PROCESS_LAUNCH_ in a nowait manner, you need to check not only the
error return value of the procedure call but also the PROCESS_LAUNCH_ or
PROCESS_CREATE_ completion message. If the system is unable to initiate process
creation (for example, if you specified an invalid IPU number), then the system returns
the error with the procedure call. Other process-creation errors are reported in the
PROCESS_LAUNCH_ or PROCESS_CREATE_ completion message.
Specifying Process Attributes and Resources
The following paragraphs show how to set process attributes and resources when you
create a new process with the PROCESS_LAUNCH_ procedure.
Running a Process at a High PIN or a Low PIN
You can run a process at a high PIN (256 or greater) or low PIN (254 or less).
Whether to run processes at a high PIN or low PIN depends on how many PINs your
system will need. Although some HP processes will use high PINs, many will use low
PINs. Consequently, you should consider running application processes at high PINs,
because there are many more high PINs available than there are low PINs. The
danger of running a process at a low PIN is that if the system uses all the available low
PINs, you will not be able to run all the processes you want.
Whether a new process runs at a high PIN or a low PIN depends on:
•
The force-low flag—bit 31 in the CREATE_OPTIONS field of the input parameter
structure of the PROCESS_LAUNCH_ procedure call
•
The inherited force-low characteristic of the creator process
•
The ignore force-low flag—bit 26 in the CREATE_OPTIONS field of the input
parameter structure of the PROCESS_LAUNCH_ procedure call
•
The HIGHPIN attribute of the program file and the library file or SRL file, if there is
one