ELowell at 16:16, 22 March 2017

2017-03-22T16:16:34Z

← Older revision		Revision as of 16:16, 22 March 2017
Line 128:		Line 128:
	[[Category: System administrator commands]]		[[Category: System administrator commands]]
	[[Category: System manager commands]]		[[Category: System manager commands]]
	[[Category: ~~General user~~ commands]]		[[Category: User commands]]
	[[Category:Commands]]		[[Category:Commands]]

JAL: remove Sys Man guide

2014-10-31T19:22:17Z

remove Sys Man guide

Show changes

JAL: /* Usage notes */

2013-03-08T01:52:20Z

Usage notes

← Older revision		Revision as of 01:52, 8 March 2013
Line 72:		Line 72:

	<tr>		<tr>
	<th><var>RESTART-status</var></th>		<th nowrap><var>RESTART-status</var></th>
	<td> appears only for a file that participated in recovery in the current run. The values of RESTART-status are shown in the following table. The checkpoint facility is detailed in the <var>Model 204 System Manager's Guide</var>		<td> appears only for a file that participated in recovery in the current run. The values of RESTART-status are shown in the following table. The checkpoint facility is detailed in the <var>Model 204 System Manager's Guide</var>
	<table>		<table>

JAL: /* Usage notes */

2013-03-08T01:51:19Z

Usage notes

← Older revision		Revision as of 01:51, 8 March 2013
Line 25:		Line 25:
	<table>		<table>
	<tr>		<tr>
	<th>current-status</th>		<th nowrap>current-status</th>
	<td> indicates special conditions that can affect discontinuities and future recovery of the file. current-status values are shown in the table below.		<td> indicates special conditions that can affect discontinuities and future recovery of the file. current-status values are shown in the table below.
	<table>		<table>

Alex: Automatically generated page update

2013-02-28T01:05:28Z

Automatically generated page update

New page

==Summary==
<dl>
<dt>Privileges
<dd>Any user (only the system manager or the system administrator can list information about all files)
<dt>Function
<dd>Lists recovery information about one or more files
</dl>
==Syntax==
STATUS filename


Where:
filename is the name of a <var class="product">Model 204</var> file that was opened during the run (by a user or a RESTART command). If the file name is omitted, status information is listed for all files opened during the run.
==Example==
STATUS CENSUS
==Usage notes==
If you issue a USE command prior to issuing STATUS, all output from the STATUS command is routed to the USE data set or printer. The USE device is closed when the STATUS command concludes.
The STATUS command displays recovery information about a specified file or about all the files opened during the run.
One or two lines of information are listed for each file, in the form: 
filename: current-status
RESTART-status


Where:
<table>
<tr>
<th>current-status</th>
<td> indicates special conditions that can affect discontinuities and future recovery of the file. current-status values are shown in the table below.
<table>
<caption>STATUS command current
status conditions </caption>

<tr> <th>
Value
</th> <th>
The file is...
</th> </tr>

<tr> <th><var>
CLOSED
</var></th> <td>
Not currently open by any user.
</td> </tr>

<tr> <th><var>
DEFERRED
</var></th> <td>
In deferred update mode in the current run and will not be closed until the end of the run.
</td> </tr>

<tr> <th><var>
ENQUEUED
</var></th> <td>
Enqueued with either share or exclusive status. If CLOSED also appears, the file is enqueued in share status to prevent discontinuities.
</td> </tr>

<tr> <th><var>
OPEN
</var></th> <td>
Currently open by one or more users (or the file is in deferred update mode).
</td> </tr>

<tr> <th><var>
UPDATED
</var></th> <td>
Up-to-date since the beginning of the run. If ENQUEUED or OPEN is not also shown, a discontinuity can be produced by another updating <var class="product">Model 204</var> job. 
</td> </tr>

</table>
</td>
</tr>

<tr>
<th><var>RESTART-status</var></th>
<td> appears only for a file that participated in recovery in the current run. The values of RESTART-status are shown in the following table. The checkpoint facility is detailed in the <var>Model 204 System Manager's Guide</var>
<table>
<caption>STATUS command RESTART status </caption>

<tr> <th>
Value
</th> <th>
Meaning
</th> </tr>

<tr> <th><var>
BEING RECOVERED
</var></th> <td>
The file is in the process of being recovered when the STATUS command is issued. The file cannot be opened until the RESTART command finishes.
</td> </tr>

<tr> <th><var>
NOT RECOVERED
</var></th> <td>
Reason, where reason is one of the following:
DEFERRED UPDATE CHKP MISSING The scan of the deferred update data set did not locate the checkpoint being used for rollback.
DEFERRED UPDATE READ ERROR The scan of the deferred update data set could not be completed because of a read error.
DEFERRED UPDATES MISSING The deferred update data set could not be opened.
MISSING The file could not be opened.
OBSOLETE The file was updated by a <var class="product">Model 204</var> job after the last update in the run being recovered. 
ROLLED BACK TO CHECKPOINT OF yy.ddd hh:mm:ss.th. The file was rolled back to the checkpoint that was taken at the given date and time. The file was not rolled forward. 
ROLLED BACK TO DISCONTINUITY yy.ddd hh:mm:ss.th. The file was rolled back to a discontinuity that occurred at the given date and time. The file was not rolled forward. 
ROLLED FORWARD TO UPDATE ID n OF yy.ddd hh:mm:ss.th. The file was first rolled back and then rolled forward. The last update unit reapplied by ROLL FORWARD had the given ID. 
</td> </tr>

</table>
</td>
</tr>

</table>
When running Parallel Query Option/204 for client users with open remote files, the display includes the following information: 
filename: status (REMOTE FILE), LOCATION: name1 ONLINE: name2

where: 
<ul>
<li>
filename is the actual (non-synonym) name of the remote file.
</li>

<li>
status is one of the values shown in #STATUSLISTINGFILERECOVERYINFORMATIO-839B33FF/M204_REF_STATUSLISTRECOVERY_TABLE1
Note: Parallel Query Option status shows only the open files that are being run locally, not remote files.
</li>

<li>
name1 is the symbolic name of the file's remote location as specified in the DESTINATION parameter of a local DEFINE PROCESS command. 
</li>

<li>
name2 is the value of the CCAIN parameter LOCATION in the server Online. 
</li>
</ul>
[[Category: System administrator commands]]
[[Category: System manager commands]]
[[Category: General user commands]]
[[Category:Commands]]

STATUS command: Listing file recovery information - Revision history

ELowell at 16:16, 22 March 2017

JAL: remove Sys Man guide

JAL: /* Usage notes */

JAL: /* Usage notes */

Alex: Automatically generated page update