Rewrite - Revision history

Gordon.dye at 03:01, 23 February 2026

2026-02-23T03:01:38Z

← Older revision		Revision as of 03:01, 23 February 2026
Line 36:		Line 36:
	The "KEY = string-expr" clause is used with files opened for KEYED processing; its purpose is to specify a record by the value of its key field. After the string expression is evaluated, the system reads and then rewrites the first record that matches the key field. For complete information about the KEY clause, see the Index Facility chapter.		The "KEY = string-expr" clause is used with files opened for KEYED processing; its purpose is to specify a record by the value of its key field. After the string expression is evaluated, the system reads and then rewrites the first record that matches the key field. For complete information about the KEY clause, see the Index Facility chapter.

	The "RESERVE" and "RELEASE" parameters specify record locking rules for multi-user systems. "RESERVE" instructs the system to ~~reserve~~ all previous record locks. "RELEASE" releases all record locks on this file as soon as the REWRITE is complete.		The "RESERVE" and "RELEASE" parameters specify record locking rules for multi-user systems. "RESERVE" instructs the system to preserve all previous record locks. "RELEASE" releases all record locks on this file as soon as the REWRITE is complete.

	The "MAT array-name" and "data-item" parameters represent a list of items to be written to the old record. If more than one is specified, they must be separated by commas.		The "MAT array-name" and "data-item" parameters represent a list of items to be written to the old record. If more than one is specified, they must be separated by commas.

Laura: /* Syntax */

2014-05-06T00:01:27Z

Syntax

← Older revision		Revision as of 00:01, 6 May 2014
Line 16:		Line 16:

	===Syntax===		===Syntax===
	REWRITE #<file number> [, USING {<string expression>\|<line ref>}] {[, POS=<numeric expression>]\|[, REC=<numeric expression>]\|[, KEY=<string expression>]} [, {RESERVE\|RELEASE}] : [{Mat <array name>\|<data item>}][,...] [<error condition> <line ref>][,...]		REWRITE #<[[file number]]> [, [[USING]] {<[[string expression]]>\|<[[line ref]]>}] {[, [[Pos Parameter\|POS]]=<[[numeric expression]]>]\|[, [[REC=]]<[[numeric expression]]>]\|[, [[KEY]]=<[[string expression]]>]} [, {[[RESERVE]]\|[[RELEASE]]}] : [{[[Mat]] <[[array name]]>\|<data item>}][,...] [<[[error condition]]> <[[line ref]]>][,...]
	[[Image:Rewrite.png\|900px]]		[[Image:Rewrite.png\|900px]]

Laura: /* Syntax */

2014-04-29T14:26:09Z

Syntax

← Older revision		Revision as of 14:26, 29 April 2014
Line 16:		Line 16:

	===Syntax===		===Syntax===
	REWRITE #<file number> [, USING {<string expression>\|<line ref>}] {[, POS=<numeric expression>]\|[, REC=<numeric expression>]\|[, KEY=<string expression>]} [, {RESERVE\|RELEASE}] : [{Mat <array name>\|<~~variable name~~>}][,...] [<error condition> <line ref>][,...]		REWRITE #<file number> [, USING {<string expression>\|<line ref>}] {[, POS=<numeric expression>]\|[, REC=<numeric expression>]\|[, KEY=<string expression>]} [, {RESERVE\|RELEASE}] : [{Mat <array name>\|<data item>}][,...] [<error condition> <line ref>][,...]
	[[Image:Rewrite.png\|900px]]		[[Image:Rewrite.png\|900px]]

Laura: /* Syntax */

2014-04-29T14:25:44Z

Syntax

← Older revision		Revision as of 14:25, 29 April 2014
Line 16:		Line 16:

	===Syntax===		===Syntax===
	REWRITE #<file number> [, USING {<string expression>\|<line ref>}] {[, POS=<numeric expression>]\|[, REC=<numeric expression>]\|[, KEY=<string expression>]} [, {RESERVE\|RELEASE}]:		REWRITE #<file number> [, USING {<string expression>\|<line ref>}] {[, POS=<numeric expression>]\|[, REC=<numeric expression>]\|[, KEY=<string expression>]} [, {RESERVE\|RELEASE}] : [{Mat <array name>\|<variable name>}][,...] [<error condition> <line ref>][,...]
	[{Mat <array name>\|<variable name>}][,...] [<error condition> <line ref>][,...]
	[[Image:Rewrite.png\|900px]]		[[Image:Rewrite.png\|900px]]

Laura: /* Syntax */

