18.08.2013 Views

(SYSLIB) Programming Reference Manual - Public Support Login ...

(SYSLIB) Programming Reference Manual - Public Support Login ...

(SYSLIB) Programming Reference Manual - Public Support Login ...

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Section 5<br />

BSP$-Program File Basic Service<br />

Package<br />

The Basic Service Package (BSP$) provides an interface between the calling program<br />

and the table of contents (TOC) of a program file.<br />

The program file format is described in the Data Structures <strong>Programming</strong> <strong>Reference</strong><br />

<strong>Manual</strong>. The file table index (FTI) is the control part of the program file. Figure 5-1<br />

contains a general description of the FTI. The FTI describes five tables that are accessed<br />

by the BSP$ functions.<br />

• Element table<br />

• Assembler procedure table<br />

• COBOL procedure table<br />

• FORTRAN/PLUS procedure table<br />

• Relocatable element entry point table<br />

The part of the program file occupied by the five tables is called the TOC.<br />

BSP$ performs the following functions:<br />

• Reads the FTI into a buffer.<br />

• Reads a selected program file table into a buffer.<br />

• Searches a selected program file table for a specific entry.<br />

• Deletes a specific entry in a program file table.<br />

• Locates a program file table entry from its sequence number in the table.<br />

• Changes a specific entry in a program file table.<br />

• Adds an entry to a program file table.<br />

• Writes the last entry referenced back to the file.<br />

• Marks the last entry referenced in a program file table as having been updated.<br />

• Writes a program file table back to the file.<br />

• Writes the FTI back to the file.<br />

Reading the FTI of a previously unwritten file changes that file to a program file. The<br />

table is not written to the file until BSP$ writes the FTI.<br />

7833 1733–004 5–1

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!