z/TPF Program Management - IBM

Create an export file
EXE := custsumm
TPF_OL := OS/390
C_SRC := list.c
maketpf_env := billing_zos
maketpf_env += base_rt
include maketpf.rules
Note: z/OS programs do not support the use of archives and, because the
programs are written to a PDS, the program name must be 8 characters
or less.
2. Create a source segment named /home/joe/mywork/billing/zos/src/list.c.
3. Update the user control file and add a new entry for the offline Linux program
named custsumm. Enter the following information on one line.
custsumm;ARCHIVE;billing/zos/src/custsumm.mak;1;OS/390;
NOOBJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;
Note: The control file entry uses the value OS/390 ® rather than z/OS. This was
done for compatibility reasons with TPF 4.1 and the terms are
considered interchangeable.
See “Control files” on page 103 for more information about the control file fields
and values.
4. Enter the maketpf command to build the program. This assumes that a file
named maketpf.cfg exists in the /home/joe/mywork/build directory.
cd /home/joe/mywork/build
maketpf custsumm
See “maketpf utility” on page 6 for more information about the maketpf
command and its options.
The following task shows you how to create an export file for a CSO or BSO.
Export files are used to control the entry points that are exported globally and the
ones that are kept local to the object. Export files are required whenever you code
APP_EXPORT := LIST in the program makefile. (An alternate way to change the
scope of symbols that are global for a shared object is to use the -fvisibility
compiler option. Specify -fvisibility=default to indicate that the functions in the
CSO (or C/C++ functions in a BSO) are global for the shared object. Specify
-fvisibility=hidden to indicate that all C/C++ functions are local except where they
are coded with __attribute__((visibility(default))). )
Note: Although we are using a CSO for an example, you can follow the same
steps to create an export file for a BSO.
If you have created a CSO named BILL as described in “Create a C shared object”
on page 64 and have coded APP_EXPORT := LIST in the /home/joe/mywork/billing/
rt/src/bill.mak makefile, you can create an export file by following these steps:
1. Run maketpf to create a preliminary version of the export file.
cd /home/joe/mywork/build
maketpf bill
Note: Export files present a “what came first” problem; you must link the
program to be able to generate the export file, but when you code
APP_EXPORT := LIST, you need an export file at link time. To work around
Assemble, compile, and link (build) application programs 69