FLUSH

Syntax

Example

Description/Remarks

FLUSH port_number

FLUSH 1

Clears the RS232 input buffer. Does not return a value.

If you need to flush COM port 0, use FL0.

In most cases, this command actually closes the COM port. This allows you to run one template with RS232 entry and then close the COM port (FLUSH), leave this first template open on the workstation, and then run a second RS232-entry template on the same workstation.

In a client session under Citrix or Terminal Services, this command does not close the COM port.  It simply clears all characters from the COM port by reading them.

Note:  Although this command has been updated to work better with Terminal Services, it is still not recommended as it may cause the system to become unstable.

 

Note:  If a data entry operator presses CTRL+K during data entry to bypass the RS-232 device and enter data values via keyboard, the data entry session will replace any RS232 input mode cells with Keyboard input mode cells. However, the data entry session will still try to execute all commands in the template – including the FLUSH command – and the operator may not be able to complete data entry without access to the RS-232 device.
If this will cause significant problems during data entry, you may need to create a second template for keyboard data entry that can be used when the RS-232 device is not available.