RESTOREG command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (remove Sys Man guide)
 
Line 6: Line 6:
<dd>Restores the CCAGRP file from a sequential data set
<dd>Restores the CCAGRP file from a sequential data set
</dl>
</dl>
==Syntax==
==Syntax==
<p class="syntax">RESTOREG [<i>option</i>] FROM <i>ddname</i>
<p class="syntax">RESTOREG [<span class="term">option</span>] FROM <span class="term">ddname</span>
</p>
</p>
   
   
<b>Where:</b>
Where:
<table>  
<table>  
<tr>
<tr><th>option</th>
<th>option</th>
<td>A decimal value; set it to 128 if the size of the CCAGRP data set or the number of data sets in CCAGRP is being changed.</td>
<td> is a decimal value; set it to 128 if the size of the CCAGRP data set or the number of data sets in CCAGRP is being changed.</td>
</tr>
</tr>
   
   
<tr>
<tr>
<th>ddname</th>
<th>ddname</th>
<td> is the name of the sequential data set from which CCAGRP is being restored.</td>
<td>The name of the sequential data set from which CCAGRP is being restored.</td>
</tr>
</tr>  
</table>
</table>
===Syntax notes===
===Syntax notes===
RESTOREG cannot be issued from within a procedure.
<var>RESTOREG</var> cannot be issued from within a procedure.
 
==Example==
==Example==
<p class="code">RESTOREG 128 FROM DUMPGR1  
<p class="code">RESTOREG 128 FROM DUMPGR1  
</p>
</p>
==Usage notes==
==Usage notes==
<p>The RESTOREG command restores the CCAGRP file from a sequential data set containing a dumped version of the file. CCAGRP contains all permanent group definitions established by the system manager. RESTOREG can be issued in case of a system crash or another kind of system failure to restore the version of CCAGRP dumped by the DUMPG command.   </p>
<ul>
<p>If an external security interface is active, the user ID issuing the command is checked for the proper data set usage authorization. If the authorization check fails, the attempt is logged as a security violation and the command is not executed. Under a security interface, you must have READ privileges to read a file specified by this command. For more information, refer to the <var class="book">Rocket Model&nbsp;204 Security Interfaces Manual</var>. </p>
<li>The <var>RESTOREG</var> command restores the CCAGRP file from a sequential data set containing a dumped version of the file. CCAGRP contains all permanent group definitions established by the system manager. <var>RESTOREG</var> can be issued in case of a system crash or another kind of system failure to restore the version of CCAGRP dumped by the <var>[[DUMPG command|DUMPG]]</var> command.  
<p>The <var class="book">Rocket Model&nbsp;204 System Manager's Guide</var> contains a complete discussion of CCAGRP. </p>
<p>
<p>When it processes RESTOREG, <var class="product">Model&nbsp;204</var> ends any update unit in progress and begins a non-backoutable update unit. For more information about <var class="product">Model&nbsp;204</var> update units, see the <var class="book">Rocket Model&nbsp;204 File Manager's Guide</var>.</p>
[[Storing and using file group definitions (CCAGRP)]] contains a complete discussion of CCAGRP. </p></li>
 
<li>If an external security interface is active, the user ID issuing the command is checked for the proper data set usage authorization. If the authorization check fails, the attempt is logged as a security violation and the command is not executed. Under a security interface, you must have READ privileges to read a file specified by this command. For more information, refer to the <var class="book">Rocket Model&nbsp;204 Security Interfaces Manual</var>. </li>
 
<li>When it processes <var>RESTOREG</var>, <var class="product">Model&nbsp;204</var> ends any [[File_integrity_and_recovery#Update_units_and_transactions|update unit]] in progress and begins a non-backoutable update unit. </li>
</ul>
 
[[Category: System manager commands]]
[[Category: System manager commands]]
[[Category:Commands]]
[[Category:Commands]]

Latest revision as of 23:06, 17 November 2014

Summary

Privileges
System manager
Function
Restores the CCAGRP file from a sequential data set

Syntax

RESTOREG [option] FROM ddname

Where:

option A decimal value; set it to 128 if the size of the CCAGRP data set or the number of data sets in CCAGRP is being changed.
ddname The name of the sequential data set from which CCAGRP is being restored.

Syntax notes

RESTOREG cannot be issued from within a procedure.

Example

RESTOREG 128 FROM DUMPGR1

Usage notes

  • The RESTOREG command restores the CCAGRP file from a sequential data set containing a dumped version of the file. CCAGRP contains all permanent group definitions established by the system manager. RESTOREG can be issued in case of a system crash or another kind of system failure to restore the version of CCAGRP dumped by the DUMPG command.

    Storing and using file group definitions (CCAGRP) contains a complete discussion of CCAGRP.

  • If an external security interface is active, the user ID issuing the command is checked for the proper data set usage authorization. If the authorization check fails, the attempt is logged as a security violation and the command is not executed. Under a security interface, you must have READ privileges to read a file specified by this command. For more information, refer to the Rocket Model 204 Security Interfaces Manual.
  • When it processes RESTOREG, Model 204 ends any update unit in progress and begins a non-backoutable update unit.