ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/rtvsrvagt.htm

131 lines
4.9 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">
<title>Retrieve Service Agent (RTVSRVAGT)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="RTVSRVAGT.Top_Of_Page"></a>
<h2>Retrieve Service Agent (RTVSRVAGT)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#RTVSRVAGT.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RTVSRVAGT.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RTVSRVAGT.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RTVSRVAGT"></a>
<p>The Retrieve Service Agent (RTVSRVAGT) command allows a user to retrieve information about Service Agent.
</p>
<p>Up to three valid days of the week for which Service Agent automatic processing can occur may be retrieved and placed in specified CL variable(s). The days of the week are valid for the system or logical partition on which the command is used.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RTVSRVAGT.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top"><a href="#RTVSRVAGT.DAY1"><b>DAY1</b></a></td>
<td valign="top">CL variable for day 1</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVSRVAGT.DAY2"><b>DAY2</b></a></td>
<td valign="top">CL variable for day 2</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#RTVSRVAGT.DAY3"><b>DAY3</b></a></td>
<td valign="top">CL variable for day 3</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RTVSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RTVSRVAGT.DAY1"></a>
<h3>CL variable for day 1 (DAY1)</h3>
<p>Specifies the name of the CL variable that receives the first day of the week for which Service Agent automatic processing can occur. The variable must be a character variable with a minimum length of 4 characters.
</p>
<p>The returned day of the week is one of the following special values: *MON, *TUE, *WED, *THU, *FRI, *SAT, or *SUN.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVSRVAGT.DAY2"></a>
<h3>CL variable for day 2 (DAY2)</h3>
<p>Specifies the name of the CL variable that receives the second day of the week for which Service Agent automatic processing can occur. The variable must be a character variable with a minimum length of 4 characters.
</p>
<p>The returned day of the week is one of the following special values: *MON, *TUE, *WED, *THU, *FRI, *SAT, or *SUN.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RTVSRVAGT.DAY3"></a>
<h3>CL variable for day 3 (DAY3)</h3>
<p>Specifies the name of the CL variable that receives the third day of the week for which Service Agent automatic processing can occur. The variable must be a character variable with a minimum length of 4 characters.
</p>
<p>The returned day of the week is one of the following special values: *MON, *TUE, *WED, *THU, *FRI, *SAT, or *SUN.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVSRVAGT.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
DCL &amp;FIRSTDAY TYPE(*CHAR) LEN(4)
DCL &amp;SECONDDAY TYPE(*CHAR) LEN(4)
DCL &amp;THIRDDAY TYPE(*CHAR) LEN(4)
:
RTVSRVAGT DAY1(&amp;FIRSTDAY) DAY2(*SECONDDAY) DAY3(&amp;THIRDDAY)
</pre>
</p>
<p>This command retrieves the three valid days of the Service Agent automatic functions (Auto PTF and Auto test).
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RTVSRVAGT.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF9899</b></dt>
<dd>Error occurred during processing of command.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RTVSRVAGT.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>