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

BSP$-Program File Basic Service Package
BSP$ is available in both the SYSLIB common bank SYSLIB$1 and as a relocatable
element in the SYSLIB installation file (SYS$LIB$*SYSLIB). The relocatable and common
bank entry points to BSP$ are listed in Appendix E.
5.1. BSP$ Functions
The following descriptions of the BSP$ functions include three calling methods:
relocatable, common bank, and Auto Switch. Entry points to the common bank BSP$
are the same as the relocatble entry points except they are prefixed with the letters CB.
Section 3 describes the SYSLIB access methods.
Some BSP$ functions require that the address of a packet be passed as a parameter.
In those cases, a diagram shows the format of the packet. If a field name is italicized,
the caller must provide a value for the field. All element, version, and procedure names
are 12 Fieldata characters, left-justified and space-filled. DF is the delete flag and is set
to one for deleted items. CI is the continuation indicator and is set to one for COBOL
procedure names longer than 12 characters.
5.1.1. Read FTI
The FTI must be read into the data area provided by the caller for the FCT before any
other operations can be performed. If any add, delete, or change operations are
completed, then a WFTI$ call must be done to write the FTI back to the file.
Two functions are available to read the FTI. The RFTI$ function can be used to read an
existing PF or LPF and to initialize an empty file as a PF. The RFTI$$ function, described
later in this section, can be used to read an existing PF, LPF, or LEPF and to initialize an
empty file as a PF, LPF, or LEPF.
The following describes the RFTI$ function:
Calling Sequence
Auto Switch
L,U A0,address-of-FCT
LMJ X11,CBRFTI$-1
error return
normal return
Common Bank or
Relocatable
L,U A0,address-of-FCT
I$BJ X11,CBRFTI$
error return
normal return
Relocatable
L,U A0,address-of-FCT
LMJ X11,RFTI$
error return
normal return
7833 1733–004 5–3