# tcl command

The tcl command suspends the process on the specified port, pushes a
 level on that port, and then executes the TCL command.

## Syntax

Note: If the specified process is in the debugger, the tcl command fails with
 an error message.

```
 tcl port.number user-ID tcl.commands{(options)}
```

## Parameter(s)

| options | s | Suppresses messages on the current port. |
| --- | --- | --- |

## Output

- If the command results in terminal output, that output is displayed on the destination port.

- If the output is generated using the messages file (that is, [546] Process in the debugger), the output is also displayed on the port from which the tcl command was issued.

## Example(s)

Executes the count md command on port 33, provided that the current user-ID is
 dm. If the current user-ID is not specified or is invalid, the command does not take place.

 The results of the count command display on both port 33 and on the port
 originating the tcl command.

```
 tcl 33 dm count md
```

## See also

- [end command (TCL commands)](https://d3codex.com/tcl/end-command-tcl-commands/)
- [Background/Phantom process overview](https://d3codex.com/backgroundphantomprocess/background-phantom-process-overview/)
- [poke command](https://d3codex.com/tcl/poke-command/)
- [Port number](https://d3codex.com/definitions/port-number/)
- [tcls command](https://d3codex.com/tcl/tcls-command/)
- [users file](https://d3codex.com/systemfiles/users-file/)
- [z command (Background/Phantom process commands)](https://d3codex.com/backgroundphantomprocess/z-command-background-phantom-process-commands/)

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