RESET command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
Line 37: Line 37:
</p>
</p>
==Usage notes==
==Usage notes==
<p>The RESET command changes the settings of any number of <var class="product">Model&nbsp;204</var> parameters. The type of parameters that can be set (for example, system parameters, file parameters) depends upon the privileges of the user who issues the command.</p>
<ul>
<p>RESET is often used in conjunction with the VIEW command. You can VIEW parameter settings and then decide to change them. For example: </p>
<li>The <var>RESET</var> command changes the settings of any number of <var class="product">Model&nbsp;204</var> parameters. The type of parameters that can be set (for example, system parameters, file parameters) depends upon the privileges of the user who issues the command.</li>
 
<li><var>RESET</var> is often used in conjunction with the VIEW command. You can VIEW parameter settings and then decide to change them. For example:  
<p class="code"><b>VIEW ERMX,ERASE</b>
<p class="code"><b>VIEW ERMX,ERASE</b>
ERMX  50        Maximum number of errors
ERMX  50        Maximum number of errors
Line 45: Line 47:
ERMX  40        Maximum number of errors
ERMX  40        Maximum number of errors
ERASE  -  X'60'  Erase-character symbol
ERASE  -  X'60'  Erase-character symbol
</p>
</p></li>
<p>If no parameters are specified in the RESET command, <var class="product">Model&nbsp;204</var> prompts for them, as shown in the following example:</p>
 
<li>If no parameters are specified in the <var>RESET</var> command, <var class="product">Model&nbsp;204</var> prompts for them, as shown in the following example:
<p class="code"><nowiki>RESET
<p class="code"><nowiki>RESET
***  M204.1119: READING PARAMETERS
***  M204.1119: READING PARAMETERS
Line 53: Line 56:
PGSEP  3        Lines between pages
PGSEP  3        Lines between pages
</nowiki></p>
</nowiki></p>
<p>If you specify a nonexistent parameter or attempt to reset a parameter that is not resettable, <var class="product">Model&nbsp;204</var> responds with the message: </p>
<p>
If you specify a nonexistent parameter or attempt to reset a parameter that is not resettable, <var class="product">Model&nbsp;204</var> responds with the message: </p>
<p class="code">*** M204.1123: PARAMETER NOT RESET = parameter
<p class="code">*** M204.1123: PARAMETER NOT RESET = parameter
</p>
</p>
<p>You cannot use RESET to set bits that are currently undefined by Rocket Software (see the parameter descriptions of [[FISTAT parameter|"FISTAT: Current file status"]], [[FOPT parameter|"FOPT: File options"]], and [[OPENCTL parameter|"OPENCTL: Password option during file open"]]).</p>
 
<p>For example, in an Online where the Date Time Stamp feature is not installed, if a system manager issues a <code>RESET DTS</code> command, the following message is displayed: </p>
<li>You cannot use <var>RESET</var> to set bits that are currently undefined by Rocket Software (see the parameter descriptions of [[FISTAT parameter|"FISTAT: Current file status"]], [[FOPT parameter|"FOPT: File options"]], and [[OPENCTL parameter|"OPENCTL: Password option during file open"]]).
<p>
For example, in an Online where the Date Time Stamp feature is not installed, if a system manager issues a <code>RESET DTS</code> command, the following message is displayed: </p>
<p class="code">RESET DTS 0
<p class="code">RESET DTS 0
<b></b>***  M204.2740: INVALID PARAMETER DTS: DATE TIME STAMP SUPPORT NOT LINKED IN
<b></b>***  M204.2740: INVALID PARAMETER DTS: DATE TIME STAMP SUPPORT NOT LINKED IN
DTS    1        Date time stamp updates (1=automatic, 0=bypassed)
DTS    1        Date time stamp updates (1=automatic, 0=bypassed)
</p>
</p></li>
<p>When it processes RESET, <var class="product">Model&nbsp;204</var> ends any current User Language update unit and begins a non-backoutable update unit. If a <var class="product">Model&nbsp;204</var> command non-backoutable update unit is in progress, RESET is included in that update unit. For more information about <var class="product">Model&nbsp;204</var> update units, see the <var>Model&nbsp;204 File Manager's Guide.</var></p>
 
<li>When it processes <var>RESET</var>, <var class="product">Model&nbsp;204</var> ends any current User Language update unit and begins a non-backoutable update unit. If a <var class="product">Model&nbsp;204</var> command non-backoutable update unit is in progress, <var>RESET</var> is included in that update unit. For more information about <var class="product">Model&nbsp;204</var> update units, see the <var class="product">Model&nbsp;204 File Manager's Guide.</var></li>
 
[[Category:Commands]]
[[Category:Commands]]

Revision as of 16:15, 10 June 2013

Summary

Privileges
Dependent upon parameters to be reset
Function
Modifies the settings of one or more Model 204 parameters

Syntax

RESET parameter=value [,parameter=value]...

Where:

parameter A Model 204 parameter.
value The new value of the parameter (which can be specified in various formats, as discussed in "??" Part 1.

As of version 7.5 of Model 204, for a numeric parameter, you can specify value relative to the current value of the parameter.

Syntax notes

  • The RESET command can be abbreviated as R.
  • The comma (following each value) and the equal sign (before each value) are optional.
  • As noted below, an alternate form of RESET, without any parameters, causes Model 204 to prompt for a line with a series of parameter names and values.

Example

RESET ERMX=50 SUB=4 ERMX 50 Maximum number of errors SUB X'04' Substitution control

Usage notes

  • The RESET command changes the settings of any number of Model 204 parameters. The type of parameters that can be set (for example, system parameters, file parameters) depends upon the privileges of the user who issues the command.
  • RESET is often used in conjunction with the VIEW command. You can VIEW parameter settings and then decide to change them. For example:

    VIEW ERMX,ERASE ERMX 50 Maximum number of errors ERASE @ X'7C' Erase-character symbol RESET ERMX=40, ERASE=96 ERMX 40 Maximum number of errors ERASE - X'60' Erase-character symbol

  • If no parameters are specified in the RESET command, Model 204 prompts for them, as shown in the following example:

    RESET *** M204.1119: READING PARAMETERS OUTLPP=50, PGSEP=3 OUTLPP 50 Output lines per page PGSEP 3 Lines between pages

    If you specify a nonexistent parameter or attempt to reset a parameter that is not resettable, Model 204 responds with the message:

    *** M204.1123: PARAMETER NOT RESET = parameter

  • You cannot use RESET to set bits that are currently undefined by Rocket Software (see the parameter descriptions of "FISTAT: Current file status", "FOPT: File options", and "OPENCTL: Password option during file open").

    For example, in an Online where the Date Time Stamp feature is not installed, if a system manager issues a RESET DTS command, the following message is displayed:

    RESET DTS 0 *** M204.2740: INVALID PARAMETER DTS: DATE TIME STAMP SUPPORT NOT LINKED IN DTS 1 Date time stamp updates (1=automatic, 0=bypassed)

  • When it processes RESET, Model 204 ends any current User Language update unit and begins a non-backoutable update unit. If a Model 204 command non-backoutable update unit is in progress, RESET is included in that update unit. For more information about Model 204 update units, see the Model 204 File Manager's Guide.