ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/XEZPWROF.htm

133 lines
4.6 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Exit Program for Tailoring Power Off</title>
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Begin Header Records ========================================== -->
<!-- NETMG2 SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
<!-- RCHVMW2 on 29 Jan 1999 at 10:01:37 -->
<!-- File edited Sept 2001 -->
<!--End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<a name="Top_Of_Page"></a>
<!-- Java sync-link -->
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<h2>Exit Program for Tailoring Power Off</h2>
<p>The Power-Off exit program (QEZPWROFFP) is shipped with the system and
stored in the QSYS library. This exit program powers off the system according
to the power on and off schedule by running the Power Down System command
PWRDWNSYS OPTION(*IMMED). (Use the Change Power Schedule Entry (CHGPWRSCDE)
command or the Change Power Schedule (CHGPWRSCD) command to set the power on
and off schedule.)</p>
<p>You can tailor this program to change how you want the system powered off.
For example, you could change the program so that the system would not power
off immediately.</p>
<p>To change this program:</p>
<ol>
<li>Type <samp>RTVCLSRC</samp> (the Retrieve CL Source command) on any command
line and press F4 (Prompt). Type the following values for the prompts:<br>
<br>
<table cellpadding="3">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>Program</em></td>
<td align="left" valign="top">QEZPWROFFP</td>
</tr>
<tr>
<td align="left" valign="top"><em>Library</em></td>
<td align="left" valign="top">QSYS</td>
</tr>
<tr>
<td align="left" valign="top"><em>Source file</em></td>
<td align="left" valign="top">Name of source file</td>
</tr>
<tr>
<td align="left" valign="top"><em>Library</em></td>
<td align="left" valign="top">Name of library</td>
</tr>
</table>
<p>Press the Enter key.</p>
</li>
<li>Change the source to tailor the program. For example, you may want to
specify RESTART(*YES) for the PWRDWNSYS command to cause the system to power on
(IPL) when the power down is complete.<br>
<br>
</li>
<li>When you are finished changing the program, use the Create CL Program
(CRTCLPGM) command and fill in the fields as you did when you retrieved the
program. The program you create must be named QEZPWROFFP.<br>
<br>
</li>
<li>To use the new program, put the new program in a library before the QSYS
library in the system part of the library list as specified in system value
QSYSLIBL.</li>
</ol>
<p><strong>Notes:</strong></p>
<ol>
<li>Remember that this program controls the scheduled powering off of the
system. If you remove the Power Down System (PWRDWNSYS) command, the system
does not automatically power down on schedule. If you change the OPTION
parameter on the PWRDWNSYS command to *CNTRLD, the system may wait the amount
of time specified by the DELAY parameter before it powers off. If the DELAY
parameter is changed to *NOLIMIT, the system may never power off.<br>
<br>
</li>
<li>If your next scheduled power-on time is fairly close to the scheduled
power-off time, and you have long running commands or calls to programs ahead
of the PWRDWNSYS command, your system may not have powered off by the time it
is scheduled to power on again. Before the system is powered down, check the
time of the next scheduled power up using the Retrieve Power Schedule Entry
(RTVPWRSCDE) command. You should also use the Change Power Schedule Entry
(CHGPWRSCDE) command to reset the system value. If it is within 1/2 hour, do
not power off the system; otherwise, your system may not power on again, and
you will need to do a manual IPL.<br>
<br>
</li>
<li>This program will not get called when the current time is less than 30
minutes before the next scheduled power-on time.</li>
</ol>
<hr>
Exit program introduced: V2R1
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href=
"oa1.htm">Operational Assistant APIs</a> | <a href="aplist.htm">APIs by
category</a></td>
</tr>
</table>
</center>
</body>
</html>