MFFTP Statements

The following statements are checked and processed:

Command Description
# or ; or * Indicates a comment line.
ASCII Specifies that the transfer is in ASCII mode.
BINARY Specifies that the transfer is in BINARY mode.
BYE Ends the FTP session. If MFFTP does not find a BYE statement, it inserts one.
CD Changes directory on remote machine. MFFTP performs a check that "spacey" directory names have been double quoted. If not then it will surround it in double quotes. If single quotes have been used they are replaced with double quotes.

When this is executed, the local name, which would be a mainframe style name, is converted to native format.

If the file does not exist, it is cataloged with the current values as shown by LOCSTat.

If the file already exists within the catalog, the REPlace option must be used, and the existing catalog attributes will be used and the existing file overwritten.

LCD Changes the directory on the local machine. MFFTP performs a check for "spacey" directory names in the same way that CD does.

Many of the options of LOCSIte are not relevant to the Enterprise Developer

Enterprise Server for .NET

environment and are ignored.

The following options are supported:

  • BLKsize or BLOCKSize
  • LRecl
  • PRImary (space allocation)
  • RECfm
  • SECondary (space allocation)
LOCSTat Provides a list of the current settings.
MFFTP_VARS Lists the current settings of all MFFTP variables.

In order to obtain the list of files to be transferred and cataloged, the utility will attempt to connect to the server to produce a list of matches.

This list will be used to create a series of simple GET statements.

Note: All files are processed and cataloged with the same attributes.
MPUT The catalog will be scanned to obtain a list of the files that match the filter criteria. A simple PUT will be created for each file that matches the criteria.

If used, this must be the first statement.

If the OPEN statement has an IP address or host name, this will be overridden by any on the EXEC statement.

PROMPT By default, MGET or MPUT prompts for confirmation. If no PROMPT is seen before an MGET or MPUT is encountered, one will be inserted before and after the generated simple statements.
PUT When this is executed, MFFTP converts the local name, which would be a mainframe style name, to native format.
QUIT Equivalent to BYE.

The distributed platform expects ASCII or BINARY, while the mainframe allows A (ASCII) and I (BINARY).

MFFTP changes the command as appropriate for the respective platform. Using other values causes an error.

USER MFFTP requires that you specify a user. If the keyword “USER” is not seen, it is assumed to be either the first (if no OPEN statement found) or second (if OPEN statement found) statement.