Free - Revision history

Laura: /* Syntax */

2014-05-06T16:15:46Z

Syntax

← Older revision		Revision as of 16:15, 6 May 2014
Line 7:		Line 7:

	==Syntax==		==Syntax==
			FREE <file name> {[>[>] <output file>]\|[PRINT]} [-<[[free option\|option]]>][-...]
	[[Image:Free.png]]		[[Image:Free.png]]

Mikhail.zheleznov: edit

2011-12-26T11:05:25Z

edit

← Older revision		Revision as of 11:05, 26 December 2011
Line 18:		Line 18:

	Three optional parameters, when separated from the rest of the command with a dash, can follow the FREE command:		Three optional parameters, when separated from the rest of the command with a dash, can follow the FREE command:

	'''A''' causes only files with the archive bit on to be dropped on DOS versions. Linux versions ignore this option.		'''A''' causes only files with the archive bit on to be dropped on DOS versions. Linux versions ignore this option.

Mikhail.zheleznov: edit content

2011-12-26T11:05:09Z

edit content

← Older revision		Revision as of 11:05, 26 December 2011
Line 19:		Line 19:
	Three optional parameters, when separated from the rest of the command with a dash, can follow the FREE command:		Three optional parameters, when separated from the rest of the command with a dash, can follow the FREE command:
	'''A''' causes only files with the archive bit on to be dropped on DOS versions. Linux versions ignore this option.		'''A''' causes only files with the archive bit on to be dropped on DOS versions. Linux versions ignore this option.

	'''N''' prevents the screen from displaying a log of performed actions.		'''N''' prevents the screen from displaying a log of performed actions.
	'''P''' causes scrolling to pause after the log of freed files fills one screen. (Press <CR> for the next screen.)
			'''P''' causes scrolling to pause after the log of freed files fills one screen. Press <ENTER> for the next screen.

	'''V''' requires the operator to Verify actions before Business Rules performs them.		'''V''' requires the operator to Verify actions before Business Rules performs them.

	====Technical Considerations====		==Technical Considerations==
	As BR closes a [[procedure]] before executing the last line, the procedure can free itself when FREE is the last line. A procedure file which is named with a [[.$$$]] extension will automatically free itself after executing.		As BR closes a [[procedure]] before executing the last line, the procedure can free itself when FREE is the last line. A procedure file which is named with a [[.$$$]] extension will automatically free itself after executing.

Mikhail.zheleznov: edit content

2011-12-26T11:04:30Z

edit content

Mikhail.zheleznov: Created and added new Syntax diagram

2011-12-26T11:01:04Z

Created and added new Syntax diagram

← Older revision		Revision as of 11:01, 26 December 2011
Line 7:		Line 7:

	====Syntax====		====Syntax====
	[[Image:~~HELP0041~~.~~jpg~~]]		[[Image:Free.png]]

	====Default====		====Default====

Mikhail.zheleznov: Imported FREE command page from old wiki

2011-12-26T10:51:06Z

Imported FREE command page from old wiki

New page

The '''Free (FR)''' [[command]] deletes one or more files from the system.

====Comments and Examples====
The following example removes the file PROG1.BR from the default directory of drive B and prevents the screen from displaying the log of actions:

Free B:Prog1.br -N

====Syntax====
[[Image:HELP0041.jpg]]

====Default====
Display on the screen any actions performed.

====Parameters====
FREE requires the "file-ref" parameter, which accepts wildcard characters

The optional ">file-ref" parameter sends messages that normally appear on the screen during the FREE procedure to the specified file. "PRINT" sends screen messages to the printer.

;Three optional parameters, when separated from the rest of the command with a dash, can follow the FREE command:
:"A" |causes only files with the archive bit on to be dropped on DOS versions. Linux versions ignore this option.
:"N" |prevents the screen from displaying a log of performed actions.
:"P" |causes scrolling to pause after the log of freed files fills one screen. (Press <CR> for the next screen.)
:"V" |requires the operator to Verify actions before Business Rules performs them.

====Technical Considerations====
As Business Rules! closes a [[procedure]] before executing the last line, the procedure can free itself when FREE is the last line. A procedure file which is named with a [[.$$$]] extension will automatically free itself after executing.

<noinclude>
[[Category:Commands]]
[[Category:File Management Commands]]
</noinclude>

← Older revision		Revision as of 11:04, 26 December 2011
Line 1:		Line 1:
	The '''Free (FR)''' [[command]] deletes one or more files from the system.		The '''Free (FR)''' command deletes one or more files from the system.

	====Comments and Examples====		==Comments and Examples==
	The following example removes the file PROG1.BR from the default directory of drive B and prevents the screen from displaying the log of actions:		The following example removes the file PROG1.BR from the default directory of drive B and prevents the screen from displaying the log of actions:

	Free B:Prog1.br -N		Free B:Prog1.br -N

	====Syntax====		==Syntax==
	[[Image:Free.png]]		[[Image:Free.png]]

	==~~==Default==~~==		==Defaults==
	Display on the screen any actions performed.		Display on the screen any actions performed.

	====Parameters====		==Parameters==
	FREE requires the "file~~-ref"~~ parameter, which accepts wildcard characters		FREE requires the '''file name''' parameter, which accepts wildcard characters

	The optional ">file~~-ref"~~ parameter sends messages that normally appear on the screen during the FREE procedure to the specified file. "PRINT" sends screen messages to the printer.		The optional '''>redirected output file''' parameter sends messages that normally appear on the screen during the FREE procedure to the specified file. '''PRINT''' sends screen messages to the printer.

	;Three optional parameters, when separated from the rest of the command with a dash, can follow the FREE command:		Three optional parameters, when separated from the rest of the command with a dash, can follow the FREE command:
	:"A~~" \|~~causes only files with the archive bit on to be dropped on DOS versions. Linux versions ignore this option.		'''A''' causes only files with the archive bit on to be dropped on DOS versions. Linux versions ignore this option.
	:"N~~" \|~~prevents the screen from displaying a log of performed actions.		'''N''' prevents the screen from displaying a log of performed actions.
	:"P~~" \|~~causes scrolling to pause after the log of freed files fills one screen. (Press <CR> for the next screen.)		'''P''' causes scrolling to pause after the log of freed files fills one screen. (Press <CR> for the next screen.)
	:"V~~" \|~~requires the operator to Verify actions before Business Rules performs them.		'''V''' requires the operator to Verify actions before Business Rules performs them.

	====Technical Considerations====		====Technical Considerations====
	As ~~Business Rules!~~ closes a [[procedure]] before executing the last line, the procedure can free itself when FREE is the last line. A procedure file which is named with a [[.$$$]] extension will automatically free itself after executing.		As BR closes a [[procedure]] before executing the last line, the procedure can free itself when FREE is the last line. A procedure file which is named with a [[.$$$]] extension will automatically free itself after executing.