Command
	savses

Purpose
	Saves text (commands, output, errors) from current session.

Aliases
	savesession, savses

Syntax
	savses	[ <options> ]

Options
	-a	Save all. Output and Errors are also saved along with commands. Without this option,
		only commands are saved, output and errors are not saved.

Arguments
	None

Stream Input	
	Ignored.

Stream Output
	The session text is written to the stream output.

Stream Error
	Any errors are listed here.

Description
	This command saves the text from current session. The session text contains the
	following.

	- Commands entered on the command line. These are always saved.

	- Output and errors from these commands written to the screen. This part of
	the session text is saved only if the -a option is specified.

	In case the -a option is specified, only the output and errors written to the screen
	are saved. Redirected output and errors are not saved.
		
Restrictions
	This command is available only in interactive mode. In batch or non-interactive mode,
	the commands, their output and errors are all saved using redirection.

	For performace improvement, output and errors written to screen are limited in size.
	When their size becomes large, it is periodically shortened by the system by
	removing output and errors from the earliest commands. As a result, with the -a
	option, the saved session text is sometimes NOT the full session text, but the
	latest session text.

	If -a option is not specified, all commands are saved, including the earliest commands.

Valid Examples
	savses > "C:/TodaysSession.txt"
	Will save the commands to the specified file.

	var str datetime
	set $datetime=gettime()

	# Get the date
	var str date
	set $date = { chex "8]" $datetime }
	
	# Create file name reflecting the date
	var str file
	set $file="C:/Session_"+$date+".txt"

	savses -a > { echo $file }

	The above will save commands, output, error to file C:/Sessions/Session_<today's date>.txt.
	C:/Sessions/Session_20080725.txt is an example.

Invalid Examples
	

See Also
gettime