ibm-information-center/dist/eclipse/plugins/i5OS.ic.ddp_5.4.0.1/rbal1dcoll.htm

117 lines
8.0 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="Drop a collection from a distributed relational database" />
<meta name="abstract" content="Attempting to delete a collection that contains journal receivers might cause an inquiry message to be sent to the QSYSOPR message queue for the application server (AS) job. The AS and application requester (AR) job wait until this inquiry is answered." />
<meta name="description" content="Attempting to delete a collection that contains journal receivers might cause an inquiry message to be sent to the QSYSOPR message queue for the application server (AS) job. The AS and application requester (AR) job wait until this inquiry is answered." />
<meta name="DC.subject" content="hung job, dropping a collection, SBMRMTCMD (Submit Remote Command) command, Submit Remote Command (SBMRMTCMD) command, command, CL, SBMRMTCMD (Submit Remote Command), Submit Remote Command (SBMRMTCMD), remote command, submitting, remote command" />
<meta name="keywords" content="hung job, dropping a collection, SBMRMTCMD (Submit Remote Command) command, Submit Remote Command (SBMRMTCMD) command, command, CL, SBMRMTCMD (Submit Remote Command), Submit Remote Command (SBMRMTCMD), remote command, submitting, remote command" />
<meta name="DC.Relation" scheme="URI" content="rbal1admin.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/addrpyle.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgjobd.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgjrn.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/crtjrnrcv.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzaki/rzakikickoff.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/movobj.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/sbmrmtcmd.htm" />
<meta name="DC.Relation" scheme="URI" content="../rzaks/rzaksdailyworkmanage.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="rbal1dcoll" />
<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>Drop a collection from a distributed relational database</title>
</head>
<body id="rbal1dcoll"><a name="rbal1dcoll"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Drop a collection from a distributed relational database</h1>
<div><p>Attempting to delete a collection that contains journal receivers
might cause an inquiry message to be sent to the QSYSOPR message queue for
the application server (AS) job. The AS and application requester (AR) job
wait until this inquiry is answered.</p>
<div class="section"><p>The message that appears on the message queue is: </p>
<dl><dt class="dlterm">CPA7025</dt>
<dd>Receiver (<em>name</em>) in (<em>library</em>) never fully saved. (I C)</dd>
</dl>
</div>
<div class="section"><p>When the AR job is waiting, it might appear as if the application
is hung. Consider the following items when your AR job has been waiting for
a time longer than anticipated:</p>
<ul><li>Be aware that an inquiry message is sent to QSYSOPR message queue and
needs an answer to proceed.</li>
<li>Have the AS reply to the message using its server reply list.</li>
</ul>
</div>
<div class="section"><div class="note"><span class="notetitle">Note:</span> Once the application is in this apparent 'hung' state, the
application requesting job will wait until the inquiry message
on the server has been answered. This is because journal receivers cannot
be moved to another library by using the <span class="cmdname">Move Object (MOVOBJ)</span> command.
They also cannot be saved and restored to different libraries. All you can
do is create a new journal receiver in a different library, using the <span class="cmdname">Create
Journal Receiver (CRTJRNRCV)</span> command, and attach it to the journal,
using the <span class="cmdname">Change Journal (CHGJRN)</span> command. Any new journal
receivers that are created by the system, using the <span class="cmdname">Change Journal
(CHGJRN)</span> command with the JRNRCV(*GEN) parameter, will be created
in the new library. If, when the journal is saved, the attached receiver is
in another library, then when the saved version of the journal is restored,
the new journal receivers will also be created in the other library. </div>
</div>
<div class="section"><p>Having the AS reply to the message using its server reply list
can be accomplished by changing the job that appears to be currently hung,
or by changing the job description for all AS jobs running on the server.
However, you must first add an entry to the AS reply list for message CPA7025
using the <span class="cmdname">Add Reply List Entry (ADDRPYLE)</span> command: </p>
<pre>ADDRPYLE SEQNBR(...) MSGID(CPA7025) RPY(I)</pre>
</div>
<div class="section"><p>To change the job description for the job that is currently running
on the AS, use the <span class="cmdname">Submit Remote Command (SBMRMTCMD)</span> command.
The following example shows how the database administrator on one server in
the Kansas City region changes the job description on the KC105 system (the
server addressed by the TEST/KC105TST DDM file): </p>
<pre>SBMRMTCMD CMD('CHGJOB JOB(KC105ASJOB) INQMSGRPY(*SYSRPYL)')
DDMFILE(TEST/KC105TST)</pre>
</div>
<div class="section"><p>You can prevent this situation from happening on the AS more permanently
by using the <span class="cmdname">Change Job Description (CHGJOBD)</span> command so
that any job that uses that job description uses the server reply list. The
following example shows how this command is entered on the same AS: </p>
<pre>CHGJOBD JOBD(KC105ASJOB) INQMSGRPY(*SYSRPYL)</pre>
</div>
<div class="section"><p>This method should be used with caution. Adding CPA7025 to the
server reply list affects all jobs which use the server reply list. Also changing
the job description affects all jobs that use a particular job description.
You might want to create a separate job description for AS jobs. </p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal1admin.htm" title="As an administrator for a distributed relational database, you are responsible for work being done on several servers.">Administration</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="../rzaki/rzakikickoff.htm">Journal management</a></div>
<div><a href="../rzaks/rzaksdailyworkmanage.htm">Manage work</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="../cl/addrpyle.htm">Add Reply List Entry (ADDRPYLE) command</a></div>
<div><a href="../cl/chgjobd.htm">Change Job Description (CHGJOBD) command</a></div>
<div><a href="../cl/chgjrn.htm">Change Journal (CHGJRN) command</a></div>
<div><a href="../cl/crtjrnrcv.htm">Create Journal Receiver (CRTJRNRCV) command</a></div>
<div><a href="../cl/movobj.htm">Move Object (MOVOBJ) command</a></div>
<div><a href="../cl/sbmrmtcmd.htm">Submit Remote Command (SBMRMTCMD) command</a></div>
</div>
</div>
</body>
</html>