OFFLOAD command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
Line 1: Line 1:
<p class="pageSubtitle">Initiating an offload</p>
==Summary==
==Summary==
<dl>
<dl>
Line 12: Line 10:
</p>
</p>
   
   
<b>Where:</b>
Where <var class="term">streamname</var> specifies the name of the ring stream to be offloaded.
streamname specifies the name of the ring stream to be offloaded.
 
==Usage notes==
==Usage notes==
<p>The OFFLOAD command permits the system manager or console operator to manually initiate an offload process at any time during system operation. Members of RING configurations are normally offloaded automatically when the number of full members reaches the threshold set by the AUTOOFFLOAD parameter in the DEFINE STREAM command.</p>
<ul>
<p>OFFLOAD causes <var class="product">Model&nbsp;204</var> to perform the same processing that would occur automatically when the AUTOOFFLOAD threshold is reached. An exception is that the member of the ring being filled when the command is issued is treated as if it had been filled. This is the case even if the member has not reached a file-full condition. Such an action could be desirable if AUTOOFFLOAD is set to a high value and a system shutdown might occur before any offloading is done. OFFLOAD can also be used to control unplanned hardware needs, such as tape drives for offloads.</p>
<li>The <var>OFFLOAD</var> command permits the system manager or console operator to manually initiate an offload process at any time during system operation. Members of RING configurations are normally offloaded automatically when the number of full members reaches the threshold set by the <var>AUTOOFFLOAD</var> parameter in the <var>DEFINE STREAM</var> command.</li>
<p>OFFLOAD is only available for RING output streams. If the RING stream already has an active offload process, the command is ignored.</p>
 
<p>For more information on sequential I/O processing, see [[DEFINE STREAM command]] and the <var class="book">Rocket Model&nbsp;204 System Manager's Guide</var>.</p>
<li><var>OFFLOAD</var> causes <var class="product">Model&nbsp;204</var> to perform the same processing that would occur automatically when the <var>AUTOOFFLOAD</var> threshold is reached. An exception is that the member of the ring being filled when the command is issued is treated as if it had been filled. This is the case even if the member has not reached a file-full condition. Such an action could be desirable if <var>AUTOOFFLOAD</var> is set to a high value and a system shutdown might occur before any offloading is done. <var>OFFLOAD</var> can also be used to control unplanned hardware needs, such as tape drives for offloads.</li>
 
<li><var>OFFLOAD</var> is only available for RING output streams. If the RING stream already has an active offload process, the command is ignored.</li>
 
<li>For more information on sequential I/O processing, see the <var>[[DEFINE STREAM command|DEFINE STREAM]]</var> command and also [[Configuring checkpoint and journal data streams]].</li>
</ul>
 
[[Category: System manager commands]]
[[Category: System manager commands]]
[[Category: Operator commands]]
[[Category:Commands]]
[[Category:Commands]]

Revision as of 18:35, 29 August 2014

Summary

Privileges
System manager, Operator
Function
Manually starts an offload at any time during system operation

Syntax

OFFLOAD STREAM streamname

Where streamname specifies the name of the ring stream to be offloaded.

Usage notes

  • The OFFLOAD command permits the system manager or console operator to manually initiate an offload process at any time during system operation. Members of RING configurations are normally offloaded automatically when the number of full members reaches the threshold set by the AUTOOFFLOAD parameter in the DEFINE STREAM command.
  • OFFLOAD causes Model 204 to perform the same processing that would occur automatically when the AUTOOFFLOAD threshold is reached. An exception is that the member of the ring being filled when the command is issued is treated as if it had been filled. This is the case even if the member has not reached a file-full condition. Such an action could be desirable if AUTOOFFLOAD is set to a high value and a system shutdown might occur before any offloading is done. OFFLOAD can also be used to control unplanned hardware needs, such as tape drives for offloads.
  • OFFLOAD is only available for RING output streams. If the RING stream already has an active offload process, the command is ignored.
  • For more information on sequential I/O processing, see the DEFINE STREAM command and also Configuring checkpoint and journal data streams.