5-16 Syntax and Parameters
MX2 Reference Guide Revision A MX2A137REFGD
S
Specify Sender’s Path-and-File Handling (Zmodem only)
The S option controls how the sender handles the paths and filenames of
the files that it sends. This option is available only with Zmodem
protocol. You must specify the Z option before using the S option. You
can use one of the following settings. The settings are described
individually below.
0 - Strip paths
1 - Send paths
2 - Send new paths/filenames
If you do not include the S option in the command line, the default
setting (0) is used. If you use the S option without specifying a setting
(for example, XFER /S), it is assumed to mean S0. This is useful in the
case where another option is specified in the XFER_ARGS environment
variable but you wish to strip the paths for the current transfer session.
An invalid setting will result in an error on the command line.
0 - Strip Paths
In this mode (the default), the sender will remove any paths that are
specified with a filename before sending the filename to the receiver.
The new filename will be transmitted to the receiver without any path
information. The file will be stored by the receiver in the current
directory.
1 - Send Paths
This option performs no processing on the filenames specified on the
sender’s side. Any drive and path information that is specified is
transmitted to the receiver. If a path is specified and it does not exist on
the receiver’s side, the transfer will abort with a failure.
2 - Send New Paths/Filenames
When the S2 setting is used, all filenames are treated as filename pairs.
This gives you the ability to specify dual filenames during a transfer.
The first filename (optionally including a drive and path) is the one that
the sender uses to open the file. The second filename is used by the
sender when it transmits the filename to the receiver. This gives you the
ability to transfer a file and have it renamed on the receiver’s side. It also
lets you transfer a file from one directory on the sender’s side to another
directory on the receiver’s side.