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

97 lines
6.5 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="Service jobs for TCP/IP servers" />
<meta name="abstract" content="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." />
<meta name="description" content="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." />
<meta name="DC.subject" content="TCP/IP, service jobs" />
<meta name="keywords" content="TCP/IP, service jobs" />
<meta name="DC.Relation" scheme="URI" content="rbal1stsrvjb.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal1qrwoptions.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/strsrvjob.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/chgpje.htm" />
<meta name="DC.Relation" scheme="URI" content="../cl/dsplog.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="rbal1starttcp" />
<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>Service jobs for TCP/IP servers</title>
</head>
<body id="rbal1starttcp"><a name="rbal1starttcp"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Service jobs for TCP/IP servers</h1>
<div><p>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.</p>
<div class="section"><p>Note, however, that with the introduction of the function associated
with the QRWOPTIONS data area usage, you might not need to start a service
job in many cases. That feature allows one to start traces and do other diagnostic
functions. You might still need to start a service job if you need a trace
of the connection phase of the job. </p>
</div>
<div class="section"><p>You can use the <span class="cmdname">Display Log (DSPLOG)</span> command
to find the CPI3E34 message reporting the name of the server job being used
for a given connection if the following statements are true:</p>
</div>
<div class="section"> <ul><li>You do not need to trace the actions of the server during the connect
operation</li>
<li>You choose not to use the QRWOPTIONS function</li>
<li>You have the ability to delay execution of the application requester (AR)
job until you can do some setup on the server, such as from Interactive SQL</li>
</ul>
</div>
<div class="section"><p>You can then use the <span class="cmdname">Start Service Job (STRSRVJOB)</span> command.</p>
</div>
<div class="section"><p>If you do need to trace the connect statement, or do not have
time to do manual setup on the server after the connection, you will need
to anticipate what prestart job will be used for the connection before it
happens. One way to do that is to prevent other users from connecting during
the time of your test, if possible, and end all of the prestart jobs except
one.</p>
</div>
<div class="section"><p>You can force the number of prestart jobs to be 1 by setting the
following parameters on the <span class="cmdname">Change Prestart Job Entry (CHGPJE)</span> command
for QRWTSRVR running in QSYSWRK to the values specified here: </p>
<ul><li>Initial number of jobs: <strong>1</strong></li>
<li>Threshold: <strong>1</strong></li>
<li>Additional number of jobs: <strong>0</strong></li>
<li>Maximum number of jobs: <strong>1</strong></li>
</ul>
</div>
<div class="section"><p>If you use this technique, be sure to change the parameters back
to values that are reasonable for your environment; otherwise, users will
get the message that <samp class="codeph">'A connection with a remote socket was reset
by that socket'</samp> when trying to connect when the one prestart job
is busy.</p>
</div>
</div>
<div>
<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="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rbal1qrwoptions.htm" title="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.">QRWOPTIONS data area</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../cl/strsrvjob.htm">Start Service Job (STRSRVJOB) command</a></div>
<div><a href="../cl/chgpje.htm">Change Prestart Job Entry (CHGPJE) command</a></div>
<div><a href="../cl/dsplog.htm">Display Log (DSPLOG) command</a></div>
</div>
</div>
</body>
</html>