Zmodem Serial (RS-232)

The Zmodem Serial communication implements the ZModem protocol over a serial (RS-232) port.

Refer to Published Properties for a list of properties associated with this communication point.

Refer to Serial Port Problems on UNIX for details about common problems when running serial communication points on Unix.

Serial communication points are only available on Windows and Linux (unavailable on HPUX, Solaris and AIX).

Supported Operational Modes: Input, Output.

Input Mode Properties

Property	Description
Port Name	Specifies the name of the port to which you want to connect: `COM1` (default). `LPT1`.
Baud Rate	Specifies the speed of the serial connection between `50` and `115200` baud (the default is `9600` baud).
Stop Bits	Specifies the number of stop bits (the default is `1`).
Parity	Specifies the data parity mode: `Even`. `Mark`. `None` (default). `Odd`. `Space`.
Flow Control	Specifies the Flow Control mode: `None` (default). `RTS/CTS`. `XON/XOFF`.
Init Sequence	The sending/expected sequence pairs which will be used for the serial transport initialization before sending the message to the remote host.
Init Timeout	The length of time, in milliseconds, to wait for the init sequence to be processed. `0` (zero) means there is no limit. The minimum value is `60000` milliseconds (60 seconds).
Streaming Mode	Whether or not to use data streaming mode: `true` - enabled. `false` (default) - disabled. This should be disabled for noisy lines.
Log Connections	Whether to log connections: `True` - establishing and dropping of all connections to the communication point are logged to the log file specified in the Connection Log File property. `False` (default). Use of this logging facility slows the communication point down considerably. It is intended for debugging purposes and should not generally be used.
Log Data	Whether to log data: `True` - all data passed over the connections of the communication point is logged to the log file. This is potentially a large amount of data. `False` (default).
Log Data As Hex	Whether to log data in hexadecimal form: `True` - the hexadecimal representation of the data is logged to the log file. `False` (default) - the data is logged exactly as it is as it passes over the communication point connection.
Connection Log File	The full file name (path and file name) of the file on the server to which you want to log the information.
Extra Information	Whether to log extra information: `None`. `Log Time` (default) - log timestamps with each event.

Output Mode Properties

Property	Description
Port Name	Options: `COM1`, `LPT1` Default: `COM1`. Identifies the name of the port to which you want to connect.
Baud Rate	Options: `50 - 115200` . Default: `9600`. Identifies the speed of the serial connection.
Stop Bits	Identifies the number of stop bits. Default: `1`.
Parity	Options: `Even`, `Mark`, `None`, `Odd`, `Space`. Default: `None`. Identifies the data parity mode.
Flow Control	Options: `None`, `RTS/CTS`, `XON/XOFF`. Default: `None`. Identifies the Flow Control mode.
Init Sequence	The sending/expected sequence pairs which will be used for the serial transport initialization before sending the message to the remote host.
Init Timeout	The length of time, in milliseconds, to wait for the init sequence to be processed. `0` (zero) means there is no limit. The minimum value is `60000` milliseconds or 60 seconds.
Streaming Mode	Options: `true`, `false`. Default: `false`. Sets whether or not to use data streaming mode. This should be disabled for noisy lines.
Log Connections	Options: `true`, `false`. Default: `false`. If `true`, establishing and dropping of all connections to the communication point are logged to the log file specified in the Connection Log File field. Use of this logging facility will slow the communication point down considerably. It is intended for debugging purposes and should not generally be used.
Log Data	Options: `true`, `false`. Default: `false`. If `true`, all data passed over the connections of the communication point is logged to the log file. This is potentially a lot of data.
Log Data As Hex	Options: `true`, `false`. Default: `false`. If `true`, the hexadecimal representation of the data is logged to the log file. If `false`, the data is logged exactly as it is as it passes over the communication point connection.
Connection Log File	The full file name (path and file name) of the file on the server to which you want to log the information.
Extra Information	Options: `None`, `Log Time`. Default: `Log Time` If set to `Log Time`, the timestamps will be logged with each event.
Output Filename	Define the filename to give messages that are sent to the remote host. This can be entered directly or selected from a list of available Rhapsody variables. Refer to Rhapsody Variables for details.

Published Properties

Published properties of an INPUT communication point on a route are added to all drop-down lists where message properties can be selected on that route. For the Zmodem Serial communication point, these are:

Full Filename - the full filename of the file associated with the received message.
Base Filename - the base filename (that is everything before the last '.' in the full filename) of the file associated with the received message. If there is no '.' then it is equal to the full filename.
Suffix - the suffix (everything from the last '.' in the full filename, including the '.') of the file associated with the received message. If there is no '.' then it is empty.