Open Display - Revision history

Gordon.dye at 15:00, 27 January 2017

2017-01-27T15:00:41Z

@@ Line 105: / Line 105: @@
 Three options are available for the EOL spec: CRLF (carriage return and line feed), LF (line feed only) and NONE (no characters are to be added or removed). CRLF is the default for DOS and DOS NetWork versions. LF is the default for Unix / Linux versions. If CRLF is used for output, a CHR$(26) end of file character is added to the end of the file when it is closed.
-The OPEN string for DISPLAY files requires a parameter called HTTP=CLIENT (4.2). The CLIENT designation denotes processing in the following sequence:
+The above parameters (excluding the #filenum parameter) make up the file identification string. Normally they must be 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 expression" (see the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of OPEN display statement, no matter which syntax path is selected.
 The "DISPLAY" keyword is required; it identifies the file being as a display file.
@@ Line 175: / Line 165: @@
 {{:EOL}}
 <noinclude>

Laura: /* Parameters */

2015-07-14T15:19:30Z

Parameters

← Older revision		Revision as of 15:19, 14 July 2015
Line 79:		Line 79:
	The required "file-num" parameter is a numeric expression that must equal an integer from 1 to 999. Two special default values for "file-num" are provided to facilitate I/O from the keyboard and to the printer and screen. These special defaults are: #0 (reserved for the BR main window), and #255 (reserved for printer, equivalent to DOS PRN:). No OPEN is necessary for these two reserved values.		The required "file-num" parameter is a numeric expression that must equal an integer from 1 to 999. Two special default values for "file-num" are provided to facilitate I/O from the keyboard and to the printer and screen. These special defaults are: #0 (reserved for the BR main window), and #255 (reserved for printer, equivalent to DOS PRN:). No OPEN is necessary for these two reserved values.

	From this point, there are two possible paths through the OPEN display 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]] in for more information about the file-ref syntax.		From this point, there are two possible paths through the OPEN display 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. 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. See [[File Ref]] in for more information about the file-ref 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.

Laura: /* Parameters */

2014-09-25T17:28:18Z

Parameters

← Older revision		Revision as of 17:28, 25 September 2014
Line 113:		Line 113:
	#PRINT - When the first LINPUT is issued POSTing of all print lines occurs and all responses are buffered before the LINPUT returns data.		#PRINT - When the first LINPUT is issued POSTing of all print lines occurs and all responses are buffered before the LINPUT returns data.
	#LINPUT - Until EOF is reached or until another PRINT is issued a PRINT clears the LINPUT buffer.		#LINPUT - Until EOF is reached or until another PRINT is issued a PRINT clears the LINPUT buffer.
	Processing must be performed in the above sequence or an error is generated. FILE$(fileno,”HTTPINFO”) returns LOG info for the latest action.		Processing must be performed in the above sequence or an error is generated. FILE$(fileno,”HTTPINFO”) returns LOG info for the latest action. For more information, see [[HTTP=CLIENT]].

	The above parameters (excluding the #filenum parameter) make up the file identification string. They must be 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 expression" (see the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of 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 be 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 expression" (see the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of OPEN display statement, no matter which syntax path is selected.

Laura: /* Parameters */

2014-09-25T17:25:35Z

Parameters

← Older revision		Revision as of 17:25, 25 September 2014
Line 113:		Line 113:
	#PRINT - When the first LINPUT is issued POSTing of all print lines occurs and all responses are buffered before the LINPUT returns data.		#PRINT - When the first LINPUT is issued POSTing of all print lines occurs and all responses are buffered before the LINPUT returns data.
	#LINPUT - Until EOF is reached or until another PRINT is issued a PRINT clears the LINPUT buffer.		#LINPUT - Until EOF is reached or until another PRINT is issued a PRINT clears the LINPUT buffer.
	Processing must be performed in the above sequence or an error is generated.		Processing must be performed in the above sequence or an error is generated. FILE$(fileno,”HTTPINFO”) returns LOG info for the latest action.

	The above parameters (excluding the #filenum parameter) make up the file identification string. They must be 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 expression" (see the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of 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 be 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 expression" (see the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of OPEN display statement, no matter which syntax path is selected.

Laura: /* Parameters */

2014-09-25T17:25:04Z

Parameters

← Older revision		Revision as of 17:25, 25 September 2014
Line 104:		Line 104:

	Three options are available for the EOL spec: CRLF (carriage return and line feed), LF (line feed only) and NONE (no characters are to be added or removed). CRLF is the default for DOS and DOS NetWork versions. LF is the default for Unix / Linux versions. If CRLF is used for output, a CHR$(26) end of file character is added to the end of the file when it is closed.		Three options are available for the EOL spec: CRLF (carriage return and line feed), LF (line feed only) and NONE (no characters are to be added or removed). CRLF is the default for DOS and DOS NetWork versions. LF is the default for Unix / Linux versions. If CRLF is used for output, a CHR$(26) end of file character is added to the end of the file when it is closed.

			The OPEN string for DISPLAY files requires a parameter called HTTP=CLIENT (4.2). The CLIENT designation denotes processing in the following sequence:
			HTTP=CLIENT
			#OPEN
			##NAME=Full URL - web page or service reference -
			##CONTROL= optional display filename
			#PRINT (accumulate post data)
			#PRINT - When the first LINPUT is issued POSTing of all print lines occurs and all responses are buffered before the LINPUT returns data.
			#LINPUT - Until EOF is reached or until another PRINT is issued a PRINT clears the LINPUT buffer.
			Processing must be performed in the above sequence or an error is generated.

	The above parameters (excluding the #filenum parameter) make up the file identification string. They must be 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 expression" (see the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of 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 be 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 expression" (see the bottom path of the syntax diagram) parameter in their place. The following parameter descriptions apply to all forms of OPEN display statement, no matter which syntax path is selected.

Laura: /* Syntax */

2014-09-25T17:12:54Z

Syntax

← Older revision		Revision as of 17:12, 25 September 2014
Line 61:		Line 61:

	===Syntax===		===Syntax===
	OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE Parameter\|USE]]\|[[Replace Parameter\|REPLACE]]}] [, [[RECL]]=<integer>] [, [[PAGEOFLOW]]=<integer>] [, <[[share spec]]>] [, [[RESERVE]] ] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>] [, [[EOL]]=<spec>]"\|<[[string expression]]>} ,[[DISPLAY]] ,{[[Input Parameter\|INPUT]]\|[[OUTPUT]]} [<[[error condition]]> <[[line ref]]>][,...]		OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE Parameter\|USE]]\|[[Replace Parameter\|REPLACE]]}] [, [[RECL]]=<integer>] [, [[PAGEOFLOW]]=<integer>] [, <[[share spec]]>] [, [[RESERVE]] ] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>] [, [[EOL]]=<spec>] ,HTTP=CLIENT"\|<[[string expression]]>} ,[[DISPLAY]] ,{[[Input Parameter\|INPUT]]\|[[OUTPUT]]} [<[[error condition]]> <[[line ref]]>][,...]

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

