Guardian Application Conversion Guide

Being Opened by and Communicating With a High-PIN Requester
Converting C Applications
096047 Tandem Computers Incorporated 5–33
Setting the
HIGHREQUESTERS
Attribute to Allow High-PIN
Openers
The HIGHREQUESTERS object-file attribute allows a process to support requests from
high-PIN requesters. Use the HIGHREQUESTERS object-file attribute only for a
source program that contains the main function. You can set the HIGHREQUESTERS
object-file attribute by including a compiler pragma in your source file, or you can set
it after you have finished converting your source code either using a compiler option
or after compilation using the Binder program.
To set the attribute when you compile your program, specify the HIGHREQUESTERS
pragma in your source code or as a compiler option in the TACL RUN command for
the C compiler. The BINSERV program then sets the HIGHREQUESTERS attribute in
the object file. An example of this pragma in a source file is:
#pragma HIGHREQUESTERS
An example of this pragma as a compiler option is:
10> C /IN csrc, OUT $s.#clst, NOWAIT/ cobj; HIGHREQUESTERS
You need to specify the HIGHREQUESTERS pragma only once during a compilation.
If your existing program includes source code from another file, specify the
HIGHREQUESTERS pragma only in the program file that contains the main function;
do not specify the pragma in the included file (or files).
If you do not set the HIGHREQUESTERS attribute when you compile your program,
you can set it after compilation using Binder. For a single object file, use the Binder
CHANGE command:
@CHANGE HIGHREQUESTERS ON IN cobj
If you are binding more than one object file into a single target object file, use the
Binder SET command to set the HIGHREQUESTERS object-file attribute. For Binder
to set the HIGHREQUESTERS object-file attribute in a target object file, the object file
containing the main function must have this object-file attribute set.
For more information about the HIGHREQUESTERS object-file attribute, refer to
“Allowing Opens by High-PIN Requesters” in Appendix C, “System Compatibility.”