Model 204 full-screen editor - Revision history

Abe: /* Procedure update control */ grammar

2024-09-27T19:14:08Z

Procedure update control: grammar

← Older revision		Revision as of 19:14, 27 September 2024
Line 1,166:		Line 1,166:
	===Procedure update control===		===Procedure update control===
	<p>Before Model 204 7.8, the editor would hold a shared lock on the procedure being editing during the edit session. This would ensure that no other user could update the procedure underneath the user in the editor. Unfortunately, this would also block updates in the common case where one is just browsing a procedure in the editor and leave a lock on a procedure if the editing user forgets to exit the editor.</p>		<p>Before Model 204 7.8, the editor would hold a shared lock on the procedure being editing during the edit session. This would ensure that no other user could update the procedure underneath the user in the editor. Unfortunately, this would also block updates in the common case where one is just browsing a procedure in the editor and leave a lock on a procedure if the editing user forgets to exit the editor.</p>
	<p>Under Model 204 7.8 and later, no lock is held on the procedure during the edit session. Instead, if the user attempts to save the procedure via the <var>SAVE</var>, <var>END</var>, or <var>GO</var> command, the timestamp if the procedure in the output file is compared with the timestamp when the procedure was loaded or last saved. If the timestamp no longer matches, it means that another user has modified the procedure and saving the procedure would overwrite those changes. In this case the editing user is warned and the save is not performed. If the editing user wishes to force the save, anyway, the user can issue the <var>SSAVE</var>, <var>EEND</var>, or <var>GGO</var> command.</p>		<p>Under Model 204 7.8 and later, no lock is held on the procedure during the edit session. Instead, if the user attempts to save the procedure via the <var>SAVE</var>, <var>END</var>, or <var>GO</var> command, the timestamp if the procedure in the output file is compared with the timestamp when the procedure was loaded or last saved. If the timestamp no longer matches, it means that another user has modified the procedure and saving the procedure would overwrite those changes. In this case the editing user is warned and the save is not performed. If the editing user wishes to force the save anyway, the user can issue the <var>SSAVE</var> command, the <var>EEND</var> command, or the <var>GGO</var> command.</p>
	[[Category: Model 204 editor]]		[[Category: Model 204 editor]]

Abe: /* Procedure update control */

2024-09-27T19:12:30Z

Procedure update control

← Older revision		Revision as of 19:12, 27 September 2024
Line 1,165:		Line 1,165:

	===Procedure update control===		===Procedure update control===
	<p>Before Model 204 7.8, the editor would hold a ~~share~~ lock on the procedure being editing during the edit session. This would ensure that no other user could update the procedure underneath the user in the editor. Unfortunately, this would also block updates in the common case where one is just browsing a procedure in the editor and leave a lock on a procedure if the editing user forgets to exit the editor.</p>		<p>Before Model 204 7.8, the editor would hold a shared lock on the procedure being editing during the edit session. This would ensure that no other user could update the procedure underneath the user in the editor. Unfortunately, this would also block updates in the common case where one is just browsing a procedure in the editor and leave a lock on a procedure if the editing user forgets to exit the editor.</p>
	<p>Under Model 204 7.8 and later, no lock is held on the procedure during the edit session. Instead, if the user attempts to save the procedure via the <var>SAVE</var>, <var>END</var>, or <var>GO</var> command, the timestamp if the procedure in the output file is compared with the timestamp when the procedure was loaded or last saved. If the timestamp no longer matches, it means that another user has modified the procedure and saving the procedure would overwrite those changes. In this case the editing user is warned and the save is not performed. If the editing user wishes to force the save, anyway, the user can issue the <var>SSAVE</var>, <var>EEND</var>, or <var>GGO</var> command.</p>		<p>Under Model 204 7.8 and later, no lock is held on the procedure during the edit session. Instead, if the user attempts to save the procedure via the <var>SAVE</var>, <var>END</var>, or <var>GO</var> command, the timestamp if the procedure in the output file is compared with the timestamp when the procedure was loaded or last saved. If the timestamp no longer matches, it means that another user has modified the procedure and saving the procedure would overwrite those changes. In this case the editing user is warned and the save is not performed. If the editing user wishes to force the save, anyway, the user can issue the <var>SSAVE</var>, <var>EEND</var>, or <var>GGO</var> command.</p>
	[[Category: Model 204 editor]]		[[Category: Model 204 editor]]

