Open Internal - Revision history

Gordon.dye: /* Syntax */

2022-08-23T03:51:17Z

Syntax

← Older revision		Revision as of 03:51, 23 August 2022
Line 60:		Line 60:

	===Syntax===		===Syntax===
	OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[KFNAME]]=<[[file ref]]>] [, <[[key spec]]>] [, <[[share spec]]>] [, [[RESERVE]]] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>]"\|<[[string expression]]>}, [[INTERNAL]], {[[Input Parameter\|INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [, {[[SEQUENTIAL]]\|[[RELATIVE]]\|[[KEYED]]}] [<[[error condition]]> <[[line ref]]>][,...]		OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[KFNAME]]=<[[file ref]]>] [, <[[key spec]]>] [, <[[share spec]]>] [, [[RESERVE]]] [, [[Version\|VERSION=]]] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>]"\|<[[string expression]]>}, [[INTERNAL]], {[[Input Parameter\|INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [, {[[SEQUENTIAL]]\|[[RELATIVE]]\|[[KEYED]]}] [<[[error condition]]> <[[line ref]]>][,...]

	[[Image:Openinternal.png\|900px]]		[[Image:Openinternal.png\|900px]]

Laura: /* Parameters */

2015-07-14T15:05:38Z

Parameters

← Older revision		Revision as of 15:05, 14 July 2015
Line 80:		Line 80:
	From this point, there are two possible paths through the OPEN internal syntax. The top path will be described first.		From this point, there are two possible paths through the OPEN internal syntax. The top path will be described first.

	"NAME=file-ref" is a required parameter which specifies the file or device to be opened. This parameter can be a string constant, string variable, or string expression. See [[File Ref]] for more information about its syntax.		"NAME=file-ref" is a required parameter which specifies the file or device to be opened. This parameter can be a string constant, string variable, or string expression. See [[File Ref]] for more information about its syntax. Using [[Name=save]] will allow the user to select a file location and name to save under. And using [[Name=open]] will allow the user to select a file to open from the standard Windows open file location window.

	The '''NEW''' parameter indicates that the file to be opened must also be newly created. Error [[4150]] (duplicate file name) will occur if NEW is specified and the file already exists.		The '''NEW''' parameter indicates that the file to be opened must also be newly created. Error [[4150]] (duplicate file name) will occur if NEW is specified and the file already exists.

Laura: /* Syntax */

2014-05-05T16:39:25Z

Syntax

← Older revision		Revision as of 16:39, 5 May 2014
Line 60:		Line 60:

	===Syntax===		===Syntax===
	OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[KFNAME]]=<[[file ref]]>] [, <[[key spec]]>] [, <[[share spec]]>] [, [[RESERVE]]] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>]"\|<[[string expression]]>}, [[INTERNAL]], {[[INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [, {[[SEQUENTIAL]]\|[[RELATIVE]]\|[[KEYED]]}] [<[[error condition]]> <[[line ref]]>][,...]		OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[KFNAME]]=<[[file ref]]>] [, <[[key spec]]>] [, <[[share spec]]>] [, [[RESERVE]]] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>]"\|<[[string expression]]>}, [[INTERNAL]], {[[Input Parameter\|INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [, {[[SEQUENTIAL]]\|[[RELATIVE]]\|[[KEYED]]}] [<[[error condition]]> <[[line ref]]>][,...]

	[[Image:Openinternal.png\|900px]]		[[Image:Openinternal.png\|900px]]

Laura: /* Syntax */

2014-05-05T16:31:09Z

Syntax

← Older revision		Revision as of 16:31, 5 May 2014
Line 60:		Line 60:

	===Syntax===		===Syntax===
	OPEN #<file number> : {"NAME=<file ref>[, {NEW\|USE\|REPLACE}] [, RECL=<integer>] [, KFNAME=<file ref>] [, <key spec>] [, <share spec>] [, RESERVE] [, WAIT=<integer>] [, TRANSLATE=<file ref>]"\|<string expression>}, INTERNAL, {INPUT\|OUTPUT\|OUTIN} [, {SEQUENTIAL\|RELATIVE\|KEYED}] [<error condition> <line ref>][,...]		OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[KFNAME]]=<[[file ref]]>] [, <[[key spec]]>] [, <[[share spec]]>] [, [[RESERVE]]] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>]"\|<[[string expression]]>}, [[INTERNAL]], {[[INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [, {[[SEQUENTIAL]]\|[[RELATIVE]]\|[[KEYED]]}] [<[[error condition]]> <[[line ref]]>][,...]

	[[Image:Openinternal.png\|900px]]		[[Image:Openinternal.png\|900px]]

Laura: /* Syntax */

2014-04-28T16:26:58Z

Syntax

← Older revision		Revision as of 16:26, 28 April 2014
Line 60:		Line 60:

	===Syntax===		===Syntax===
	OPEN #<file number> : "NAME=<file ref>[, NEW\|USE\|REPLACE] [, RECL=<integer>] [, KFNAME=<file ref>] [, <key spec>] [, <share spec>] [, RESERVE] [, WAIT=<integer>] [, TRANSLATE=<file ref>]"\|<string expression>, INTERNAL, INPUT\|OUTPUT\|OUTIN [, SEQUENTIAL\|RELATIVE\|KEYED] [{<error condition> <line ref>,}]		OPEN #<file number> : {"NAME=<file ref>[, {NEW\|USE\|REPLACE}] [, RECL=<integer>] [, KFNAME=<file ref>] [, <key spec>] [, <share spec>] [, RESERVE] [, WAIT=<integer>] [, TRANSLATE=<file ref>]"\|<string expression>}, INTERNAL, {INPUT\|OUTPUT\|OUTIN} [, {SEQUENTIAL\|RELATIVE\|KEYED}] [<error condition> <line ref>][,...]

	[[Image:Openinternal.png\|900px]]		[[Image:Openinternal.png\|900px]]

Laura: /* Syntax */

2014-04-24T19:49:26Z

Syntax

← Older revision		Revision as of 19:49, 24 April 2014
Line 60:		Line 60:

	===Syntax===		===Syntax===
	OPEN #<file number> : "NAME=<file ref>[, NEW\|USE\|REPLACE] [, RECL=<integer>] [, KFNAME=<file ref>] [, <key spec>] [, <share spec>] [, RESERVE] [, WAIT=<integer>] [, TRANSLATE=<file ref>]"\|<string expression>, INTERNAL, INPUT\|OUTPUT\|OUTIN [, SEQUENTIAL\|RELATIVE\|KEYED] [{<error condition> <line ref>,}]		OPEN #<file number> : "NAME=<file ref>[, NEW\|USE\|REPLACE] [, RECL=<integer>] [, KFNAME=<file ref>] [, <key spec>] [, <share spec>] [, RESERVE] [, WAIT=<integer>] [, TRANSLATE=<file ref>]"\|<string expression>, INTERNAL, INPUT\|OUTPUT\|OUTIN [, SEQUENTIAL\|RELATIVE\|KEYED] [{<error condition> <line ref>,}]

	[[Image:Openinternal.png\|900px]]		[[Image:Openinternal.png\|900px]]

Laura: /* Syntax */

2014-04-24T19:49:16Z

Syntax

← Older revision		Revision as of 19:49, 24 April 2014
Line 60:		Line 60:

	===Syntax===		===Syntax===
			OPEN #<file number> : "NAME=<file ref>[, NEW\|USE\|REPLACE] [, RECL=<integer>] [, KFNAME=<file ref>] [, <key spec>] [, <share spec>] [, RESERVE] [, WAIT=<integer>] [, TRANSLATE=<file ref>]"\|<string expression>, INTERNAL, INPUT\|OUTPUT\|OUTIN [, SEQUENTIAL\|RELATIVE\|KEYED] [{<error condition> <line ref>,}]

	[[Image:Openinternal.png\|900px]]		[[Image:Openinternal.png\|900px]]

Laura: /* Parameters */

2013-07-22T17:16:21Z

Parameters

← Older revision		Revision as of 17:16, 22 July 2013
Line 96:		Line 96:
	"RESERVE" locks the file until otherwise specified; other users are denied access even when the file is not open. A reserved file is not released until a CLOSE statement with the RELEASE parameter has been specified or until a PROTECT file-ref, RELEASE command has been issued (this last command is ignored by the IBM PC-NetWork operating system). Exiting Business Rules also releases all files locked by that workstation.		"RESERVE" locks the file until otherwise specified; other users are denied access even when the file is not open. A reserved file is not released until a CLOSE statement with the RELEASE parameter has been specified or until a PROTECT file-ref, RELEASE command has been issued (this last command is ignored by the IBM PC-NetWork operating system). Exiting Business Rules also releases all files locked by that workstation.

	The "WAIT= int" parameter specifies the number of seconds that Business Rules should wait for a locked record before generating error code [[0061]]. The "TRANSLATE=file-ref" parameter indicates that character translation is required for all input or output of C, V, G, N, ZD or PIC strings. The file-ref must identify either a 256- or 512-byte file. The first 256 bytes are used as an input translation table. See [[~~File I/O~~]] for more information ~~about the TRANSLATE= parameter~~.		The "WAIT= int" parameter specifies the number of seconds that Business Rules should wait for a locked record before generating error code [[0061]].

			The "TRANSLATE=file-ref" parameter indicates that character translation is required for all input or output of C, V, G, N, ZD or PIC strings. The file-ref must identify either a 256- or 512-byte file. The first 256 bytes are used as an input translation table. See [[Translate]] for more information.

	The above parameters (excluding the #filenum parameter) make up the file identification string. They must all be enclosed within a single set of quotation marks. If you wish to define this information elsewhere in the program, Business Rules will accept the "string- expr" (See the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of the OPEN display statement, no matter which syntax path is selected.		The above parameters (excluding the #filenum parameter) make up the file identification string. They must all be enclosed within a single set of quotation marks. If you wish to define this information elsewhere in the program, Business Rules will accept the "string- expr" (See the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of the OPEN display statement, no matter which syntax path is selected.

Laura: /* Parameters */

2013-06-07T15:46:31Z

Parameters

← Older revision		Revision as of 15:46, 7 June 2013
Line 82:		Line 82:
	The '''NEW''' parameter indicates that the file to be opened must also be newly created. Error [[4150]] (duplicate file name) will occur if NEW is specified and the file already exists.		The '''NEW''' parameter indicates that the file to be opened must also be newly created. Error [[4150]] (duplicate file name) will occur if NEW is specified and the file already exists.

	The '''USE''' parameter indicates that an existing file by the specified name should be opened~~. If~~ a file by the specified name ~~does~~ not exist, Business Rules will create a new file for it.		The '''USE''' parameter indicates that an existing file by the specified name should be opened, but a file by the specified name may not exist, in which case Business Rules will create a new file for it; so the OPEN statement needs to have the specifications for creating it.

	The '''REPLACE''' parameter indicates that any existing file under the specified name should be freed and that a new file under that same name be created. There will be no warning that the file is being replaced when this parameter is used. See the [[File I/O]] chapter for more information about the NEW, USE and REPLACE parameters.		The '''REPLACE''' parameter indicates that any existing file under the specified name should be freed and that a new file under that same name be created. There will be no warning that the file is being replaced when this parameter is used. See the [[File I/O]] chapter for more information about the NEW, USE and REPLACE parameters.

Laura: /* Parameters */

2013-02-07T22:29:09Z

Parameters

← Older revision		Revision as of 22:29, 7 February 2013
Line 78:		Line 78:
	From this point, there are two possible paths through the OPEN internal syntax. The top path will be described first.		From this point, there are two possible paths through the OPEN internal syntax. The top path will be described first.

	"NAME=file-ref" is a required parameter which specifies the file or device to be opened. This parameter can be a string constant, string variable, or string expression. See ~~the Definitions chapter~~ for more information about ~~the file-ref~~ syntax.		"NAME=file-ref" is a required parameter which specifies the file or device to be opened. This parameter can be a string constant, string variable, or string expression. See [[File Ref]] for more information about its syntax.

	The '''NEW''' parameter indicates that the file to be opened must also be newly created. Error [[4150]] (duplicate file name) will occur if NEW is specified and the file already exists.		The '''NEW''' parameter indicates that the file to be opened must also be newly created. Error [[4150]] (duplicate file name) will occur if NEW is specified and the file already exists.