ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaha_5.4.0.1/sqljrplc.htm

95 lines
5.9 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="SQLJ.REPLACE_JAR" />
<meta name="abstract" content="" />
<meta name="description" content="" />
<meta name="DC.Relation" scheme="URI" content="sqljjar.htm" />
<meta name="DC.Relation" scheme="URI" content="sqljinst.htm" />
<meta name="DC.Relation" scheme="URI" content="sqljremv.htm" />
<meta name="DC.Relation" scheme="URI" content="sqljupdt.htm" />
<meta name="DC.Relation" scheme="URI" content="sqljrcvr.htm" />
<meta name="DC.Relation" scheme="URI" content="sqljrfc.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="sqljrplc" />
<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>SQLJ.REPLACE_JAR</title>
</head>
<body id="sqljrplc"><a name="sqljrplc"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SQLJ.REPLACE_JAR</h1>
<div><p></p>
<div class="section"><p> The SQLJ.REPLACE_JAR stored procedure replaces a JAR file into
the database system.</p>
</div>
<div class="section"><h4 class="sectiontitle">Authorization</h4><p>The privilege held by the authorization
ID of the CALL statement must include at least one of the following for the
SYSJAROBJECTS and SYSJARCONTENTS catalog tables:</p>
<ul><li>The following system authorities: <ul><li>The SELECT, INSERT, and DELETE privileges on the table</li>
<li>The system authority *EXECUTE on library QSYS2</li>
</ul>
</li>
<li>Administrative authority</li>
</ul>
<p>The privilege held by the authorization ID of the CALL statement must
also have the following authorities:</p>
<ul><li>Read (*R) access to the JAR file specified by the <em>jar-url</em> parameter
being installed.</li>
<li>*OBJMGT authority to the JAR file being removed. The JAR file is named
/QIBM/UserData/OS400/SQLLib/Function/jar/schema/jarfile.</li>
</ul>
<p>Adopted authority cannot be used for these authorities.</p>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4><pre> &gt;&gt;-CALL--SQLJ.REPLACE_JAR--(--<em>'jar-url'</em>--<em>,</em>--<em>'jar-id'</em>--)--------&gt;&lt;</pre>
</div>
<div class="section"><h4 class="sectiontitle">Description</h4><dl><dt class="dlterm"><strong><em>jar-url</em></strong></dt>
<dd>The URL containing the JAR file to be replaced. The only URL scheme supported
is 'file:'.</dd>
</dl>
<dl><dt class="dlterm"><strong><em>jar-id</em></strong></dt>
<dd>The JAR identifier in the database to be associated with the file specified
by the <em>jar-url</em>. The <em>jar-id</em> uses SQL naming and the JAR file
is installed in the schema or library specified by the implicit or explicit
qualifier.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Usage notes</h4><p>The SQLJ.REPLACE_JAR stored procedure
replaces a JAR file that was previously installed in the database using SQLJ.INSTALL_JAR.</p>
</div>
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following command is issued
from an SQL interactive session:</p>
<pre> CALL SQLJ.REPLACE_JAR('file:/home/db2inst/classes/Proc.jar' , 'myproc_jar')</pre>
<p>The
current JAR file referred to by the <em>jar-id</em> myproc_jar is replaced with
the Proc.jar file located in the file:/home/db2inst/classes/ directory. </p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="sqljjar.htm" title="Both Java stored procedures and Java UDFs can use Java classes that are stored in Java JAR files.">SQLJ procedures that manipulate JAR files</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="sqljinst.htm" title="The SQLJ.INSTALL_JAR stored procedure installs a JAR file into the database system. This JAR file can be used in subsequent CREATE FUNCTION and CREATE PROCEDURE statements.">SQLJ.INSTALL_JAR</a></div>
<div><a href="sqljremv.htm" title="The SQLJ.REMOVE_JAR stored procedure removes a JAR file from the database system.">SQLJ.REMOVE_JAR</a></div>
<div><a href="sqljupdt.htm" title="The SQLJ.UPDATEJARINFO updates the CLASS_SOURCE column of the SYSJARCONTENTS catalog table. This procedure is not part of the SQLJ standard but is used by the DB2 UDB for iSeries stored procedure builder.">SQLJ.UPDATEJARINFO</a></div>
<div><a href="sqljrcvr.htm" title="The SQLJ.RECOVERJAR procedure takes the JAR file that is stored in the SYSJAROBJECTS catalog and restores it to the /QIBM/UserData/OS400/SQLLib/Function/jar/jarschema/jar_id.jar file.">SQLJ.RECOVERJAR</a></div>
<div><a href="sqljrfc.htm" title="The SQLJ.REFRESH_CLASSES stored procedure causes the reloading of user defined classes used by Java stored procedures or Java UDFs in the current database connection. This stored procedure must be called by existing database connections to obtain changes made by a call to the SQLJ.REPLACE_JAR stored procedure.">SQLJ.REFRESH_CLASSES</a></div>
</div>
</div>
</body>
</html>