Abe: /* Saving the procedure (SAVE or SSAVE) */

2024-09-27T19:11:49Z

Saving the procedure (SAVE or SSAVE)

← Older revision		Revision as of 19:11, 27 September 2024
Line 1,147:		Line 1,147:
	===Saving the procedure (SAVE or SSAVE)===		===Saving the procedure (SAVE or SSAVE)===
	<p>		<p>
	The SAVE or SSAVE command saves the edited procedure or a subset of that procedure under the specified name (<var class="term">		The SAVE or SSAVE command saves the edited procedure or a subset of that procedure under the specified name (<var class="term">procname</var>) or the default procedure name. Unlike the END, GO, and QUIT commands, SAVE does not exit from the editor. To ensure against the loss of changes due to a system failure, issue the SAVE command periodically while you edit a procedure.</p>
	procname</var>) or the default procedure name. Unlike the END, GO, and QUIT commands, SAVE does not exit from the editor. To ensure against the loss of changes due to a system failure, issue the SAVE command periodically while you edit a procedure.</p>
	<p>		<p>
	The format of the SAVE/SSAVE command is as follows:</p>		The format of the SAVE/SSAVE command is as follows:</p>

Abe: /* Exiting from the editor without saving the edited procedure (QUIT) */ grammar

2024-09-27T19:09:16Z

Exiting from the editor without saving the edited procedure (QUIT): grammar

← Older revision		Revision as of 19:09, 27 September 2024
Line 1,129:		Line 1,129:
	<p class="code">QUIT</p>		<p class="code">QUIT</p>
	<p>		<p>
	If you change the procedure during the current editing session and exit by entering QUIT, the full-screen editor displays the following message, which indicates that the procedure was changed and ~~requests that~~ you to enter QUIT again, if you want to exit the procedure without saving the edits:</p>		If you change the procedure during the current editing session and exit by entering QUIT, the full-screen editor displays the following message, which indicates that the procedure was changed and asks you to enter QUIT again if you want to exit the procedure without saving the edits:</p>
	<p class="code">PROCEDURE HAS BEEN MODIFIED, ENTER 'QUIT' TO VERIFY.</p>		<p class="code">PROCEDURE HAS BEEN MODIFIED, ENTER 'QUIT' TO VERIFY.</p>
	<p>		<p>
Line 1,144:		Line 1,144:
	<p>		<p>
	You can also press PF3 to quit. Your edits are not saved.</p>		You can also press PF3 to quit. Your edits are not saved.</p>

	===Saving the procedure (SAVE or SSAVE)===		===Saving the procedure (SAVE or SSAVE)===
	<p>		<p>

Abe: /* Clearing the prefix area */

2024-09-27T18:14:01Z

Clearing the prefix area

← Older revision		Revision as of 18:14, 27 September 2024
Line 385:		Line 385:
	<li>Clears any display area text that has been typed since the last time you pressed Enter (or a PF key). </li>		<li>Clears any display area text that has been typed since the last time you pressed Enter (or a PF key). </li>
	<li>Aborts any pending prefix operations.</li>		<li>Aborts any pending prefix operations.</li>
	<li>Cancels any specified targets . </li>		<li>Cancels any specified targets. </li>
	</ul>		</ul>

Alex: /* Exiting from the full-screen editor */

2020-02-01T22:45:44Z

Exiting from the full-screen editor

← Older revision		Revision as of 22:45, 1 February 2020
Line 1,050:		Line 1,050:
	The U (undelete) prefix command retrieves the last entry that was deleted (that is, placed on the delete stack) and inserts it after the line that contains the U.</p>		The U (undelete) prefix command retrieves the last entry that was deleted (that is, placed on the delete stack) and inserts it after the line that contains the U.</p>

	==Exiting from the full-screen editor==		<h2 id="exit">Exiting from the full-screen editor</h2>
	<p>		<p>
	To exit from the full-screen editor or to save edited procedures, use the commands listed in the following table, which also lists the description of each command and where more information is located. When you exit from the full-screen editor, you are returned to the Model 204 command level.</p>		To exit from the full-screen editor or to save edited procedures, use the commands listed in the following table, which also lists the description of each command and where more information is located. When you exit from the full-screen editor, you are returned to the Model 204 command level.</p>

