<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation"> <title>Change Server Job (QGYCHGSJ) API</title> <!-- Begin Header Records ========================================= --> <!-- 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. --> <!-- QEARMVBM SCRIPT A converted by B2H R4.1 (346) (CMS) by KENTALA --> <!-- at RCHVMW2 on 6 Oct 1998 at 19:53:10 --> <!-- Change History: --> <!-- YYMMDD USERID Change description --> <!-- File cleanup completed on 5 July 2001 --> <!-- End Header Records --> <link rel="stylesheet" type="text/css" href="../rzahg/ic.css"> </head> <body> <a name="Top_Of_Page"></a> <!-- Java sync-link --> <script type="text/javascript" language="Javascript" src="../rzahg/synch.js"> </script> <h2>Change Server Job (QGYCHGSJ) API</h2> <div class="box" style="width: 70%;"> <br> Required Parameter Group:<br> <!-- iddvc RMBR --> <br> <table width="100%"> <tr> <td align="center" valign="top" width="10%">1</td> <td align="left" valign="top" width="50%">Number of auxiliary server jobs allowed</td> <td align="left" valign="top" width="20%">Input</td> <td align="left" valign="top" width="20%">Binary(4)</td> </tr> <tr> <td align="center" valign="top">2</td> <td align="left" valign="top">Error code</td> <td align="left" valign="top">I/O</td> <td align="left" valign="top">Char(*)</td> </tr> </table> <br> Default Public Authority: *USE<br> <!-- iddvc RMBR --> <br> Threadsafe: No<br> <!-- iddvc RMBR --> <br> </div> <p>The Change Server Job (QGYCHGSJ) API sets the maximum number of auxiliary server jobs allowed for a server job on the iSeries server. At least one auxiliary server job is allowed; up to five auxiliary server jobs may be allowed. An <strong>auxiliary server job</strong> is used to do work asynchronously from the job that started the auxiliary server job. For example, the auxiliary server job is used to complete building lists of information. All auxiliary server jobs end automatically when the submitting job ends.</p> <p>The Retrieve Server Job Information (QGYRTVSJ) API can be called to retrieve the number of active auxiliary server jobs, the number of auxiliary server jobs allowed, and the job names for each active auxiliary server job.</p> <br> <!-- Please NOTE: DO NOT DELETE THIS SECTION if this API has no authorities and locks. --> <!-- Instead, use the commented out coding below to indicate NONE. --> <h3>Authorities and Locks</h3> <!-- Use this if there are no authorities and locks. --> <p>None.</p> <br> <h3>Required Parameter Group</h3> <dl> <dt><strong>Number of auxiliary server jobs allowed</strong></dt> <dd>INPUT; BINARY(4) <p>The number of auxiliary server jobs that may be started for the current server job. If the number specified is less than the number that is currently allowed, no change will be made. No more than five auxiliary server jobs may be allowed.</p> </dd> <dt><strong>Error code</strong></dt> <dd>I/O; CHAR(*) <p>The structure in which to return error information. For the format of the structure, see <a href="../apiref/error.htm#hdrerrcod">Error Code Parameter</a>.</p> </dd> </dl> <br> <h3>Error Messages</h3> <table width="100%" cellpadding="5"> <!-- cols="15 85" --> <tr> <th align="left" valign="top" nowrap>Message ID</th> <th align="left" valign="top">Error Message Text</th> </tr> <tr> <td align="left" valign="top">CPF24B4 E</td> <td align="left" valign="top">Severe error while addressing parameter list.</td> </tr> <tr> <td align="left" valign="top">CPF3C90 E</td> <td align="left" valign="top">Literal value cannot be changed.</td> </tr> <tr> <td align="left" valign="top">CPF3CF1 E</td> <td align="left" valign="top">Error code parameter not valid.</td> </tr> <tr> <td align="left" valign="top">CPF9872 E</td> <td align="left" valign="top">Program or service program &1 in library &2 ended. Reason code &3.</td> </tr> <tr> <td align="left" valign="top">GUI0113 E</td> <td align="left" valign="top">Number of auxiliary server jobs, &1, not valid.</td> </tr> </table> <br> <hr> API introduced: V3R6 <hr> <center> <table cellpadding="2" cellspacing="2"> <tr align="center"> <td valign="middle" align="center"><a href="#Top_Of_Page">Top</a> | <a href="aplist.htm">APIs by category</a></td> </tr> </table> </center> </body> </html>