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 access IBDIR.
  • If MODE is "local-tps" or "ftp", then the driver runs the IBDIRPARSE and IBDEL 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 a FTPDIRLISTCMD 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 the FTPIBDIR value is not empty for ftp. It similarly processes outbound operations using the OBDIR and FTPOBDIR 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.