# set-port command

The term set-port BASIC program displays
or changes the communication speed and protocol for a specified port
or displays the current setting if none of the communication parameters
are specified.

**Synonyms:** status-port, set.port

## Syntax

```
set-port [tty|port.number]{,baud,parity,stop.bits,word.length} {(options}
```

## Parameter(s)

| tty | Device name where the process is connected. For UNIX: The tty parameter is supported by UNIX only. For Windows: Not Supported. | |
| --- | --- | --- |
| port.number | Serial port number to change. The current port can be specified by specifying port -1. | |
| baud | Baud rate—Legal baud rates are: 110, 150, 300, 600, 1200, 2400, 4800, 9600, and 19200. | |
| parity | n or 0 for no parity o or 1 for odd parity e or 2 for even parity m for mark parity s for space parity | |
| stop.bit | Number of stop bits—Valid numbers are 1 or 2. | |
| word.length | Data length—Valid numbers are 7 or 8. | |
| options | i | Updates devs,init as well as the pick_term file. |
| q | Suppresses the display of the current set-port settings. | |
If no options are entered, the current port settings display.
If any option is entered, then all options must be entered.

## Example(s)

```
set-port
Line number : 1
Baud rate : 0
Parity : None
Stop bits : 0
Word length : 0
```

## D3 UNIX Systems

The port can be specified
either by its serial port number, or by a device name (for example,
/dev/tty03), in which case the port does not have to be connected
to the D3 virtual machine. /dev/ can be omitted. This command is provided
for compatibility with non-UNIX implementations.

If no UNIX
process is connected to the device, set-port displays:

```
Process not connected
```
In this case, the device is probably not initialized properly
or not connected to a physical terminal.

---
Source: https://d3codex.com/tcl/set-port-command/ - part of the D3Codex reference.
