ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzajq_5.4.0.1/createqaqqini.htm

78 lines
4.9 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="reference" />
<meta name="DC.Title" content="Creating the QAQQINI query options file" />
<meta name="abstract" content="Each server is shipped with a QAQQINI template file in schema QSYS. The QAQQINI file in QSYS is to be used as a template when creating all user specified QAQQINI files." />
<meta name="description" content="Each server is shipped with a QAQQINI template file in schema QSYS. The QAQQINI file in QSYS is to be used as a template when creating all user specified QAQQINI files." />
<meta name="DC.Relation" scheme="URI" content="qryoptf.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgqrya.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtdupobj.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="createqaqqini" />
<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>Creating the QAQQINI query options file</title>
</head>
<body id="createqaqqini"><a name="createqaqqini"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Creating the QAQQINI query options file</h1>
<div><p>Each server is shipped with a QAQQINI template file in schema QSYS.
The QAQQINI file in QSYS is to be used as a template when creating all user
specified QAQQINI files.</p>
<div class="section"><p>To create your own QAQQINI file, use the <span class="cmdname">Create Duplicate
Object (CRTDUPOBJ)</span> command to create a copy of the QAQQINI file
in the schema that will be specified on the <span class="cmdname">Change Query Attributes
(CHGQRYA)</span> QRYOPTLIB parameter. The file name must remain QAQQINI.
For example: </p>
<pre>CRTDUPOBJ OBJ(QAQQINI)
FROMLIB(QSYS)
OBJTYPE(*FILE)
TOLIB(MYLIB)
DATA(*YES) </pre>
<p>System-supplied triggers are attached
to the QAQQINI file in QSYS therefore it is imperative that the only means
of copying the QAQQINI file is through the CRTDUPOBJ CL command. If another
means is used, such as <span class="cmdname">CPYF</span>, then the triggers
may be corrupted and an error will be signaled that the options file cannot
be retrieved or that the options file cannot be updated.</p>
</div>
<div class="section"><p>Because of the trigger programs attached to the QAQQINI file,
the following CPI321A informational message will be displayed six times in
the job log when the <span class="cmdname">CRTDUPOBJ</span> CL is used to create the
file. This is not an error. It is only an informational message. </p>
</div>
<div class="section"><p>CPI321A Information Message: Trigger QSYS_TRIG_&amp;1___QAQQINI___00000&amp;N
in library &amp;1 was added to file QAQQINI in library &amp;1. The ampersand
variables (&amp;1, &amp;N) are replacement variables that contain either the
library name or a numeric value.</p>
</div>
<div class="section"><div class="note"><span class="notetitle">Note:</span> It is highly recommended that the file QAQQINI, in QSYS, not
be modified. This is the original template that is to be duplicated into QUSRSYS
or a user specified library for use.</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="qryoptf.htm" title="The query options file QAQQINI support provides the ability to dynamically modify or override the environment in which queries are executed through the Change Query Attributes (CHGQRYA) command and the QAQQINI file. The query options file QAQQINI is used to set some attributes used by the database manager.">Control queries dynamically with the query options file QAQQINI</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/crtdupobj.htm">Create Duplicate Object (CRTDUPOBJ) command</a></div>
</div>
</div>
</body>
</html>