Software Reference Manual - NetEx

Using BFX
To use BFX, the programmer must write two applications. These applications will be referred to as the initiating
procedure and the responding procedure. The initiating procedure is executed on one system, and the
responding procedure is executed on the other system. Each procedure is written using BFX command statements
for the BFX product used on that procedures host. The structure and contents of the initiating and responding
procedures vary according to the application. There are three basic applications.
Manual job submission - the users on the two systems each submit one BFXTI/BFXTR job.
Automatic job submission - the user on the initiating system submits the BFXTI job which contains the
job control statements for the responding BFXTR job. The responding job is sent over the network to
BFXJS and automatically submitted on the responding system. The BFXTI/BFXTR jobs then connect
and transfer files.
Remote job submission - the user on the initiating system submits a BFXTI job which contains job control
statements for a remote job. The remote job is sent over the network to BFXJS and is submitted for
execution on the responding system. This remote job executes independently of BFX.
The following paragraphs describe the contents of these user procedures for each application, and describe
how BFX processes the user requests.
Manual Job Submission
Manual job submission is the most basic application of BFX. Manual job submission enables users in the
initiating and responding systems to manually submit BFX jobs for processing.
When using manual job submission, the user must provide an initiating job that uses BFXTI, and a responding
job that uses BFXTR. Both the initiating and responding jobs are written using the job control language
and BFX commands for the host they will be executed on.
Both the initiating and responding jobs contain matched sets of SEND and RECEIVE BFX commands. A
SEND in one procedure must match a RECEIVE in the other procedure. The SEND command specifies the
file to be read from the host that issued the SEND command. The RECEIVE command specifies the file to be
written to the host that issued the RECEIVE command. The SEND and RECEIVE commands may also specify
other information about the data being transferred. The first SEND or RECEIVE command in the BFXTI
job must specify NOSUB as a parameter to select manual job submission.
To begin the file transfer, a user on one host submits the BFXTI job, and a user on the other host submits the
BFXTR job. When the jobs are executed, the BFXTR program connects to the BFXTI program (via NETEX
and the IP network) and the files are transferred.
The example procedures in Figure 2 and Figure 3 on page 4 and the following text and diagrams illustrate the
manual job submission process. Assume that a user on the initiating host (ZOS1) wants to send two members
of a partitioned data set (BMD and BMC) to the responding host (ZOS2), and receive member NSEFOI from
the responding host using manual job submission. The user writes the JCL jobs shown in Figure 2 and Figure
3
MAN-REF-H211-05 Introduction Page 3