z/TPF Program Management - IBM

APP := BILL
ASM_SRC := bill.asm
ASM_SRC += a123.asm
maketpf_env := billing
maketpf_env += base_rt
include maketpf.rules
The only difference from the example in “Create a single-segment BSO” on
page 61 is the addition of a second BAL segment.
2. Create two source segments: /home/joe/mywork/billing/rt/src/bill.asm and
/home/joe/mywork/billing/rt/src/a123.asm.
3. Update the user control file with entries 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;STUB;DEMAND;DEBUG;
50;PROGRAM;NOGRP;IBM_DEFT;BPAUTH;RESTRICT;MONTC;KEY0;NOCMB;TIMESLICE;;;;;;;;;;;;;
c. Add a new stub entry for each of the additional entry points.
A123;STUB;billing/rt/src/bill.mak;;ALL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
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 bill
See “maketpf utility” on page 6 for more information about the maketpf
command and its options.
Use common source files in multiple-segment BSOs
As an extension to the multiple-segment BSO topic, it is possible to include the
same BAL source file in two or more BSOs. However, this can lead to a problem
when two or more BSOs have a commonly named entry point. Therefore, an
additional step must be taken to suppress the common entry point in all but one of
the BSOs. To do this, you must use an export file.
To demonstrate, consider two BSOs named BILL and CRDT, both of which contain
source file a123.asm. We want to suppress the external A123 entry point from CRDT
and only export it from BILL. This task assumes that “Create a multiple-segment
BSO with multiple external entry points” on page 62 has been completed before
starting this task.
1. The BILL makefile remains as shown in “Create a multiple-segment BSO with
multiple external entry points” on page 62.
2. Create a new makefile (/home/joe/mywork/billing/rt/src/crdt.mak) as shown
in the following example:
APP := CRDT
ASM_SRC := crdt.asm
ASM_SRC += a123.asm
APP_EXPORT := LIST
maketpf_env := billing
maketpf_env += base_rt
include maketpf.rules
Assemble, compile, and link (build) application programs 63