z/TPF Program Management - IBM

Adding the line APP_EXPORT := LIST directs the MakeTPF tools to use a file
named CRDT.exp during link time.
3. Create a source segment named /home/joe/mywork/billing/rt/src/crdt.asm.
4. Create an export file named /home/joe/mywork/billing/rt/exp/CRDT.exp
{
global:
CRDT_BSO;
local:
A123_BSO;
};
See “Create an export file” on page 69 for more information about creating
export files.
5. Update the user control file and add a new entry for the program named CRDT.
Enter the following information on one line.
CRDT;APP;billing/rt/src/crdt.mak;1;ALL;OBJ;TPF_SBALL;LOADONLINE;STUB;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.
Add stubs for BAL programs with transfer vectors
Create a C shared object
64 z/TPF Program Management
BSOs also can have multiple entry points when transfer vectors are used. No
changes need to be made to the BSO makefiles that are already shown. The only
additional step required is to add STUB entries to the control file for each of the
transfer vector names.
By convention, make the STUB entry in the control file refer to the parent BSO
program makefile name if a unique makefile exists, or to the parent BSO name if a
generic makefile was used to build the parent BSO. For example, if XVB1 is a
transfer vector in the BSO named BILL, the STUB entry in the control file could be
coded as either of the following:
v XVB1;STUB;billing/rt/src/bill.mak;;ALL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
v XVB1;STUB;BILL;;ALL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
The value provided in the third column has no effect on the build of the program or
the stub library; it is used only for reference.
This task shows you how to create and build a new makefile for a C shared object
(CSO). There are many variations on how to code CSOs. A CSO might have only
one entry point, it might be a library that exports some or all of its functions, it might
be a combination of the two, or it might be a main program.
To create a CSO, follow these steps:
1. Create a new makefile (/home/joe/mywork/billing/rt/src/bill.mak) as shown
in the following example:
APP := BILL
C_SRC := billing1.c
C_SRC += billing2.c
maketpf_env := billing
maketpf_env += base_rt
include maketpf.rules