Alex: /* Exiting from the full-screen editor */

2020-02-01T22:43:52Z

Exiting from the full-screen editor

← Older revision		Revision as of 22:43, 1 February 2020
Line 1,061:		Line 1,061:

	<tr>		<tr>
	<th>END</th>		<th>END or EEND</th>
	<td>Exits from the full-screen editor and saves the edited procedures.</td>		<td>Exits from the full-screen editor and saves the edited procedures. The EEND command is only available under Model 204 7.8 and later and indicates that the procedure should be saved even if the procedure has been changed by another user since it was loaded into the editor or last saved.</td>
	</tr>		</tr>

	<tr>		<tr>
	<th>GO</th>		<th>GO or GGO</th>
	<td>Exits from the full-screen editor, saves the edited procedure, and includes (executes) the edited procedure.</td>		<td>Exits from the full-screen editor, saves the edited procedure, and includes (executes) the edited procedure. The GGO command is only available under Model 204 7.8 and later and indicates that the procedure should be saved even if the procedure has been changed by another user since it was loaded into the editor or last saved. Under Model 204 7.8 and later, the GO command does not actually update the procedure in the file if it has not been modified since it was loaded or last saved.</td>
	</tr>		</tr>

Line 1,076:		Line 1,076:

	<tr>		<tr>
	<th>SAVE</th>		<th>SAVE or SSAVE</th>
	<td>Does not exit from the full-screen editor, but saves the edited procedure.</td></tr>		<td>Does not exit from the full-screen editor, but saves the edited procedure. The SSAVE command is only available under Model 204 7.8 and later and indicates that the procedure should be saved even if the procedure has been changed by another user since it was loaded into the editor or last saved.</td></tr>
	</table>		</table>
	<p>		<p>
	For more information about exit and save commands, refer to the [[EDIT command]].</p>		For more information about exit and save commands, refer to the [[EDIT command]].</p>

	===Exiting from the editor and saving the procedure (END)===		===Exiting from the editor and saving the procedure (END or EEND)===
	<p>		<p>
	The END command exits from the full-screen editor and saves the edited procedure on disk. Specify the name under which the procedure is to be saved. You can store the procedure in either the default procedure file or in a file specified in the command.</p>		The END or EEND command exits from the full-screen editor and saves the edited procedure on disk. Specify the name under which the procedure is to be saved. You can store the procedure in either the default procedure file or in a file specified in the command.</p>
	<p>		<p>
	The format of the END command is as follows:</p>		The format of the END/EEND command is as follows:</p>
	<p class="syntax">[IN <span class="term">filespec</span>] END [<span class="term">procname</span>]</p>		<p class="syntax">[IN <span class="term">filespec</span>] [END \| EEND] [<span class="term">procname</span>]</p>
	<p>		<p>
	Where:</p>		Where:</p>
