Skip to main content

COMn

Default settings for COM ports.

Synopsis

[ComPorts]    COMn=a;b

Description

The parameters COMn apply to Windows platforms only. These parameters define the default settings for COM ports. This enables remote logins to Caché through locally connected or modem connected serial ports.

The number n refers to the physical com port number. If the [ComPorts] section contains enough entries, n may have multiple digits.

Each COMn entry provides two semicolon-separated values that define the default settings for COM port number n. From left to right:

  • A set of COM port control parameters (data bits, parity, etc.) in byte-positional format. Byte position is one-based. From left to right:

    • Byte 1: Modem Control

      • '1' Use modem control (selected in the 1801X11 example below)

      • '0' Do not use modem control

      • ' ' No change to modem control (this is the default)

    • Byte 2: Data Bits

      • '5' 5 data bits

      • '6' 6 data bits

      • '7' 7 data bits

      • '8' 8 data bits (selected in the 1801X11 example below)

      • ' ' No change to bit size (this is the default)

    • Byte 3: Parity

      • '0' No parity (selected in the 1801X11 example below)

      • '1' Odd parity

      • '2' Even parity

      • '3' Mark parity

      • '4' Space parity

      • ' ' No change to the parity setting (this is the default)

    • Byte 4: Stop Bits

      • '1' 1 stop bit (selected in the 1801X11 example below)

      • '5' 1.5 stop bits

      • '2' 2 stop bits

      • ' ' No change to the stop bit setting (this is the default)

    • Byte 5: Flow Control

      • 'X' Use Xon/Xoff flow control (selected in the 1801X11 example below)

      • 'C' Use CTS/RTS flow control

      • 'D' Use DSR/DTR flow control

      • ' ' No change to flow control (this is the default)

    • Byte 6: DTR Setting

      • '0' Disable DTR (set it off, keep it off)

      • '1' Enable DTR (set it on, keep it on) (selected in the 1801X11 example below)

      • ' ' No change to the DTR state (this is the default)

    • Byte 7: $ZA Error Reporting

      • '0' Disable $ZA error reporting

      • '1' Enable $ZA error reporting (selected in the 1801X11 example below)

      • ' ' No change to $ZA error reporting (this is the default)

  • The baud rate. If not supplied, the default baud rate is 19200.

Examples

The following example of a [ComPorts] section shows how spaces can be used as values within the COM port control parameter:

[ComPorts]
COM1=       ;19200
Copy code to clipboard

The first example uses all defaults for the COM port control parameters, by providing seven spaces before the semicolon separator. The meaning is: No change to modem control, no change to bit size, no change to parity setting, no change to stop bit setting, no change to Flow control, no change to DTR state, no change to $ZA error reporting.

[ComPorts]
COM2=1801X11;19200
Copy code to clipboard

The second example provides a value of 1801X11 for the COM port control parameters. The meaning is: Use modem control, 8 data bits, no parity, 1 stop bit, use Xon/Xoff flow control, enable DTR, enable $ZA error reporting.

Range of Values

As described above.

Management Portal

No equivalent.