The X/Y Modem over Serial communication point implements the X/Y Modem Protocol 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:

  • COM3 (default).
  • LPT1.
  • LPT2 - Windows® environment only.

Baud Rate

Specifies the speed of the serial connection between 50 and 115200 baud (the default is 9600 baud).

Parity

Specifies the data parity mode:

  • Even.
  • Mark.
  • None (default).
  • Odd.
  • Space.

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

How long (in milliseconds) to wait for the init sequence to be processed (0 (zero) means no limit).

Protocol

Specifies the protocol to be used to connect with the remote host:

  • XModem (default).
  • XModem-CRC.
  •  XModem-1K.
  •  YModem.
  •  YModem-G.

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 inhexadecimalform:

  • 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: com3, LPT1, LPT2 (Windows® environment only)
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.

Parity

Options: Even, Mark, None, Odd, Space. Default: None
Identifies the data parity 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

How long (in milliseconds) to wait for the init sequence to be processed (0 (zero) means no limit).

Protocol

Options: XModem, XModem-CRC, XModem-1K, YModem, YModem-G . Default: XModem.
Identifies the protocol to be used to connect with the remote host.

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 property.
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 log the information to.

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 the list of published properties. Refer to Published Properties for details.

Published Properties

Published properties for the X/Y Modem over Serial communication point 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.