Line 1,111:		Line 1,111:
	<p>		<p>
	If you enter END, the procedure is saved under the name of the output procedure specified when you invoked the editor. The procedure is stored in the Model 204 default procedure file.</p>		If you enter END, the procedure is saved under the name of the output procedure specified when you invoked the editor. The procedure is stored in the Model 204 default procedure file.</p>
			<p>The EEND command is only available under Model 204 7.8 and later and indicates that the procedure is to be saved even if another user has updated the procedure in the file since the procedure was loaded or last saved. EEND would result in that other user's changes being overwritten.</p>

	===Saving and including the procedure (GO)===		===Saving and including the procedure (GO or GGO)===
	<p>		<p>
	Like the END command, the GO command exits from the full-screen editor and saves the edited procedure. Unlike END, GO automatically performs an implicit Model 204 [[INCLUDE command]], which executes the Model 204 commands in the saved procedure.</p>		Like the END command, the GO or GGO command exits from the full-screen editor and saves the edited procedure. Unlike END, GO automatically performs an implicit Model 204 [[INCLUDE command]], which executes the Model 204 commands in the saved procedure.</p>

	The format of the GO command is as follows:		The format of the GO/GGO command is as follows:
	<p class="syntax">[IN <span class="term">filespec</span>] GO [<span class="term">procname</span>]</p>		<p class="syntax">[IN <span class="term">filespec</span>] [GO \| GGO] [<span class="term">procname</span>]</p>
	<p>		<p>
	GO command options are identical to END command options. If you enter GO, the full-screen editor saves the procedure under the name of the output procedure specified when you invoked the full-screen editor. The procedure is stored in the Model 204 default procedure file.</p>		GO command options are identical to END command options. If you enter GO, the full-screen editor saves the procedure under the name of the output procedure specified when you invoked the full-screen editor. The procedure is stored in the Model 204 default procedure file. Under Model 204 7.8 and later, the procedure won't actually be updated by the GO command if it has not been modified in the editor since it was loaded or last saved.</p>
			<p>The GGO command is only available under Model 204 7.8 and later and indicates that the procedure is to be saved even if another user has updated the procedure in the file since the procedure was loaded or last saved. GGO would result in that other user's changes being overwritten.</p>
	===Exiting from the editor without saving the edited procedure (QUIT)===		===Exiting from the editor without saving the edited procedure (QUIT)===
	<p>		<p>
Line 1,144:		Line 1,145:
	You can also press PF3 to quit. Your edits are not saved.</p>		You can also press PF3 to quit. Your edits are not saved.</p>

	===Saving the procedure (SAVE)===		===Saving the procedure (SAVE or SSAVE)===
	<p>		<p>
	The SAVE command saves the edited procedure or a subset of that procedure under the specified name (<var class="term">		The SAVE or SSAVE command saves the edited procedure or a subset of that procedure under the specified name (<var class="term">
	procname</var>) or the default procedure name. Unlike the END, GO, and QUIT commands, SAVE does not exit from the editor. To ensure against the loss of changes due to a system failure, issue the SAVE command periodically while you edit a procedure.</p>		procname</var>) or the default procedure name. Unlike the END, GO, and QUIT commands, SAVE does not exit from the editor. To ensure against the loss of changes due to a system failure, issue the SAVE command periodically while you edit a procedure.</p>
	<p>		<p>
	The format of the SAVE command is as follows:</p>		The format of the SAVE/SSAVE command is as follows:</p>
	<p class="syntax">[IN <span class="term">filespec</span>] SAVE [<span class="term">procname</span> \| <span class="term">procname</span>] [[IN] <span class="term">range</span>]</p>		<p class="syntax">[IN <span class="term">filespec</span>] [SAVE \| SSAVE] [<span class="term">procname</span> \| <span class="term">procname</span>] [[IN] <span class="term">range</span>]</p>
	<p>		<p>
	Where:</p>		Where:</p>
Line 1,162:		Line 1,163:
	<p>		<p>
	If you enter SAVE alone, the full-screen editor saves the entire procedure under the name of the output procedure specified when the editor was invoked. The procedure is stored in the Model 204 default procedure file.</p>		If you enter SAVE alone, the full-screen editor saves the entire procedure under the name of the output procedure specified when the editor was invoked. The procedure is stored in the Model 204 default procedure file.</p>
			<p>The SSAVE command is only available under Model 204 7.8 and later and indicates that the procedure is to be saved even if another user has updated the procedure in the file since the procedure was loaded or last saved. SSAVE would result in that other user's changes being overwritten.</p>

			===Procedure update control===
			<p>Before Model 204 7.8, the editor would hold a share lock on the procedure being editing during the edit session. This would ensure that no other user could update the procedure underneath the user in the editor. Unfortunately, this would also block updates in the common case where one is just browsing a procedure in the editor and leave a lock on a procedure if the editing user forgets to exit the editor.</p>
			<p>Under Model 204 7.8 and later, no lock is held on the procedure during the edit session. Instead, if the user attempts to save the procedure via the <var>SAVE</var>, <var>END</var>, or <var>GO</var> command, the timestamp if the procedure in the output file is compared with the timestamp when the procedure was loaded or last saved. If the timestamp no longer matches, it means that another user has modified the procedure and saving the procedure would overwrite those changes. In this case the editing user is warned and the save is not performed. If the editing user wishes to force the save, anyway, the user can issue the <var>SSAVE</var>, <var>EEND</var>, or <var>GGO</var> command.</p>
	[[Category: Model 204 editor]]		[[Category: Model 204 editor]]

