LogOpen

Message

LogOpen <filename>

Originator

Client

Response

Info: log opened

SyntaxError: insufficient parameters to LogOpen

SyntaxError: invalid parameters to LogOpen

Error: file exists or cannot open file

Error: log already open, close that one first

Response (immediate socket)

Success

Failure

Details

Opens a text log. Each Whisker client can only have one primary log file open at once. That log can be used to record significant events, client–server communications, and arbitrary status reports from the client. All entries are date- and time-stamped.

The log is started as soon as it is opened.

Logs have the following output format:

SystemDate_YMD,SystemTime_HMS,Time_ms,Source,Text

2001-11-05,21:40.48,40927,Log,LOG_OPENED

2001-11-05,21:40.48,40927,Log,Recording options: events off keyevents off clientclient off comms off signature on

2001-11-05,21:40.48,40927,Server,Info:...

2001-11-05,21:40.48,40927,Server,Info:...

2001-11-05,21:40.48,40927,Server,ImmPort: 1334

2001-11-05,21:40.48,40927,Server,Code: 0_41

2001-11-05,21:40.48,49046,Client-IMM,ClaimGroup box0

2001-11-05,21:40.48,49047,Server-IMM,Failure

2001-11-05,21:40.48,49049,Client,RelinquishAllLines

2001-11-05,21:40.48,49049,Server,Info:...

...

2001-11-05,21:40.48,600,Client-MSG,Task beginning, score 0.

2001-11-05,21:40.48,10204,Server,Event: Lever_pressed

The SystemDate and SystemTime field are the server's computer clock; the Time_ms field is the timestamp clock (see TimeStamps); the Source field indicates the source of the log entry; the Text field contains the entry itself.        

Revision history

Implemented in WhiskerServer version 2.6.8.