295 lines
10 KiB
HTML
295 lines
10 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>Start Data Base Reader (STRDBRDR)</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="STRDBRDR.Top_Of_Page"></a>
|
|
<h2>Start Data Base Reader (STRDBRDR)</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="#STRDBRDR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRDBRDR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRDBRDR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRDBRDR"></a>
|
|
<p>The Start Database Reader (STRDBRDR) command starts a spooling reader using a database file; the reader reads a batch input stream from the database and places the jobs onto one or more job queues. This command specifies the name of the database file and member from which the input stream is read, the name of the reader, and the names of the job queue and message queue that are used.
|
|
</p>
|
|
<p>More than one reader can be active at the same time (as determined by the spooled subsystem description). Each database reader must have a unique reader name, and the specified file or member must be available. The reader can also be held or canceled by using the Hold Reader (HLDRDR) command or End Reader (ENDRDR) command.
|
|
</p>
|
|
<p>Because each reader runs independently of the job that started it, the user can continue doing other work on the system after he has started a reader.
|
|
</p>
|
|
<p><b>Restriction:</b> The specified database file either must consist of single-field records and must have an arrival sequence access path, or it must be a standard database source file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRDBRDR.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" rowspan="3"><a href="#STRDBRDR.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Data base file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Data base file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRDBRDR.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRDBRDR.JOBQ"><b>JOBQ</b></a></td>
|
|
<td valign="top">Job queue</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job queue</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QBATCH</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top" rowspan="3"><a href="#STRDBRDR.MSGQ"><b>MSGQ</b></a></td>
|
|
<td valign="top">Queue for reader messages</td>
|
|
<td valign="top">Single values: *REQUESTER<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Queue for reader messages</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QSYSOPR</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRDBRDR.RDR"><b>RDR</b></a></td>
|
|
<td valign="top">Reader</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*FILE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRDBRDR.FILE"></a>
|
|
<h3>Data base file (FILE)</h3>
|
|
<p>Specifies the database file from which the input stream is to be read. The file must be available for allocation to the spooling reader before the reader can be started.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Data base file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the file that contains the input stream read by the reader.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the file.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDBRDR.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the member in the specified file that contains the input stream.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FIRST</u></b></dt>
|
|
<dd>The first member in the file is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the member that contains the input stream to be read.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDBRDR.JOBQ"></a>
|
|
<h3>Job queue (JOBQ)</h3>
|
|
<p>Specifies the job queue where the spooling reader will place entries. This value is used if *RDR is specified on the <b>Job queue (JOBQ)</b> parameter of the Batch Job (BCHJOB) command. (Note that the job queue for each job within this input stream can be different.)
|
|
</p>
|
|
<p><b>Qualifier 1: Job queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QBATCH</u></b></dt>
|
|
<dd>The job entry is placed on the QBATCH job queue.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the job queue to be used by this reader.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the job queue.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the job queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDBRDR.MSGQ"></a>
|
|
<h3>Queue for reader messages (MSGQ)</h3>
|
|
<p>Specifies the message queue that will receive any messages that are created by the reader.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*REQUESTER</b></dt>
|
|
<dd>The messages are to be sent to the workstation message queue of the workstation of the user who started this reader. If this value is used in a batch job, the message is changed to the system operator's message queue (QSYSOPR).
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Queue for reader messages</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QSYSOPR</u></b></dt>
|
|
<dd>The messages are sent to the system operator's message queue (QSYSOPR).
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the message queue that you want to receive any messages.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the message queue. If no current library entry exists in the library list, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library where the message queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRDBRDR.RDR"></a>
|
|
<h3>Reader (RDR)</h3>
|
|
<p>Specifies the reader to be started. Each reader name must be unique.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FILE</u></b></dt>
|
|
<dd>The name of the reader is the same as the name of the database file that is specified on the <b>Data base file (FILE)</b> parameter.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name that identifies the reader to be started.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRDBRDR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
STRDBRDR FILE(QGPL/BILLING)
|
|
</pre>
|
|
</p>
|
|
<p>This command starts a spooled reader that reads its input from the database file named BILLING, which is in the QGPL library. The reader name is also BILLING because the RDR parameter was not specified. The first member in the BILLING file contains the input stream to be processed. The default job queue QBATCH and the system-supplied system operator's message queue QSYSOPR are used by the database reader.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRDBRDR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1338</b></dt>
|
|
<dd>Errors occurred on SBMJOB command.
|
|
</dd>
|
|
<dt><b>CPF2207</b></dt>
|
|
<dd>Not authorized to use object &1 in library &3 type *&2.
|
|
</dd>
|
|
<dt><b>CPF3301</b></dt>
|
|
<dd>Reader &1 already started.
|
|
</dd>
|
|
<dt><b>CPF3307</b></dt>
|
|
<dd>Job queue &1 in &2 not found.
|
|
</dd>
|
|
<dt><b>CPF3330</b></dt>
|
|
<dd>Necessary resource not available.
|
|
</dd>
|
|
<dt><b>CPF3362</b></dt>
|
|
<dd>Objects in QTEMP not valid for parameter values.
|
|
</dd>
|
|
<dt><b>CPF3363</b></dt>
|
|
<dd>Message queue &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF3364</b></dt>
|
|
<dd>File &1 in library &2 not database file or DDM file.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9815</b></dt>
|
|
<dd>Member &5 file &2 in library &3 not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRDBRDR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|