z/TPF Program Management - IBM

|
Update the FACE table
v If a function is called before the data is referenced, code
TPF_RUN_TPFSOCHK:=NO in the makefile for the program.
v If the program will not be used before all programs not marked as DEMAND in
the control files have been fetched during restart, ensure that the program is
defined as DEFAULT in its control file and code TPF_RUN_TPFSOCHK:=NO in the
makefile for the program.
v If you must code the program as DEMAND in the control files or if it is coded as
DEFAULT but may be used before all programs not marked as DEMAND in the
control files have been fetched during restart, the programs that are importing the
data objects that triggered the warning can ensure that the exporting program
has been fully fetched by issuing the GETPC macro or getpc function, or by
calling a function in the exporting program before referencing the exported data
object. You also must code TPF_RUN_TPFSOCHK := NO in the makefile for the
program to avoid the warning in the future.
v You also can avoid this warning by marking the program as PRELOAD in its
control file.
See “Control files” on page 103 for reference information about coding control files.
For more information about Makefiles, enter man maketpf.mak on your Linux build
system for a complete list of Makefile variables that can be coded.
To update the file address compute (FACE) program table, follow these steps:
1. Copy the sip.asm file to your user directory. For example, if you are working on
the basic subsystem (BSS), enter:
mkdir -p /home/joe/mywork/bss/src
cp /tpf/z11/bss/src/sip.asm /home/joe/mywork/bss/src/sip.asm
2. Edit the sip.asm file that you just copied and update the data definition
statements (RAMFIL, UFTFTI, ONLFIL, and others).
3. Enter the bldtpf command to generate an alternate FACE table (FCTB). This
example assumes that a file named maketpf.cfg exists in the
/home/joe/mywork/build directory:
cd /home/joe/mywork/build
bldtpf -fctb /home/joe/mywork/bss/src/sip.asm
Note: This command produces an updated FCTB (FCTB.so) and a set of source
files and macros that are produced while assembling the FCTB.o object.
See “bldtpf utility” on page 5 for more information on the bldtpf command; also,
enter man bldtpf on your Linux system for more information, including the
syntax.
4. Enter the fctbval command to check your changes to the FCTB. For example:
fctbval /tpf/z11/bss/load/FCTB.so /home/joe/mywork/bss/load/FCTB.so
This command performs the same FCTB validations that are done online with
the ZFCTB LOAD command and produces a list of differences to help you verify
your changes. If there are validation errors or differences that you do not
expect, repeat the procedure from step 2 and make any necessary corrections.
See “fctbval utility” on page 5 for more information about the fctbval command;
also, enter man fctbval on your Linux system for more information, including
the syntax.
5. Load the alternate FCTB to your z/TPF system. In this example, step 3 placed
the FCTB in /home/joe/mywork/bss/load/FCTB.so.
Assemble, compile, and link (build) application programs 71