JAL: /* Exiting from the full-screen editor */ minor formatting

2017-10-13T00:06:34Z

Exiting from the full-screen editor: minor formatting

← Older revision		Revision as of 00:06, 13 October 2017
Line 1,054:		Line 1,054:
	To exit from the full-screen editor or to save edited procedures, use the commands listed in the following table, which also lists the description of each command and where more information is located. When you exit from the full-screen editor, you are returned to the Model 204 command level.</p>		To exit from the full-screen editor or to save edited procedures, use the commands listed in the following table, which also lists the description of each command and where more information is located. When you exit from the full-screen editor, you are returned to the Model 204 command level.</p>
	<table class="thJustBold">		<table class="thJustBold">
	<CAPTION>		<CAPTION>Exit and save commands</CAPTION>
	Exit and save commands
	</CAPTION>
	<tr class="head">		<tr class="head">
	<th>This command...</th>		<th>This command...</th>
Line 1,069:		Line 1,067:
	<tr>		<tr>
	<th>GO</th>		<th>GO</th>
	<td>		<td>Exits from the full-screen editor, saves the edited procedure, and includes (executes) the edited procedure.</td>
	<p>Exits from the full-screen editor, saves the edited procedure, and includes (executes) the edited procedure.~~</p>~~
	</td>
	</tr>		</tr>

Line 1,081:		Line 1,077:
	<tr>		<tr>
	<th>SAVE</th>		<th>SAVE</th>
	<td>Does not exit from the full-screen editor, but saves the edited procedure.</td>		<td>Does not exit from the full-screen editor, but saves the edited procedure.</td></tr>
	</tr>
	</table>		</table>
	<p>		<p>

JDamon: Fixed "Specifying range targets" redirect

2017-02-08T20:25:27Z

Fixed "Specifying range targets" redirect

