186 lines
12 KiB
HTML
186 lines
12 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html
|
||
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
<html lang="en-us" xml:lang="en-us">
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
<meta name="security" content="public" />
|
||
<meta name="Robots" content="index,follow" />
|
||
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
<meta name="DC.Type" content="concept" />
|
||
<meta name="DC.Title" content="QRWOPTIONS data area" />
|
||
<meta name="abstract" content="When DDM or DRDA TCP/IP server jobs are initiated, they look for a data area in which the user can specify diagnostic and other options. The name is QRWOPTIONS, and it must reside in the QGPL library to take effect. It consists of a string of 48 characters." />
|
||
<meta name="description" content="When DDM or DRDA TCP/IP server jobs are initiated, they look for a data area in which the user can specify diagnostic and other options. The name is QRWOPTIONS, and it must reside in the QGPL library to take effect. It consists of a string of 48 characters." />
|
||
<meta name="DC.subject" content="QRWOPTIONS, data usage" />
|
||
<meta name="keywords" content="QRWOPTIONS, data usage" />
|
||
<meta name="DC.Relation" scheme="URI" content="rbal1stsrvjb.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="rbal1exclcommandtocreate.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="rbal1dhislog.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="rbal1drdmessage.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="rbal1findjl.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="rbal1starttcp.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="../cl/chgqrya.htm" />
|
||
<meta name="DC.Relation" scheme="URI" content="../cl/wrkjob.htm" />
|
||
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
|
||
<meta name="DC.Format" content="XHTML" />
|
||
<meta name="DC.Identifier" content="rbal1qrwoptions" />
|
||
<meta name="DC.Language" content="en-us" />
|
||
<!-- 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. -->
|
||
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
<title>QRWOPTIONS data area</title>
|
||
</head>
|
||
<body id="rbal1qrwoptions"><a name="rbal1qrwoptions"><!-- --></a>
|
||
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
<h1 class="topictitle1">QRWOPTIONS data area</h1>
|
||
<div><p>When DDM or DRDA<sup>®</sup> TCP/IP server jobs are initiated, they look for
|
||
a data area in which the user can specify diagnostic and other options. The
|
||
name is QRWOPTIONS, and it must reside in the QGPL library to take effect.
|
||
It consists of a string of 48 characters.</p>
|
||
<div class="note"><span class="notetitle">Note:</span> The information in the data area must be entered in uppercase in CCSID
|
||
37 or 500.</div>
|
||
<p>The format of the data area is as follows:</p>
|
||
<div class="p">
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" width="100%" frame="border" border="1" rules="rows"><caption>Table 1. Data area format</caption><thead align="left"><tr><th valign="top" width="11.6751269035533%" id="d0e49">Columns</th>
|
||
<th valign="top" width="88.3248730964467%" id="d0e51">Contents </th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr><td valign="top" width="11.6751269035533%" headers="d0e49 "> 1-15 </td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">Client IP address in dotted decimal format for use when I is specified
|
||
as a switch value (ignored otherwise).</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">16</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">Reserved area ignored by server (can contain a character for human
|
||
usability)</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">17–26</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">User profile name for comparison when U is specified as a switch value
|
||
(ignored otherwise)</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">27</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">Switch to cause job log to be kept if set to A, I or U (see notes 1
|
||
and 2)</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">28</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">Switch to cause DSPJOB output to be printed if set to
|
||
A, I or U (see notes 1 and 2)</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">29</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">Switch to cause job to be traced if set to A, I or U
|
||
(see notes 1 and 2).</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">30</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 "> Switch to cause debug to be started for job if set
|
||
to A, I or U (see note 1).</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">31</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">Switch to invoke the <span class="cmdname">Change Query Attributes
|
||
(CHGQRYA)</span> command with a QRYOPTLIB value if set to A, I or U. The
|
||
QRYOPTLIB value is extracted from columns 39-48 which must contain the name
|
||
of the library containing the proper QAQQINI file (see Note 1) <div class="p"><div class="note"><span class="notetitle">Note:</span> </div>
|
||
If
|
||
an I or A is specified in this column, QUSER must have *JOBCTL special authority
|
||
for it to take effect.</div>
|
||
</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">32</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 "> Switch to shadow client debug options if set to A,
|
||
I or U (see note 1).</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">33</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 "> Switch to use old TRCJOB instead of new STRTRC for
|
||
job trace if set to T and column 29 requests tracing. <div class="p"><div class="note"><span class="notetitle">Note:</span> </div>
|
||
If
|
||
this column is set to T, TRCJOB will be used for the job trace. Set it to
|
||
blank or S to use STRTRC.</div>
|
||
</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">34</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">Set this to N to suppress CPI3E34 messages in the history
|
||
log (This is available in OS/400<sup>®</sup> V5R1 only with PTF SI02613)</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">35</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">Switch to start special subroutine trace if set to A,
|
||
I, or U (see notes 1 and 2). </td>
|
||
</tr>
|
||
<tr valign="middle"><td valign="middle" width="11.6751269035533%" headers="d0e49 ">36–38</td>
|
||
<td valign="middle" width="88.3248730964467%" headers="d0e51 ">Reserved</td>
|
||
</tr>
|
||
<tr><td valign="top" width="11.6751269035533%" headers="d0e49 ">39–48</td>
|
||
<td valign="top" width="88.3248730964467%" headers="d0e51 ">General data area (contains library name if the <span class="cmdname">Change
|
||
Query Attributes (CHGQRYA)</span> command is triggered by the appropriate
|
||
value in column 31)</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</div>
|
||
<div class="note"><span class="notetitle">Notes:</span> <ol><li>These are the switch values that activate the function corresponding to
|
||
the column in which they appear: <ul><li>A activates the function for all uses of the server job.</li>
|
||
<li>I activates the function if the client IP address specified in columns
|
||
1-15 matches that used on the connect attempt.</li>
|
||
<li>U activates the function if the user ID specified in columns 17-26 matches
|
||
that used on the connect attempt.</li>
|
||
</ul>
|
||
</li>
|
||
<li>To find the spooled files resulting from this function, use <span class="cmdname">Work
|
||
with Job command (WRKJOB user-profile/QPRTJOB)</span>, where user-profile
|
||
is the user ID used on the connect request. Take option 4 and you should see
|
||
one or more of these files.
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 2. File list from WRKJOB user-profile/QPRTJOB
|
||
command</caption><thead align="left"><tr><th valign="top" id="d0e164">File</th>
|
||
<th valign="top" id="d0e166">Device or queue</th>
|
||
<th valign="top" id="d0e168">User data</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr><td valign="top" headers="d0e164 ">QPJOBLOG</td>
|
||
<td valign="top" headers="d0e166 ">QEZJOBLOG</td>
|
||
<td valign="top" headers="d0e168 ">QRWTSRVR</td>
|
||
</tr>
|
||
<tr><td valign="top" headers="d0e164 ">QPDSPJOB </td>
|
||
<td valign="top" headers="d0e166 ">PRT01</td>
|
||
<td valign="top" headers="d0e168 "> </td>
|
||
</tr>
|
||
<tr><td valign="top" headers="d0e164 ">QPSRVTRC</td>
|
||
<td valign="top" headers="d0e166 ">PRT01</td>
|
||
<td valign="top" headers="d0e168 "> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li>
|
||
<li>The file containing the special DRDA subroutine trace will be created in
|
||
library QGPL, with a name in this format: QRWDBmmddy, where mm represents
|
||
the month, dd the day, and y the last digit of the year, in which the trace
|
||
was recorded. Not all server programs are traced.</li>
|
||
</ol>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<ul class="ullinks">
|
||
<li class="ulchildlink"><strong><a href="rbal1exclcommandtocreate.htm">Example: CL command to create the data area</a></strong><br />
|
||
This example requests the functions indicated in the table.</li>
|
||
</ul>
|
||
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal1stsrvjb.htm" title="When an application uses Distributed Relational Database Architecture (DRDA), the SQL statements are run in the application server job. Because of this, you might need to start debug or a job trace for the application server job that is running on the i5/OS operating system. The technique for doing this differs based on the use of either Advanced Program-to-Program Communication (APPC) or TCP/IP.">Start a service job to diagnose application server problems</a></div>
|
||
</div>
|
||
<div class="reltasks"><strong>Related tasks</strong><br />
|
||
<div><a href="rbal1dhislog.htm" title="Each time a client user establishes a successful connection with a server job, that job is swapped to run under the profile of that client user.">Display the history log</a></div>
|
||
</div>
|
||
<div class="relref"><strong>Related reference</strong><br />
|
||
<div><a href="rbal1drdmessage.htm" title="If an error message occurs at either an application server (AS) or an application requester (AR), the server message is logged on the job log to indicate the reason for the failure.">Distributed relational database messages</a></div>
|
||
<div><a href="rbal1findjl.htm" title="When the connection ends that is serviced by one of the QRWTSRVR prestart jobs associated with the distributed data management (DDM) TCP/IP server, the prestart job is recycled for use by another connection. When this happens, the job log associated with the ended connection is cleared.">Find job logs from TCP/IP server prestart jobs</a></div>
|
||
<div><a href="rbal1starttcp.htm" title="The DDM TCP/IP server does not use transaction program names (TPNs) as the Advanced Program-to-Program Communication (APPC) server does. However, the use of prestart jobs by the TCP/IP server provides a way to start a service job in that environment.">Service jobs for TCP/IP servers</a></div>
|
||
</div>
|
||
<div class="relinfo"><strong>Related information</strong><br />
|
||
<div><a href="../cl/chgqrya.htm">Change Query Attributes (CHGQRYA) command</a></div>
|
||
<div><a href="../cl/wrkjob.htm">Work with Job (WRKJOB) command</a></div>
|
||
</div>
|
||
</div>
|
||
</body>
|
||
</html> |