297 lines
16 KiB
HTML
297 lines
16 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="task" />
|
|
<meta name="DC.Title" content="Central server" />
|
|
<meta name="abstract" content="Identify exit points for central server." />
|
|
<meta name="description" content="Identify exit points for central server." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaiimst35.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="rzaiimstexcentral" />
|
|
<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>Central server</title>
|
|
</head>
|
|
<body id="rzaiimstexcentral"><a name="rzaiimstexcentral"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Central server</h1>
|
|
<div><p>Identify exit points for central server.</p>
|
|
<div class="section">The central server has three exit points defined:</div>
|
|
<ol><li class="stepexpand"><span>QIBM_QZSC_LM format ZSCL0100</span> <ul><li>Called for license management requests</li>
|
|
</ul>
|
|
</li>
|
|
<li class="stepexpand"><span>QIBM_QZSC_SM format ZSCS0100</span> <ul><li>Called for system management requests</li>
|
|
</ul>
|
|
</li>
|
|
<li class="stepexpand"><span>QIBM_QZSC_NLS format ZSCN0100</span> <ul><li>Called for conversion table requests</li>
|
|
</ul>
|
|
</li>
|
|
</ol>
|
|
<div class="section"><p>The QIBM_QZSC_LM exit point is defined to run an exit program for
|
|
all license management requests received by the central server.</p>
|
|
<p><strong>Exit
|
|
program QIBM_QZSC_LM format ZSCL0100</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" valign="top" id="d0e51">Offset</th>
|
|
<th rowspan="2" valign="top" width="20%" id="d0e53">Type</th>
|
|
<th rowspan="2" valign="top" width="20%" id="d0e55">Field</th>
|
|
<th rowspan="2" valign="top" width="40%" id="d0e57">Description</th>
|
|
</tr>
|
|
<tr><th valign="top" width="10%" id="d0e60">Dec</th>
|
|
<th valign="top" width="10%" id="d0e62">Hex</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="10%" headers="d0e51 d0e60 ">0</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">0</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">CHAR(10)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">User profile name</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">The name of the user profile that is calling the server</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">10</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">A</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">CHAR(10)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">Server identifier</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">For the central server, the value is *CNTRLSRV.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">20</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">14</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">CHAR(8)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">Format name</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">The user exit format name being used. For QIBM_QZSC_LM, the format
|
|
name is ZSCL0100.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">28</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">1C</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">BINARY(4)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">Requested function</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">The function being performed <p>This field contains one of the following:</p>
|
|
<ul><li><span class="uicontrol">X'1001'</span> - Request license</li>
|
|
<li><span class="uicontrol">X'1002'</span> - Release license</li>
|
|
<li><span class="uicontrol">X'1003'</span> - Retrieve license information</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">32</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">20</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">CHAR(255)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">Unique client name</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">The unique client name is used to identify a specific workstation across
|
|
a network. The use of a licensed product is assigned to a workstation identified
|
|
by the unique client name.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">287</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">11F</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">CHAR(8)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">License user handle</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">License user handle is used to ensure that the license requester and
|
|
license releaser are the same. This value must be the same as when the license
|
|
was requested.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">295</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">127</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">CHAR(7)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">Product identification</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">The identification of the product whose licensed use is requested</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">302</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">12E</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">CHAR(4)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">Feature identification</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">The feature of the product</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">306</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">132</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">CHAR(6)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">Release identification</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">The version, release, and modification level of the product or feature</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e51 d0e60 ">312</td>
|
|
<td valign="top" width="10%" headers="d0e51 d0e62 ">138</td>
|
|
<td valign="top" width="20%" headers="d0e53 ">BINARY(2)</td>
|
|
<td valign="top" width="20%" headers="d0e55 ">Type of information</td>
|
|
<td valign="top" width="40%" headers="d0e57 ">The type of information to be retrieved. <p>The type of information
|
|
field is only valid for the retrieve license information function</p>
|
|
<p>This
|
|
field contains one of the following:</p>
|
|
<ul><li><span class="uicontrol">X'0000'</span> - Basic license information</li>
|
|
<li><span class="uicontrol">X'0001'</span> - Detailed license information</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td colspan="5" valign="top" headers="d0e51 d0e53 d0e55 d0e57 d0e60 d0e62 "><div class="note"><span class="notetitle">Note:</span> This format is defined by member
|
|
EZSCEP in files H, QRPGSRC, QRPGLESRC, QLBLSRC and QCBLLESRC in library QSYSINC.</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="rzaiimstexcentral__SPTIDX265"><a name="rzaiimstexcentral__SPTIDX265"><!-- --></a>The QIBM_QZSC_SM exit point is defined to run an
|
|
exit program for all client management requests received by the central server.</p>
|
|
<p><strong>Exit
|
|
program QIBM_QZSC_SM format ZSCS0100</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" valign="top" id="d0e221">Offset</th>
|
|
<th rowspan="2" valign="top" width="20%" id="d0e223">Type</th>
|
|
<th rowspan="2" valign="top" width="20%" id="d0e225">Field</th>
|
|
<th rowspan="2" valign="top" width="40%" id="d0e227">Description</th>
|
|
</tr>
|
|
<tr><th valign="top" width="10%" id="d0e230">Dec</th>
|
|
<th valign="top" width="10%" id="d0e232">Hex</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="10%" headers="d0e221 d0e230 ">0</td>
|
|
<td valign="top" width="10%" headers="d0e221 d0e232 ">0</td>
|
|
<td valign="top" width="20%" headers="d0e223 ">CHAR(10)</td>
|
|
<td valign="top" width="20%" headers="d0e225 ">User profile name</td>
|
|
<td valign="top" width="40%" headers="d0e227 ">The name of the user profile that is calling the server</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e221 d0e230 ">10</td>
|
|
<td valign="top" width="10%" headers="d0e221 d0e232 ">A</td>
|
|
<td valign="top" width="20%" headers="d0e223 ">CHAR(10)</td>
|
|
<td valign="top" width="20%" headers="d0e225 ">Server identifier</td>
|
|
<td valign="top" width="40%" headers="d0e227 ">For the central server, the value is *CNTRLSRV.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e221 d0e230 ">20</td>
|
|
<td valign="top" width="10%" headers="d0e221 d0e232 ">14</td>
|
|
<td valign="top" width="20%" headers="d0e223 ">CHAR(8)</td>
|
|
<td valign="top" width="20%" headers="d0e225 ">Format name</td>
|
|
<td valign="top" width="40%" headers="d0e227 ">The user exit format name being used. For QIBM_QZSC_SM the format name
|
|
is ZSCS0100.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e221 d0e230 ">28</td>
|
|
<td valign="top" width="10%" headers="d0e221 d0e232 ">1C</td>
|
|
<td valign="top" width="20%" headers="d0e223 ">BINARY(4)</td>
|
|
<td valign="top" width="20%" headers="d0e225 ">Requested function</td>
|
|
<td valign="top" width="40%" headers="d0e227 ">The function being performed <p>This field contains one of the following:</p>
|
|
<ul><li><span class="uicontrol">X'1101'</span> - Set client active</li>
|
|
<li><span class="uicontrol">X'1102'</span> - Set client inactive</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e221 d0e230 ">32</td>
|
|
<td valign="top" width="10%" headers="d0e221 d0e232 ">20</td>
|
|
<td valign="top" width="20%" headers="d0e223 ">CHAR(255)</td>
|
|
<td valign="top" width="20%" headers="d0e225 ">Unique client name</td>
|
|
<td valign="top" width="40%" headers="d0e227 ">The client workstation name that is assigned to the licensed product</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e221 d0e230 ">287</td>
|
|
<td valign="top" width="10%" headers="d0e221 d0e232 ">11F</td>
|
|
<td valign="top" width="20%" headers="d0e223 ">CHAR(255)</td>
|
|
<td valign="top" width="20%" headers="d0e225 ">Community name</td>
|
|
<td valign="top" width="40%" headers="d0e227 ">The community name SNMP configuration field is used for authentication.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e221 d0e230 ">542</td>
|
|
<td valign="top" width="10%" headers="d0e221 d0e232 ">21E</td>
|
|
<td valign="top" width="20%" headers="d0e223 ">CHAR(1)</td>
|
|
<td valign="top" width="20%" headers="d0e225 ">Node type</td>
|
|
<td valign="top" width="40%" headers="d0e227 ">The type of connection <ul><li><span class="uicontrol">3</span> - Internet</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e221 d0e230 ">543</td>
|
|
<td valign="top" width="10%" headers="d0e221 d0e232 ">21F</td>
|
|
<td valign="top" width="20%" headers="d0e223 ">CHAR(255)</td>
|
|
<td valign="top" width="20%" headers="d0e225 ">Node name</td>
|
|
<td valign="top" width="40%" headers="d0e227 ">The name of the node <p>For node type 3, the node name will be an Internet
|
|
address.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td colspan="5" valign="top" headers="d0e221 d0e223 d0e225 d0e227 d0e230 d0e232 "><div class="note"><span class="notetitle">Note:</span> This format is defined by member
|
|
EZSCEP in files H, QRPGSRC, QRPGLESRC, QLBLSRC and QCBLLESRC in library QSYSINC.</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="rzaiimstexcentral__SPTIDX266"><a name="rzaiimstexcentral__SPTIDX266"><!-- --></a>The QIBM_QZSC_NLS exit point is defined to run an
|
|
exit program when the central server receives a request to retrieve a conversion
|
|
map.</p>
|
|
<p><strong>Exit program QIBM_QZSC_NLS format ZSCN0100</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" valign="top" id="d0e359">Offset</th>
|
|
<th rowspan="2" valign="top" width="20%" id="d0e361">Type</th>
|
|
<th rowspan="2" valign="top" width="20%" id="d0e363">Field</th>
|
|
<th rowspan="2" valign="top" width="40%" id="d0e365">Description</th>
|
|
</tr>
|
|
<tr><th valign="top" width="10%" id="d0e368">Dec</th>
|
|
<th valign="top" width="10%" id="d0e370">Hex</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="10%" headers="d0e359 d0e368 ">0</td>
|
|
<td valign="top" width="10%" headers="d0e359 d0e370 ">0</td>
|
|
<td valign="top" width="20%" headers="d0e361 ">CHAR(10)</td>
|
|
<td valign="top" width="20%" headers="d0e363 ">User profile name</td>
|
|
<td valign="top" width="40%" headers="d0e365 ">The name of the user profile that is calling the server</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e359 d0e368 ">10</td>
|
|
<td valign="top" width="10%" headers="d0e359 d0e370 ">A</td>
|
|
<td valign="top" width="20%" headers="d0e361 ">CHAR(10)</td>
|
|
<td valign="top" width="20%" headers="d0e363 ">Server identifier</td>
|
|
<td valign="top" width="40%" headers="d0e365 ">For the central server, the value is *CNTRLSRV.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e359 d0e368 ">20</td>
|
|
<td valign="top" width="10%" headers="d0e359 d0e370 ">14</td>
|
|
<td valign="top" width="20%" headers="d0e361 ">CHAR(8)</td>
|
|
<td valign="top" width="20%" headers="d0e363 ">Format name</td>
|
|
<td valign="top" width="40%" headers="d0e365 ">The user exit format name being used. For QIBM_QZSC_NLS, the format
|
|
name is ZSCN0100.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e359 d0e368 ">28</td>
|
|
<td valign="top" width="10%" headers="d0e359 d0e370 ">1C</td>
|
|
<td valign="top" width="20%" headers="d0e361 ">BINARY(4)</td>
|
|
<td valign="top" width="20%" headers="d0e363 ">Requested function</td>
|
|
<td valign="top" width="40%" headers="d0e365 ">The function being performed <ul><li><span class="uicontrol">X'1201'</span> - Retrieve conversion map</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e359 d0e368 ">32</td>
|
|
<td valign="top" width="10%" headers="d0e359 d0e370 ">20</td>
|
|
<td valign="top" width="20%" headers="d0e361 ">BINARY(4)</td>
|
|
<td valign="top" width="20%" headers="d0e363 ">From coded character set identifier (CCSID)</td>
|
|
<td valign="top" width="40%" headers="d0e365 ">CCSID for existing data</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e359 d0e368 ">36</td>
|
|
<td valign="top" width="10%" headers="d0e359 d0e370 ">24</td>
|
|
<td valign="top" width="20%" headers="d0e361 ">BINARY(4)</td>
|
|
<td valign="top" width="20%" headers="d0e363 ">To coded character set identifier (CCSID)</td>
|
|
<td valign="top" width="40%" headers="d0e365 ">CCSID into which the data will be converted</td>
|
|
</tr>
|
|
<tr><td valign="top" width="10%" headers="d0e359 d0e368 ">40</td>
|
|
<td valign="top" width="10%" headers="d0e359 d0e370 ">28</td>
|
|
<td valign="top" width="20%" headers="d0e361 ">BINARY(2)</td>
|
|
<td valign="top" width="20%" headers="d0e363 ">Type of conversion</td>
|
|
<td valign="top" width="40%" headers="d0e365 ">Requested mapping type: <ul><li><span class="uicontrol">X'0001'</span> - Round trip</li>
|
|
<li><span class="uicontrol">X'0002'</span> - Substitution mapping</li>
|
|
<li><span class="uicontrol">X'0003'</span> - Best-fit mapping</li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td colspan="5" valign="top" headers="d0e359 d0e361 d0e363 d0e365 d0e368 d0e370 "><div class="note"><span class="notetitle">Note:</span> This format is defined by member
|
|
EZSCEP in files H, QRPGSRC, QRPGLESRC, QLBLSRC and QCBLLESRC in library QSYSINC.</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiimst35.htm" title="Identify exit points for the servers.">Exit program parameters</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |