# capture-on command

The capture-on BASIC program enables the capturing of every TCL
 command issued. The captured output is placed in the captcl file using
 *user-ID*port.number* as the item-ID.

If it does not exist, the captcl file is created using this command.

## Parameter(s)

| options | s | Silent operation option suppresses message output. |
| --- | --- | --- |

## Example(s)

The following example illustrates how a series of TCL commands can be trapped to a file:

```
capture-on
Capturing started on 14:53:11 01 February 2003 on pib# 22
term ,,,,,,79,52
sp-assign hs f11
sselect d3.doc by category
save-list d3.doc.by.category
get-list d3.doc.by.category
list d3.doc category token (p
capture-off (x
capturing turned off on 14:56:18 01 February 2003 on pib# 22
```
The sequence of the previous commands is trapped in the item, dm*22 in the
 captcl file:

```
list-items captcl
Page 1 captcl 17:58:21 01 Feb 2003
dm*22
001 term ,,,,,,79,52
002 sp-assign hs f11
003 sselect ad by category
004 save-list d3.doc.by.category
005 get-list d3.doc.by.category
006 list d3.doc token category (p
007 capture-off (x
[405] 1 items listed out of 1 items.
```

## See also

- [capt command](https://d3codex.com/tcl/capt-command/)
- [capture-off command](https://d3codex.com/tcl/capture-off-command/)
- [execute statement (UNIX)](https://d3codex.com/pickbasic-flashbasic/execute-statement-unix/)

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