Guardian Procedure Calls Reference Manual

PROCESSACCESSID Procedure (Superseded by PROCESS_GETINFOLIST_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Returned Value
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The PROCESSACCESSID procedure is used to obtain the process access ID (PAID) of the calling
process.
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
access-id := PROCESSACCESSID;
Returned Value
INT
The process access ID (PAID) of the caller in this form:
group number<0:7>
member number<8:15>
Considerations
Process access ID (PAID) compared to creator access ID (CAID):
For a given process, an access ID is a word in the process control block (PCB) that contains a
group number in the left byte and a member number in the right byte. There are two access IDs
used in the operating system.
The process access ID (PAID) is returned from the PROCESSACCESSID procedure and is normally
used for security checks when a process attempts to access a disk file.
The creator access ID (CAID) is returned from the CREATORACCESSID and identifies the user who
created the process. It is normally used, often with the PAID, for security checks on interprocess
operations such as stopping a process, creating a backup for a process, and so on.
The PAID and the CAID usually differ only when a process is run from a program file that has the
PROGID attribute set. This attribute is usually set with the File Utility Program (FUP) SECURE command
and PROGID option. In such a case, the process access ID returned by PROCESSACCESSID is the
same as the user ID of the program file's owner.
Both the PAID and the CAID are returned from the PROCESS_GETINFO[LIST]_ procedures. See
the Guardian User's Guide for information about process access IDs.
PROCESSACCESSID Procedure (Superseded by PROCESS_GETINFOLIST_ Procedure) 1131