Protocol Tags

DUMP

Need some easy method for recording what a protocol has been doing - sort of 'we are here' type function.

[DUMP Filename Text]

Filename - Name of the file to write the text to (if no '/' in filename will use /tmp)
Text - Text to write to filename

[dump monitor In the xxxx bit
<[dump monitor No jumped to xyz

Will create a text file /tmp/monitor with

In the xxxx bit
No jumped to xyz

In it

All available reserved words will be checked for

The [Dump xx yy] option will create the file if needed, will append text to, if it can't open/create it it will be silently ignored.

The Filename will be checked for and if it finds them they will be replaced with a number - this allows a difference filename to be used by different users.

Should you want to pass details over to a definition file to generate a handout the corrisponding command in definition file processing is @file(Filename Text).

Tidy Up

A sister tag [Delete FileName] is supported to allow you to remove the file as part of the tidy up routines. The system will not remove the file automatically - it's up to the script author to do that.