z/TPF Program Management - IBM

66 z/TPF Program Management
v CTBX
v CTXO
v COMS
v CPP1
v CTAD
v COMX
v CTHD
v CTDF
v CJ00.
For example, to call a function from a CSO named CRDT from the BILL
CSO, add the following line to the makefile: LIBS := CRDT
You can add additional libraries by separating the names by blanks on the
same line, or by adding additional LIBS += XXXX lines.
g. To call functions from an archive, the referenced archive must be listed in
the calling makefile. For example, to call a function from an archive named
TaxFunctions, add the following line to the makefile: ARCHIVES :=
TaxFunctions
You can add additional archives by separating the names by blanks on the
same line, or adding additional ARCHIVES += ArchiveName lines.
Note: A function that is called from a CSO is dynamically loaded at run
time, but a function that is included from the archive is statically
linked in the calling CSO.
h. To change the assemble, compile, or link options, use flags (ASMFLAGS,
CFLAGS, CXXFLAGS, or LDFLAGS) in your makefile or maketpf.cfg file.
For example, when you are migrating to the z/TPF system, you might want
to load programs below the 2-GB bar.
v To load a single program below the 2-GB bar, add the following statement
to an individual makefile: LDFLAGS_(pgm) := -Xlinker --defsym -Xlinker
CGCC_31BIT=0 where pgm is the name of the makefile.
v To load real-time programs below the 2-GB bar, add the following
statement as an overall configuration option to the maketpf configuration
file (maketpf.cfg) before building the shared object: LDFLAGS_USER :=
-Xlinker --defsym -Xlinker CGCC_31BIT=0
Note: All programs that are built after this flag is added are loaded below
the 2-GB bar.
2. Create two source segments named /home/joe/mywork/billing/rt/src/
billing1.c and /home/joe/mywork/billing/rt/src/billing2.c.
3. Update the user control file with a new entry for the new program:
a. Create a copy of the control file in your working directory: cp
/tpf/z11/local_mod/base/cntl/usr.cntl /home/joe/mywork/base/cntl/
usr.cntl
b. Edit the file that you just copied and add a new entry for the program named
BILL. Enter the following information on one line:
BILL;APP;billing/rt/src/bill.mak;1;ALL;OBJ;TPF_SBALL;LOADONLINE;NOSTUB;DEMAND;DEBUG;
50;PROGRAM;NOGRP;IBM_DEFT;BPAUTH;RESTRICT;MONTC;KEY0;NOCMB;TIMESLICE;;;;;;;;;;;;;
See “Control files” on page 103 for more information about the control file fields
and values.