OPEN-FILE - Revision history

Tingo: fixed layout of parameters, expanded text

2017-10-02T15:20:00Z

fixed layout of parameters, expanded text

← Older revision		Revision as of 15:20, 2 October 2017
Line 2:		Line 2:
	This command is used to make a file available for access, and returns the logical unit number to be used for accessing the file.		This command is used to make a file available for access, and returns the logical unit number to be used for accessing the file.

	<file name>		; <file name> : could be the name of a peripheral unit, eg., LINE-PRINTER or a user file name, which may be prefixed with [[file-directory-name]] and [[user-name]] if necessary.

	~~could be the name of a peripheral unit, eg., LINE-PRINTER or~~ a ~~user~~ file ~~name, which may be prefixed~~ with [[file~~-directory-name~~]] ~~and [[user-name]] if necessary~~.		; <type> : if a file with a specific [[file types\|type]] is to be opened. The default value is :SYMB.

	<~~pre~~>:~~<type></pre>~~		; <version> : if a specific version is to be opened. The default value is 1.
	if ~~a file with~~ a specific ~~[[file types\|type]]~~ is to be opened. The default value is ~~:SYMB~~.

	~~<pre>~~;~~<version></pre>~~		; <access type> : specifies the intended [[access modes\|access-mode]], only the following combinations are legal:

	~~if a specific version is to be opened. The default value is 1.~~

	<access type>

	specifies the intended [[access modes\|access-mode]], only the following combinations are legal:
	R - sequential read		R - sequential read
	W - sequential write		W - sequential write
Line 41:		Line 34:
	#An error message is produced if the file can not be opened.		#An error message is produced if the file can not be opened.
	#Files opened for sequential read and write occupy two device buffers. If all files are accessed sequentially, the maximum number of simultaneously opened files is 12. If all files are accessed randomly the number is 18.		#Files opened for sequential read and write occupy two device buffers. If all files are accessed sequentially, the maximum number of simultaneously opened files is 12. If all files are accessed randomly the number is 18.
	#{{ND-doc\|60.128.01}} (printed June 1980), Appendix I shows a list of logical device numbers.		#{{ND-doc\|60.128.01}} (printed June 1980), Appendix I shows a list of logical device numbers. {{ND-doc\|60.128.01}} (printed February 1983) Appendix C lists logical device numbers. This is the default number specified by ND at system generation.

	Example:		Example:

Tingo: /* Related commands */ added more commands

2017-10-02T15:14:04Z

Related commands: added more commands

← Older revision		Revision as of 15:14, 2 October 2017
Line 56:		Line 56:

	@[[CLOSE-FILE]]		@[[CLOSE-FILE]]

			@[[RTCONNECT-FILE]]

			@[[RTOPEN-FILE]]

	@[[SCRATCH-OPEN]]		@[[SCRATCH-OPEN]]

	@[[SET-PERMANENTLY-OPENED]]		@[[SET-PERMANENTLY-OPENED]]

			[[OPEN (monitor call)]]

	== References ==		== References ==

Tingo: /* References */ added 60.128.03 reference

2017-10-02T15:10:39Z

References: added 60.128.03 reference

← Older revision		Revision as of 15:10, 2 October 2017
Line 65:		Line 65:

	{{ND-doc\|60.128.01}} (printed June 1980), pages 1-113, 1-114		{{ND-doc\|60.128.01}} (printed June 1980), pages 1-113, 1-114

			{{ND-doc\|60.128.03}} (printed February 1983), page 1-143

	{{ND-doc\|60.174.Q01}}		{{ND-doc\|60.174.Q01}}
	<references/>		<references/>
	[[Category:Background Commands]]		[[Category:Background Commands]]

Tingo: corrected a spelling error for the example in the printed manual I have.

2014-08-22T18:13:49Z

corrected a spelling error for the example in the printed manual I have.

← Older revision		Revision as of 18:13, 22 August 2014
Line 45:		Line 45:
	Example:		Example:

	@OPEN-FILE "F-1":DATA", W		@OPEN-FILE "F-1:DATA", W

	FILE NUMBER IS 000101		FILE NUMBER IS 000101

Tingo: added Example description

2014-08-22T18:12:41Z

added Example description

