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

BSP$-Program File Basic Service Package
022
024
Table not in main storage. Caller must have first done an RPFxxT$ call.
User error
normal return
Last item referenced written.
This function should be called only if the previous BSP$ functions: search table (xxIS$),
delete item (xxIS$), entry look-up (xxNL$), change item (xxIC$), or add item (xxIA$)
resulted in a normal return. In each case, register A0 has the address of the table item
processed by the function. The PTxxWT$ function will write the 1 or 2 sectors (28 or 56
words) that contain the table item to mass storage. Note the following about this
function:
• It is not necessary to call this function after the delete item, change item, or add
item functions. The modified item will be written to mass storage either before
BSP$ reads the next buffer or when the WPFxx$ function is called.
• This function should be called only if it is determined that the table item must be
written to mass storage immediately.
• This function is very inefficient, particularly if many table items need to be written,
for the following reasons:
− Writing small buffers of 1 or 2 sectors incurs a large amount of overhead.
− Because each table item is only a partial sector, each sector may need to be
written multiple times. For the element table, each sector is written an average
of 3.6 times. For the other program file tables, each sector is written an average
of 7 times.
• The mark item as updated (xxIS$) function (see 5.1.9) should be considered as a
more efficient alternative to this function.
5.1.9. Mark Item as Updated
The BSP$ entry points for marking the last program file table item referenced as having
been updated are:
(CB)ETIU$ Element Table Item Updated
(CB)APTIU$ Assembler Procedure Table Item Updated
(CB)CPTIU$ COBOL Procedure Table Item Updated
(CB)FPTIU$ FORTRAN/PLUS Procedure Table Item Updated
(CB)EPTIU$ Relocatable Element Entry Point Item Updated
5–30 7833 1733–004