← Older revision		Revision as of 20:25, 8 February 2017
Line 857:		Line 857:
	===Specifying a range===		===Specifying a range===
	<p>		<p>
	You can specify a range of procedure lines to which the search applies. See [[#~~See~~ Specifying range targets\|Specifying range targets]] for more information about using a range. See [[#Range target characters\|Range target characters]] for a list of range specifications.</p>		You can specify a range of procedure lines to which the search applies. See [[#Specifying range targets\|Specifying range targets]] for more information about using a range. See [[#Range target characters\|Range target characters]] for a list of range specifications.</p>

	==Inserting text==		==Inserting text==

JAL: replace proc name info with pointer to EDIT command page

2016-07-21T16:42:14Z

replace proc name info with pointer to EDIT command page

← Older revision		Revision as of 16:42, 21 July 2016
Line 53:		Line 53:

	===Model 204 requirements===		===Model 204 requirements===

	Before invoking the full-screen editor, set the Model 204 LOUTPB parameter to a minimum value of 3000. The [[LOUTPB parameter]] specifies the length of the output page buffer for 3270 terminals that use the full-screen capabilities.		Before invoking the full-screen editor, set the Model 204 LOUTPB parameter to a minimum value of 3000. The [[LOUTPB parameter]] specifies the length of the output page buffer for 3270 terminals that use the full-screen capabilities.

Line 62:		Line 61:
	<li>Indirectly in a User Language (SOUL) request</li>		<li>Indirectly in a User Language (SOUL) request</li>
	</ul>		</ul>
	To invoke the full-screen editor from a terminal, enter the [[EDIT command]].		To invoke the full-screen editor from a terminal, enter the <var>[[EDIT command\|EDIT]]</var> command.

	====Using the EDIT command====		====Using the EDIT command====
			To invoke the full-screen editor, use the <var>EDIT command</var>. The format of the <var>EDIT</var> command is as follows:
	To invoke the full-screen editor, use the EDIT command. The format of the EDIT command is as follows:

	~~<b>Syntax</b>~~		<p class="syntax">EDIT(SCREEN)[<span class="term">oldproc</span>,<span class="term">newproc</span>]</p>
	<p class="~~code~~">EDIT(SCREEN)[oldproc,newproc]</p>

	====Specifying the type of editor====		====Specifying the type of editor====
	You can include a parameter that indicates which of the Model 204 editors to invoke. To request the full-screen editor, enter:		You can include a parameter that indicates which of the Model 204 editors to invoke. To request the full-screen editor, enter:
	<p class="code">EDIT (SCREEN)</p>		<p class="code">EDIT (SCREEN)</p>

Line 81:		Line 78:

	====Specifying an input procedure====		====Specifying an input procedure====
			Use the <var class="term">oldproc</var> parameter to name a temporary or permanent procedure to be used as input for the current editing session. If you do not specify an <var class="term">oldproc</var> option, the full-screen editor creates a temporary procedure (Model 204 temporary procedure 0). Note that you cannot use the full-screen editor to create a new and permanent procedure if you specify a nonexistent input procedure.
	Use the oldproc parameter to name a temporary or permanent procedure to be used as input for the current editing session. If you do not specify an oldproc option, the full-screen editor creates a temporary procedure (Model 204 temporary procedure 0). Note that you cannot use the full-screen editor to create a new and permanent procedure if you specify a nonexistent input procedure.

	====Specifying an output procedure====		====Specifying an output procedure====
			Use the <var class="term">newproc</var> parameter to specify an output procedure name. You can include an output procedure name in the EDIT command or specify a name when you exit from the procedure with an END, GO, or SAVE command. After the editing session terminates, Model 204 saves the procedure under the specified <var class="term">newproc</var> name. If you specify a <var class="term">newproc</var> parameter in the EDIT command and enter a <var class="term">procname</var> parameter when exiting from the procedure, the <var class="term">procname</var> parameter specified when exiting overrides the name specified in the EDIT command.

	Use the newproc parameter to specify an output procedure name. You can include an output procedure name in the EDIT command or specify a name when you exit from the procedure with an END, GO, or SAVE command. After the editing session terminates, Model 204 saves the procedure under the specified newproc name. If you specify a newproc parameter in the EDIT command and enter a procname parameter when exiting from the procedure, ~~the procname parameter specified when exiting overrides the name specified in the~~ EDIT command.		For information about the rules for procedure names, see [[EDIT command#Procedure names\|Procedure names]].

	~~====Rules for procedure~~ names~~====~~

	~~The oldproc and newproc~~ names ~~can consist of any combination of letters, numbers, and symbols, except:~~
	~~<ul>~~
	~~<li>Blank or space</li>~~
	~~<li>Comma</li>~~
	~~<li>Semicolon</li>~~
	~~<li>Minus sign</li>~~
	~~<li>Equal sign</li>~~
	~~<li>Single quote</li>~~
	~~<li>Carriage return </li>~~
	~~</ul>~~

	~~The maximum length of a procedure name is 255 characters~~.

	====Results of using the EDIT command====		====Results of using the EDIT command====

	After you invoke the full-screen editor, use any of the commands described in this chapter. When you enter the full-screen editor, the first portion of the procedure to be edited appears in the display area and the cursor appears at the beginning of the command line. To reposition the cursor to the command line, press the HOME key (usually ALT-BACKTAB).		After you invoke the full-screen editor, use any of the commands described in this chapter. When you enter the full-screen editor, the first portion of the procedure to be edited appears in the display area and the cursor appears at the beginning of the command line. To reposition the cursor to the command line, press the HOME key (usually ALT-BACKTAB).

Line 111:		Line 92:

	===Invoking the editor indirectly===		===Invoking the editor indirectly===

	You can invoke the full-screen editor indirectly by including the EDIT command in a SOUL request by using the TERMINAL option in the following format:		You can invoke the full-screen editor indirectly by including the EDIT command in a SOUL request by using the TERMINAL option in the following format:

	~~<b>Syntax</b>~~		<p class="syntax">EDIT (TERMINAL)</p>
	<p class="~~code~~">EDIT (TERMINAL)</p>

	====TERMINAL option of EDIT====		====TERMINAL option of EDIT====