<!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 Configuration Description (QDCCCFGD) 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. --> <!-- Cnfg1 SCRIPT J converted by B2H R4.1 (346) (CMS) by V2KEA304 --> <!-- at RCHVMW2 on 12 May 1999 at 12:05:09 --> <!-- Change History: --> <!-- YYMMDD USERID Change description --> <!--File cleanup completed Sept 2001 by v2cdijab --> <!-- Updates from System API Programming book phase-out, July 2002 by JET --> <!--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 Configuration Description (QDCCCFGD) API</h2> <div class="box" style="width: 70%;"> 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%">Configuration description name</td> <td align="left" valign="top" width="20%">Input</td> <td align="left" valign="top" width="20%">Char(10)</td> </tr> <tr> <td align="center" valign="top">2</td> <td align="left" valign="top">Configuration description type</td> <td align="left" valign="top">Input</td> <td align="left" valign="top">Char(10)</td> </tr> <tr> <td align="center" valign="top">3</td> <td align="left" valign="top">Changes</td> <td align="left" valign="top">Input</td> <td align="left" valign="top">Char(*)</td> </tr> <tr> <td align="center" valign="top">4</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 Configuration Object (QDCCCFGD) API changes the value of one or more parameters in an existing configuration description. This API is intended for applications using new configuration capabilities not yet available through CL commands. </p> <br> <h3>Authorities and Locks</h3> <dl> <dt><em>Configuration description authority</em></dt> <dd>*CHANGE</dd> </dl> <br> <h3>Required Parameter Group</h3> <dl> <dt><strong>Configuration description name</strong></dt> <dd>INPUT; CHAR(10) <p>The name of the configuration description being changed. This parameter must be in uppercase.</p> </dd> <dt><strong>Configuration description type</strong></dt> <dd>INPUT; CHAR(10) <p>The type of configuration description being changed. Possible values for this parameter are:</p> <table cellpadding="5"> <!-- cols="15 85" --> <tr> <td align="left" valign="top"><em>*CFGL</em></td> <td align="left" valign="top">Configuration list</td> </tr> <tr> <td align="left" valign="top"><em>*CNNL</em></td> <td align="left" valign="top">Connection list</td> </tr> <tr> <td align="left" valign="top"><em>*COSD</em></td> <td align="left" valign="top">Class of service description</td> </tr> <tr> <td align="left" valign="top"><em>*CTLD</em></td> <td align="left" valign="top">Controller description</td> </tr> <tr> <td align="left" valign="top"><em>*DEVD</em></td> <td align="left" valign="top">Device description</td> </tr> <tr> <td align="left" valign="top"><em>*IPXD</em></td> <td align="left" valign="top">IPX description</td> </tr> <tr> <td align="left" valign="top"><em>*LIND</em></td> <td align="left" valign="top">Line description</td> </tr> <tr> <td align="left" valign="top"><em>*MODD</em></td> <td align="left" valign="top">Mode description</td> </tr> <tr> <td align="left" valign="top"><em>*NTBD</em></td> <td align="left" valign="top">NetBIOS description</td> </tr> <tr> <td align="left" valign="top"><em>*NWID</em></td> <td align="left" valign="top">Network interface</td> </tr> <tr> <td align="left" valign="top"><em>*NWSD</em></td> <td align="left" valign="top">Network server description</td> </tr> </table> <br> </dd> <dt><strong>Changes</strong></dt> <dd>INPUT; CHAR(*) <p>The changes to be made to the specified configuration description. The information must be in the following format:</p> <dl> <dt><em>Number of variable length records</em></dt> <dd>BINARY(4)<br> The total number of all of the variable length records.<br> </dd> <dt><em>Variable length records</em></dt> <dd>Each variable length record contains a keyword plus its associated new value. Refer to <a href="#HDRFVLR">Format for Variable Length Record</a> for the format of this field.</dd> </dl> <br> </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><a name="HDRFVLR">Format for Variable Length Record</a></h3> <p>The following table shows the format for the variable length record. For a detailed description of each field, see <a href="#HDRQW1">Field Descriptions</a>.</p> <table border width="80%"> <tr> <th align="center" valign="bottom" colspan="2">Offset</th> <th align="left" valign="bottom" rowspan="2">Type</th> <th align="left" valign="bottom" rowspan="2">Field</th> </tr> <tr> <th align="center" valign="bottom">Dec</th> <th align="center" valign="bottom">Hex</th> </tr> <tr> <td align="center" valign="top" width="10%">0</td> <td align="center" valign="top" width="10%">0</td> <td align="left" valign="top" width="20%">BINARY(4)</td> <td align="left" valign="top" width="60%">Key</td> </tr> <tr> <td align="center" valign="top">4</td> <td align="center" valign="top">4</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Length of new value</td> </tr> <tr> <td align="center" valign="top">8</td> <td align="center" valign="top">8</td> <td align="left" valign="top">CHAR(*)</td> <td align="left" valign="top">New value</td> </tr> </table> <p>If the length of the new value is longer than the data length of the key field, the data is truncated to the right. No message is issued.</p> <p>If the length of the new value is shorter than the data length of the key field, the data is padded with blanks to the right. No message is issued.</p> <p>It is not an error to specify a key more than once. If duplicate keys are specified, the last specified value for that key is used.</p> <br> <h3><a name="HDRQW1">Field Descriptions</a></h3> <p><strong>Key.</strong> The keyword parameter of the configuration description to be changed. Only specific keywords can be changed. The following table lists the valid key for the key-field area of the variable length record:</p> <table border width="80%"> <tr> <th align="left" valign="top">Key</th> <th align="left" valign="top">Value</th> <th align="left" valign="top">CFGD type</th> <th align="left" valign="top">CFGD keyword</th> </tr> <tr> <td align="left" valign="top">201</td> <td align="left" valign="top">CHAR(5000)</td> <td align="left" valign="top">*DEVD</td> <td align="left" valign="top">USRDFNDTA</td> </tr> </table> <p><strong>Length of new value.</strong> The length of the new value to be assigned to the keyword.</p> <p><strong>New value.</strong> The value to which a specific keyword is to be set.</p> <br> <h3>Validation of New Values</h3> <p>Inclusion of any keyword parameter and its accompanying values in this API implies that the parsing of the value is supported in this API at a level equivalent to that provided by a Change (CHG) command that supports the same keyword.</p> <p>In addition to the CPF26C9 escape message signaled to the caller, one or more CPD messages are placed on the caller's job log by the API to more fully describe the syntax error found while parsing the new value.</p> <br> <h3>Error Messages</h3> <table width="100%" cellpadding="5"> <tr> <th align="left" valign="top">Message ID</th> <th align="left" valign="top">Error Message Text</th> </tr> <tr> <td align="left" valign="top" width="15%">CPF24B4 E</td> <td align="left" valign="top" width="85%">Severe error while addressing parameter list.</td> </tr> <tr> <td align="left" valign="top">CPF26A8 E</td> <td align="left" valign="top">Configuration description type not valid for this API.</td> </tr> <tr> <td align="left" valign="top">CPF26C7 E</td> <td align="left" valign="top">Key not valid.</td> </tr> <tr> <td align="left" valign="top">CPF26C9 E</td> <td align="left" valign="top">New value not valid.</td> </tr> <tr> <td align="left" valign="top">CPF260A E</td> <td align="left" valign="top">Mode description not found.</td> </tr> <tr> <td align="left" valign="top">CPF260F E</td> <td align="left" valign="top">Configuration list not found.</td> </tr> <tr> <td align="left" valign="top">CPF262C E</td> <td align="left" valign="top">Mode description damaged.</td> </tr> <tr> <td align="left" valign="top">CPF2625 E</td> <td align="left" valign="top">Not able to allocate object &1.</td> </tr> <tr> <td align="left" valign="top">CPF2634 E</td> <td align="left" valign="top">Not authorized to object &1.</td> </tr> <tr> <td align="left" valign="top">CPF266C E</td> <td align="left" valign="top">Connection list not found.</td> </tr> <tr> <td align="left" valign="top">CPF2670 E</td> <td align="left" valign="top">Class of service description not found.</td> </tr> <tr> <td align="left" valign="top">CPF2675 E</td> <td align="left" valign="top">Class of service description damaged.</td> </tr> <tr> <td align="left" valign="top">CPF27A4 E</td> <td align="left" valign="top">Network interface description &1 not found.</td> </tr> <tr> <td align="left" valign="top">CPF2702 E</td> <td align="left" valign="top">Device description &1 not found.</td> </tr> <tr> <td align="left" valign="top">CPF2703 E</td> <td align="left" valign="top">Controller description &1 not found.</td> </tr> <tr> <td align="left" valign="top">CPF2704 E</td> <td align="left" valign="top">Line description &1 not found.</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">CPF3C4D E</td> <td align="left" valign="top">Length &1 for key &2 not valid.</td> </tr> <tr> <td align="left" valign="top">CPF3C88 E</td> <td align="left" valign="top">Number of variable length records &1 is not valid.</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">CPF8FCF E</td> <td align="left" valign="top">IPX description not found.</td> </tr> <tr> <td align="left" valign="top">CPF8F5D E</td> <td align="left" valign="top">NetBIOS description not found.</td> </tr> <tr> <td align="left" valign="top">CPF8104 E</td> <td align="left" valign="top">Controller description &4 damaged.</td> </tr> <tr> <td align="left" valign="top">CPF8105 E</td> <td align="left" valign="top">Device description &4 damaged.</td> </tr> <tr> <td align="left" valign="top">CPF811D E</td> <td align="left" valign="top">Network interface description &4 damaged.</td> </tr> <tr> <td align="left" valign="top">CPF811E E</td> <td align="left" valign="top">Connection list damaged.</td> </tr> <tr> <td align="left" valign="top">CPF8124 E</td> <td align="left" valign="top">Configuration list damaged.</td> </tr> <tr> <td align="left" valign="top">CPF8125 E</td> <td align="left" valign="top">Line description &4 damaged.</td> </tr> <tr> <td align="left" valign="top">CPF814D E</td> <td align="left" valign="top">NetBIOS description &4 damaged.</td> </tr> <tr> <td align="left" valign="top">CPF815C E</td> <td align="left" valign="top">IPX description damaged.</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> </table> <br> <hr> API introduced: V3R7 <hr> <center> <table cellpadding="2" cellspacing="2"> <tr align="center"> <td valign="middle" align="center"> <a href="#Top_Of_Page">Top</a> | <a href="config.htm">Configuration APIs</a> | <a href="aplist.htm">APIs by category</a></td> </tr> </table> </center> </body> </html>