Configuration details
The driver initializes itself after it has internalized its configuration. If
MODE
is ftp and the FTPDELAY
flag is not set, then the driver attempts to connect to the
configured FTP server and log in.
If the driver is configured for inbound, then it initializes that.
- If
IBSTYLE
is anything except single, then it initializes its multi-message state by opening its multi-message state file, fileset-<threadname>. - If that file shows the driver was in the midst of processing a file when it shut down, then the driver opens the data file and prepares to read from the correct position. It does this by skipping past messages it has already read.
- If
MODE
is "local-oldest" or "local-tps", then the driver tests to ensure it can open and accessIBDIR
. - If
MODE
is "local-tps" or "ftp", then the driver runs theIBDIRPARSE
andIBDEL
TPS procedures in start-up mode.
CONTINUE
messages returned by each are handled as usual. There
is no outbound initialization.
MODE
determines locality, or file transfer directions, for all
of its operations. How the driver determines whether it is configured for inbound-only,
inbound and outbound, or outbound-only depends on the MODE
.
MODE
choices are:
- The "local-oldest" mode scans the
inbound directory and builds an oldest-first list of the files. It re-scans the
directory if it was accessed or modified from the last scan. As long as there are
files available, it processes them in order according to
IBSTYLE
. When it completes each file, it removes it from the inbound directory. - The "local-tps" and "ftp" modes rely on user-supplied TPS procedures to parse inbound directory listings and populate an ordered list of files to process. When the driver’s list is empty, it scans the inbound directory and places the results into a message.
- The "local-tps" mode lists space-separated file names from the inbound directory, which skips only "." and "..".
- The "ftp" mode, if required, sends
the CWD <FTPIBDIR> command to the server to
move into the correct directory. Then, send the
FTPDIRLISTCMD
string. Specify aFTPDIRLISTCMD
string that generates the data your procedure requires to order the files.The driver reads and processes inbound files and messages if the
IBDIR
value is not empty for local-*, or theFTPIBDIR
value is not empty for ftp. It similarly processes outbound operations using theOBDIR
andFTPOBDIR
values.
If MODE
is "ftp" or "local-tps", then the
driver uses the IBDIRPARSE
and IBDEL
TPS UPoCs to determine the order that available files are processed.
Specify "ftp" if the driver is to perform FTP operations.
Specify "local-oldest" or "local-tps" for local-only operation.