2014-04-29T14:24:58Z

Syntax

← Older revision		Revision as of 14:24, 29 April 2014
Line 16:		Line 16:

	===Syntax===		===Syntax===
			REWRITE #<file number> [, USING {<string expression>\|<line ref>}] {[, POS=<numeric expression>]\|[, REC=<numeric expression>]\|[, KEY=<string expression>]} [, {RESERVE\|RELEASE}]:
			[{Mat <array name>\|<variable name>}][,...] [<error condition> <line ref>][,...]
	[[Image:Rewrite.png\|900px]]		[[Image:Rewrite.png\|900px]]

Laura: /* Comments and Examples */

2013-07-26T21:28:19Z

Comments and Examples

@@ Line 3: / Line 3: @@
 ===Comments and Examples===
 Before ReWrite can be used, an [[internal]] or [[external]] file must already be [[open]]ed and assigned a [[file number]]. ReWrite can be used with internal files opened for either [[SEQUENTIAL]],[[RELATIVE]] or [[KEYED]] processing. ReWrite can be used with external files opened for SEQUENTIAL or RELATIVE processing. ReWrite operates only when files are opened [[OUTIN]]. ReWrite must follow a successful [[READ]] or [[REREAD]] when used with a SEQUENTIAL file, when used without a [[REC=]] clause or [[POS=]] clause for RELATIVE files, and when used without a [[KEY]] clause for KEYED files. In each of these three cases, the record updated will be the last record read.
 ===Syntax===

Laura: /* Comments and Examples */

2013-07-26T21:23:06Z

Comments and Examples

← Older revision		Revision as of 21:23, 26 July 2013
Line 2:		Line 2:

	===Comments and Examples===		===Comments and Examples===
	Before ReWrite can be used, an [[internal]] or [[external]] file must already be [[~~opened~~]] and assigned a [[file number]]. ReWrite can be used with internal files opened for either [[SEQUENTIAL]],[[RELATIVE]] or [[KEYED]] processing. ReWrite can be used with external files opened for SEQUENTIAL or RELATIVE processing. ReWrite operates only when files are opened [[OUTIN]]. ReWrite must follow a successful [[READ]] or [[REREAD]] when used with a SEQUENTIAL file, when used without a [[REC=]] clause or [[POS=]] clause for RELATIVE files, and when used without a [[KEY]] clause for KEYED files. In each of these three cases, the record updated will be the last record read.		Before ReWrite can be used, an [[internal]] or [[external]] file must already be [[open]]ed and assigned a [[file number]]. ReWrite can be used with internal files opened for either [[SEQUENTIAL]],[[RELATIVE]] or [[KEYED]] processing. ReWrite can be used with external files opened for SEQUENTIAL or RELATIVE processing. ReWrite operates only when files are opened [[OUTIN]]. ReWrite must follow a successful [[READ]] or [[REREAD]] when used with a SEQUENTIAL file, when used without a [[REC=]] clause or [[POS=]] clause for RELATIVE files, and when used without a [[KEY]] clause for KEYED files. In each of these three cases, the record updated will be the last record read.

	===Syntax===		===Syntax===

Laura: /* Technical Considerations */

2013-02-06T02:04:05Z

Technical Considerations

← Older revision		Revision as of 02:04, 6 February 2013
Line 47:		Line 47:
	<noinclude>		<noinclude>
	[[Category:Statements]]		[[Category:Statements]]
	[[Category:~~Internal File Processing Statements]]~~		[[Category:File Processing Statements]]
	~~[[Category:External~~ File Processing Statements]]
	</noinclude>		</noinclude>

Laura: Created page with "The '''ReWrite''' (REW) statement updates an existing record in an internal or external file. ===Comments and Examples=== Before ReWrite can be used, an internal or [..."

2013-01-31T21:43:27Z

Created page with "The '''ReWrite''' (REW) statement updates an existing record in an internal or external file. ===Comments and Examples=== Before ReWrite can be used, an internal or [..."

New page

The '''ReWrite''' (REW) [[statement]] updates an existing record in an internal or external file.

===Comments and Examples===
Before ReWrite can be used, an [[internal]] or [[external]] file must already be [[opened]] and assigned a [[file number]]. ReWrite can be used with internal files opened for either [[SEQUENTIAL]],[[RELATIVE]] or [[KEYED]] processing. ReWrite can be used with external files opened for SEQUENTIAL or RELATIVE processing. ReWrite operates only when files are opened [[OUTIN]]. ReWrite must follow a successful [[READ]] or [[REREAD]] when used with a SEQUENTIAL file, when used without a [[REC=]] clause or [[POS=]] clause for RELATIVE files, and when used without a [[KEY]] clause for KEYED files. In each of these three cases, the record updated will be the last record read.

