Software Reference Manual - NetEx

Addition of Record and Block Modules
The BFX program supports and uses the BFX default block and record modules to copy sequential files.
BFX is designed to allow user-written modules to be added. In order for a user-written module to be added to
BFX, one or more entries must be added to the MDT Module Table that is used by all three of the BFX programs.
This table associates:
1. An alphabetic name of the module, one to eight characters in length.
2. The type of module, (receiving block, sending record, job submission, and so on).
3. The entry address of the module.
4. The source language of the module. If the module is written in the FORTRAN high level language, BFX
will establish the high level language run time environment before calling the module as a high level language
subroutine.
Members BFXASM and BFXLINK, contained in “hlq.BFXCTL”, can be modified as needed and used to perform
the assemblies and links for the record and block modules.
BFXMOD Macro Parameters
In order to add a module, the BFXMOD macro must be coded. Its parameters are shown in Figure 14.
| RBLK |
| SBLK | | ASM |
BFXMOD | RREC | ,alpha name,entry addr | FORT |,[initep]
| SREC |
| JOBS |
Figure 14. BFXMOD Macro
The following parameters appear in the BFXMOD macro. BFXMOD is the keyword name of the macro.
RBLK, SBLK, RREC, SREC, or JOBS
alpha-name
entry-addr
These parameters are the five possible module types being generated with this BFXMOD macro.
One of the five is selected. Note that the calling user does not distinguish between a send and a receive
type module, but that the BFXMOD macro does make that distinction. Two modules may have
the same alphabetic name even though their types are different. Thus a user module could be called
CUSTMOD as both a send and receive record module; normally a different entry address would be
called depending on whether the record module was receiving data or had the responsibility of sending
data.
This parameter is the character name that the user will specify on the BMODULE, RMODULE, or
JMODULE control parameters to invoke the desired module. This name may be any alphanumeric
string 1 to 8 characters in length.
This parameter is the label of the entry point in the module. The macro will generate a V-type constant
using this label and branch to the address placed there by the linkage editor.
Page 56 Installing BFX MAN-REF-H211-05