SESSIONLOG        Control the Session Log file

Top  Previous  Next

Syntax:

SESSIONLOG

[ file name ]  |  [ /options ]

Arguments:

[ file name ]

Optional variable or string defining a file or path name; if no path is defined Robo-FTP’s working folder is used.

Options:

/delete

Delete an existing default session log file. This file is normally concatenated to and can grow quite large if not deleted before

 

/off

Turn session logging off.

 

/on

Turn session logging on (assuming that [ file name ] has been previously defined on an earlier call to SESSIONLOG or a log file has been previously defined under the Logging menu of the Robo-FTP Configurator).

 

The Session Log file records diagnostic messages that may be helpful in troubleshooting secure (SSH/SSL) file transfer failures. Information about normal (non-secure) file transfer sessions does not appear in this file.

 

If the [ file name ] argument is present, this script command creates a new session log file by this name. It is also implied that logging is to be enabled.

 

The following command specifies a secure session log file and enables logging if it is not already enabled.

 

SESSIONLOG "new_session.log"

 

The following command specifies a secure session log file, deletes the currently defined file (if any) and enables logging if it is not already enabled.

 

SESSIONLOG "new_session.log" /delete

 

If [ file name ] is omitted, the /on and /off options control logging to a previously defined log file. When logging is turned on, new log messages are appended to the existing log file. For example:

 

SESSIONLOG /on

 

If this command is issued when connected to a secure FTP site, any changes to the session log file will take place after logging off and back on again.

 

Important

In most situations you should only enable the Session Log while actively troubleshooting a secure session problem. This file will become huge over time unless you use the /delete option and is is rarely useful for anything other than debugging secure connection issues.

 

 

Related Command(s): LOG, TRACELOG , TRACEWIN

See also: Basic Logging, Advanced Logging