Command
	fdset

Purpose
	Set file/directory information.

Aliases
	fdset, fds, touch

Syntax
	fdset [<options>] <filedir> [<time>]

Options
	-m	Set latest modification time.

	-a	Set latest access time.

	-c	Set creation time.

	If no options are specified, all times are set.

Arguments
	<filedir>	Specifies a file or a directory whose information items or attributes are to be set.
		It can be file/directory name or path. Path can be relative or absolute.

		Name patterns are NOT allowed.

		If this argument is specified using a string constant, such as "todays report.txt" or
		"C:/latest reports", we recommend using double quotes around it. This is to
		allow for spaces and other special characters that may be present in the
		file/directory name or the path.

	<time>	Time string of up to 14 characters in the following format.

		yyyymmddHHMMss

		yyyy	4 digit year
		mm	2 digit month, 01 thru 12
		dd	2 digit day, 01 thru 31
		HH	2 digit hour on 24-hour basis, 00 thru 23
		MM	2 digit minute, 00 thru 59
		ss	2 digit second, 00 thru 59

		Ending characters may be dropped. Following examples illustrate.

		"2010072312"	July 23, 2010, 12:00:00 noon
		"201007231210"	July 23, 2010, 12:10:00 PM
		"201007231310"	July 23, 2010, 01:10:00 PM
		"2010072313105"	July 23, 2010, 01:10:05 PM
			(Please note that "2010072313105" is interpreted as July 23, 2010, 01:10:05 PM,
			and NOT as July 23, 2010, 01:10:50 PM.)

		If this argument is not specified, the current time will be used.

Stream Input	
	Ignored.

Stream Output
	The various information items or attributes for <filedir> are listed on one line in the
	following order. Items are separated by tabs.

	size
	type
	latest modification time
	latest access time
	creation time
	name

	The listed information items reflect the changed attributes.


Stream Error
	Any errors are listed here.

Description
	This command sets information items or attributes for the specified file or directory.

	In addition to displaying the file/directory listing in stream output, the command sets values for
	several system variables, which then can be used to do further processing of
	the file/directory.

	If the specified file or directory is found, information about the file/directory is made
	available in the following system variables. Please note that all of these
	variables are set irrespective of which options are specified. The options
	merely dictate which attributes to set.

	$fexists	true if file/directory exists, false otherwise.

	$fname		File/directory name.

	$ftype		File/directory type. Can be one of the following.
			f	Flat file
			d	Directory
			o	Other

	$fatime		Latest access time.

	$fctime		Creation time.

	$fmtime		Latest modification time.

			All times are in the
			format - yyyymmddhhMMss.
			The lower case mm is month. The upper case MM is
			minute. The hour (hh) is in 24 hour format.

	$fsize		File size in bytes.

	If the specified file or directory is not found, or if an error occurs, $fexists is set to false.
	All other system variables retain their previous values.
		
Restrictions
	If the file size is too large and can not be contained in the variable
	of type int, the displayed (and assigned to $fsize) size will be incorrect.

	The sizes of directories are meaningless. So, they are always shown as 0 (zero).

	Security and other restrictions placed by the operating system may
	result in not being able to access certain files and directories.

	Times before year 1977, or after year 2036 (these limits are processor-dependent), are not supported.
	An appropriate error will be produced.

Valid Examples
	fdset -m "mypage.html" "20101005130000"

	Will set the modification time for file "mypage.html" to October 5, 2010, 1 PM.

	fdset -a "mypage.html"

	Will set the access time for file "mypage.html" to current time, since <time> argument
	is not specified.

	fdset "C:/directory1/directory2"

	Will set all access time, modification time and creation time for directory
	"C:/directory1/directory2" to the current time.

	fdset -c "mypage.html" addtime(diff("-500"))

	Will set the creation time for file mypage.html to 5 minutes earlier.

Invalid Examples
	fdset "*.txt"
	Will produce an error. Name patterns are not allowed in this command.

See Also
fdinfo
lf
mf
addtime
difftime
var
systemvar