OFFLOAD command: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
|||
| Line 1: | Line 1: | ||
==Summary== | ==Summary== | ||
<dl> | <dl> | ||
| Line 12: | Line 10: | ||
</p> | </p> | ||
< | Where <var class="term">streamname</var> specifies the name of the ring stream to be offloaded. | ||
==Usage notes== | ==Usage notes== | ||
< | <ul> | ||
< | <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> | ||
< | |||
< | <li><var>OFFLOAD</var> causes <var class="product">Model 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: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.