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

120 lines
4.4 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>Set step using JS (SETSTPJS)</title>
</head>
<body bgcolor="white">
<a name="SETSTPJS.Top_Of_Page"></a>
<h2>Set step using JS (SETSTPJS)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#SETSTPJS.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SETSTPJS.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SETSTPJS.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SETSTPJS"></a>
<p>The Set Step using Job Scheduler (SETSTPJS) command display allows you to label steps in your application for logging purposes. For example, you may wish to set a step in your program at the start of a backup or when a backup completes. You can label the step "Backup beginning" or "Backup complete" and set LOG to *YES. This will output the text to the JS log once the step is reached.
</p>
<p>If you want to see your steps for an application, you can view them in three places. These include:
</p>
<dl>
<dt><b>Advanced Job Scheduler for Wireless</b></dt>
<dd>Steps are displayed in the details for an active job. From the Advanced Job Scheduler for Wireless Main Menu, select Jobs, then Active, and then the job whose steps you want to view. Select Details from the job options list. The details for the job are displayed. The step text is displayed next to Step.
</dd>
<dt><b>DSPJOBJS</b></dt>
<dd>From the DSPJOBJS command, key option 5 next to the job whose steps you want to view. The details for the job are displayed. The step text is displayed next to Step.
</dd>
<dt><b>iSeries Navigator</b></dt>
<dd>The step information for a job is displayed in the Job Properties dialog box. Right-click on a job and select Properties. Go to the Last Run tab. The step information is displayed next to Command step. This information also applies to Scheduled Job Activity.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETSTPJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETSTPJS.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="#SETSTPJS.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#SETSTPJS.LOG"><b>LOG</b></a></td>
<td valign="top">Log</td>
<td valign="top">*YES, <b><u>*NO</u></b></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SETSTPJS.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SETSTPJS.TEXT"></a>
<h3>Text (TEXT)</h3>
<p>Specifies a text description for the step. This will also be sent to the Job Scheduler (JS) log if *YES if specified for the <b>Log</b> parameter.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is no text associated with this step.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the text for the step. This text will also be displayed in the JS log, if the step is logged.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETSTPJS.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETSTPJS.LOG"></a>
<h3>Log (LOG)</h3>
<p>Specifies if you want to send the step text to the Job Scheduler log.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>You do not want to log the step.
</dd>
<dt><b>*YES</b></dt>
<dd>You do want to log the step.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETSTPJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETSTPJS.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#SETSTPJS.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETSTPJS.ERROR.MESSAGES">Error messages</a></h3>Unknown
</div>
<table width="100%">
<tr><td align="right"><a href="#SETSTPJS.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>