@@ Line 42: / Line 42: @@
 #Files opened for sequential read and write occupy two device buffers. If all files are accessed sequentially, the maximum number of simultaneously opened files is 12. If all files are accessed randomly the number is 18.
 #{{ND-doc|60.128.01}} (printed June 1980), Appendix I shows a list of logical device numbers.
 == Related commands ==
 @[[CONNECT-FILE]]

Tingo: /* References */ added reference to SINTRAN III Reference Manual

2014-08-22T18:09:21Z

References: added reference to SINTRAN III Reference Manual

← Older revision		Revision as of 18:09, 22 August 2014
Line 53:		Line 53:
	== References ==		== References ==
	{{ND-doc\|60.050.06}} section 3.4.5.1		{{ND-doc\|60.050.06}} section 3.4.5.1

			{{ND-doc\|60.128.01}} (printed June 1980), pages 1-113, 1-114

	{{ND-doc\|60.174.Q01}}		{{ND-doc\|60.174.Q01}}
	<references/>		<references/>
	[[Category:Background Commands]]		[[Category:Background Commands]]

Tingo: added Rules description

2014-08-22T18:08:08Z

added Rules description

← Older revision		Revision as of 18:08, 22 August 2014
Line 34:		Line 34:

	A list of logical numbers is given in <ref>{{ND-doc\|60.050.06}}Appendix C</ref>.		A list of logical numbers is given in <ref>{{ND-doc\|60.050.06}}Appendix C</ref>.

			Rules:
			#Permitted for all users with legal <access type> to the file.
			#New file names and / or versions may be created when opening the file by enclosing <file name> in quotes.
			#If file access is permitted, the message "FILE NUMBER IS = n" is printed <n> (octal) is the logical device number to be used for later access.
			#An error message is produced if the file can not be opened.
			#Files opened for sequential read and write occupy two device buffers. If all files are accessed sequentially, the maximum number of simultaneously opened files is 12. If all files are accessed randomly the number is 18.
			#{{ND-doc\|60.128.01}} (printed June 1980), Appendix I shows a list of logical device numbers.
	== Related commands ==		== Related commands ==
	@[[CONNECT-FILE]]		@[[CONNECT-FILE]]

Tingo: added Related commands section

2014-08-22T17:57:23Z

added Related commands section

← Older revision		Revision as of 17:57, 22 August 2014
Line 34:		Line 34:

	A list of logical numbers is given in <ref>{{ND-doc\|60.050.06}}Appendix C</ref>.		A list of logical numbers is given in <ref>{{ND-doc\|60.050.06}}Appendix C</ref>.
			== Related commands ==
			@[[CONNECT-FILE]]

			@[[CLOSE-FILE]]

			@[[SCRATCH-OPEN]]

			@[[SET-PERMANENTLY-OPENED]]

	== References ==		== References ==
	{{ND-doc\|60.050.06}} section 3.4.5.1		{{ND-doc\|60.050.06}} section 3.4.5.1

Tingo: created page for the OPEN-FILE command

2012-08-22T17:49:23Z

created page for the OPEN-FILE command

New page

@OPEN-FILE <file name> [:<type>[;<version>]], <access type>
This command is used to make a file available for access, and returns the logical unit number to be used for accessing the file.

<file name>

could be the name of a peripheral unit, eg., LINE-PRINTER or a user file name, which may be prefixed with [[file-directory-name]] and [[user-name]] if necessary.

<pre>:<type></pre>
if a file with a specific [[file types|type]] is to be opened. The default value is :SYMB.

<pre>;<version></pre>

if a specific version is to be opened. The default value is 1.

<access type>

specifies the intended [[access modes|access-mode]], only the following combinations are legal:
R - sequential read
W - sequential write
RW - sequential read and write
RX - random read
WX - random read and write
WA - sequential write append
RC - random read with read and write access from other users allowed (only contiguous files)
WC - random read and write with read and write access from other users allowed (only contiguous files)

If the user is allowed access to the file, the following messages is printed
FILE-NUMBER IS = n
where n is the logical unit number to be used when accessing the file later.

New file names and / or number of versions may be created together with the opening of the file by enclosing the name or number in quotation marks.

If, for any reason, it is not possible to open the file, an explanatory message is given.

A list of logical numbers is given in <ref>{{ND-doc|60.050.06}}Appendix C</ref>.
== References ==
{{ND-doc|60.050.06}} section 3.4.5.1

{{ND-doc|60.174.Q01}}
<references/>
[[Category:Background Commands]]