===Syntax===
[[Image:Rewrite.png|900px]]

===Defaults===
# Unformatted.
# Write over the last record read.
# Rewrite the current record and unlock all locked records for this file.
# Interrupt the program if an error occurs and "ON error" is not active.

===Parameters===
"File-num" is an integer or numeric expression; it matches a REWRITE statement to a file of the same number that has already been identified in an OPEN statement.

The "USING" keyword is part of a clause that specifies either the "line-ref" of a [[FORM]] statement or a "string-expr" containing a FORM statement.

The "POS = num-expr" clause is used only with external files opened for RELATIVE processing; its purpose is to position to a specified byte before rewriting. After the numeric expression is evaluated and rounded to an integer, the system reads a complete record beginning at the specified byte number.

The "REC = num-expr" parameter is used with internal files opened for RELATIVE or KEYED processing, or with external files opened for RELATIVE access; its purpose is to specify a record by record number. After the numeric expression (usually a simple numeric variable or constant) is evaluated and rounded to an integer, the system reads and then rewrites that record number.

The "KEY = string-expr" clause is used with files opened for KEYED processing; its purpose is to specify a record by the value of its key field. After the string expression is evaluated, the system reads and then rewrites the first record that matches the key field. For complete information about the KEY clause, see the Index Facility chapter.

The "RESERVE" and "RELEASE" parameters specify record locking rules for multi-user systems. "RESERVE" instructs the system to reserve all previous record locks. "RELEASE" releases all record locks on this file as soon as the REWRITE is complete.

The "MAT array-name" and "data-item" parameters represent a list of items to be written to the old record. If more than one is specified, they must be separated by commas.

REWRITE allows error processing with the optional "error-cond line-ref" parameter. See [[Error Conditions]] for more information.

===Technical Considerations===
# Relevant error conditions are: [[CONV]], [[ERROR]], [[EXIT]], [[IOERR]], [[LOCKED]], [[NOKEY]], [[NOREC]], and [[SOFLOW]].
# On multi-user systems, the record being rewritten must be locked or an error [[0062]] (record not locked) will result.
# If a "string-expr" is used with a USING clause, it must begin with "FORM ". This technique executes relatively slowly because the string is compiled on each execution of the REWRITE statement.
# Omitting the USING clause allows unformatted file I/O. See [[File I/O]] for more information.
# Unspecified positions in the record (e.g., skipped over by POS n or X n) remain unchanged.
# With RELATIVE processing, the REWRITE is not affected by the previous I/O statement when a REC= clause or POS= clause is used. An implied READ REC= is performed before the REWRITE.
# In a file opened for KEYED processing, it is possible to rewrite records by record number without disturbing the key position in the file. Using the record number for access is much faster than using a key. One caution is that you should not use REWRITE REC= if you have changed one or more key fields in a record. Since REWRITE REC= has no effect on the key files, a changed key field would prevent the key file from matching the master file.
# With KEYED processing, the REWRITE is not affected by the previous I/O statement when a KEY clause is used. An implied READ KEY= is performed before the REWRITE.
# "KEY=" is the only form allowed when REWRITE is used with a KEY clause. "KEY>=", "SEARCH=", and "SEARCH>=" matches are not allowed because their results (partial and "next greater" matches) are unpredictable.
# No error results when a REWRITE statement tries to change the key field. The fields used for other keys can also be changed when multiple index files are being maintained, and the index files will be updated automatically. For more information about multiple index files, see the Index Facility chapter.
# When OPTION INVP is in effect, the normal output of commas and periods is interchanged in PIC, N, NZ, G and GZ format specifications to produce European-style numbers. See the [[OPTION]] statement for details.
# When REWRITING REC=, or just REWRITE after a READ REC=, to a file with indexes open, the indexes will be maintained. Previously REC= processing ignored indexes on a rewrite. A consequence of this is the undetectability of multiple opens input noshr. However, this poses no jeopardy to data. Any open requesting write permissions will not be allowed while the file is opened input noshr, and no input noshr will be allowed while the file is opened for writing, but two opens input noshr MAY be allowed on the same file at the same time. In other words in this case sharing is not blocked.

<noinclude>
[[Category:Statements]]
[[Category:Internal File Processing Statements]]
[[Category:External File Processing Statements]]
</noinclude>