Laura: /* Parameters */

2014-05-05T16:19:57Z

Parameters

← Older revision		Revision as of 16:19, 5 May 2014
Line 97:		Line 97:
	"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. If provided, the second 256 bytes are used as an output translation table. When the output table is not provided, Business Rules constructs the output table by inverting the input translation table. See [[File I/O]] for more information about TRANSLATE=.		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. If provided, the second 256 bytes are used as an output translation table. When the output table is not provided, Business Rules constructs the output table by inverting the input translation table. See [[File I/O]] for more information about TRANSLATE=.

	The "EOL=spec" parameter defines the end-of-line separator (record delimiter) for the display file being opened (including communications files). It specifies the character/s to be sent at the end of every record (after RECL characters have been printed and at the end of each normal output line).		The "EOL=spec" parameter defines the end-of-line separator (record delimiter) for the display file being opened (including communications files). It specifies the character/s to be sent at the end of every record (after RECL characters have been printed and at the end of each normal output line).

Laura: /* Syntax */

2014-05-05T16:16:31Z

Syntax

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

	===Syntax===		===Syntax===
	OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE Parameter\|USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[PAGEOFLOW]]=<integer>] [, <[[share spec]]>] [, [[RESERVE]] ] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>] [, [[EOL]]=<spec>]"\|<[[string expression]]>} ,[[DISPLAY]] ,{[[INPUT]]\|[[OUTPUT]]} [<[[error condition]]> <[[line ref]]>][,...]		OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE Parameter\|USE]]\|[[Replace Parameter\|REPLACE]]}] [, [[RECL]]=<integer>] [, [[PAGEOFLOW]]=<integer>] [, <[[share spec]]>] [, [[RESERVE]] ] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>] [, [[EOL]]=<spec>]"\|<[[string expression]]>} ,[[DISPLAY]] ,{[[Input Parameter\|INPUT]]\|[[OUTPUT]]} [<[[error condition]]> <[[line ref]]>][,...]

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

Laura: /* Syntax */

2014-05-05T16:15:32Z

Syntax

← Older revision		Revision as of 16:15, 5 May 2014
Line 61:		Line 61:

	===Syntax===		===Syntax===
	OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[PAGEOFLOW]]=<integer>] [, <[[share spec]]>] [, [[RESERVE]] ] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>] [, [[EOL]]=<spec>]"\|<[[string expression]]>} ,[[DISPLAY]] ,{[[INPUT]]\|[[OUTPUT]]} [<[[error condition]]> <[[line ref]]>][,...]		OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE Parameter\|USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[PAGEOFLOW]]=<integer>] [, <[[share spec]]>] [, [[RESERVE]] ] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>] [, [[EOL]]=<spec>]"\|<[[string expression]]>} ,[[DISPLAY]] ,{[[INPUT]]\|[[OUTPUT]]} [<[[error condition]]> <[[line ref]]>][,...]

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

Laura: /* Syntax */

2014-05-05T16:11:05Z

Syntax

← Older revision		Revision as of 16:11, 5 May 2014
Line 61:		Line 61:

	===Syntax===		===Syntax===
	OPEN #<file number> : {"NAME=<file ref>[, {NEW\|USE\|REPLACE}] [, RECL=<integer>] [, PAGEOFLOW=<integer>] [, <share spec>] [, RESERVE] [, WAIT=<integer>] [, TRANSLATE=<file ref>] [, EOL=<spec>]"\|<string expression>} ,DISPLAY ,{INPUT\|OUTPUT} [<error condition> <line ref>][,...]		OPEN #<[[file number]]> : {"NAME=<[[file ref]]>[, {[[NEW]]\|[[USE]]\|[[REPLACE]]}] [, [[RECL]]=<integer>] [, [[PAGEOFLOW]]=<integer>] [, <[[share spec]]>] [, [[RESERVE]] ] [, [[WAIT]]=<integer>] [, [[TRANSLATE]]=<[[file ref]]>] [, [[EOL]]=<spec>]"\|<[[string expression]]>} ,[[DISPLAY]] ,{[[INPUT]]\|[[OUTPUT]]} [<[[error condition]]> <[[line ref]]>][,...]

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