1040 lines
28 KiB
HTML
1040 lines
28 KiB
HTML
<!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>Retrieve Service Attributes (QESRSRVA) API</title>
|
|
<!-- Begin Header Records ========================================= -->
|
|
<!-- QESRSRVA SCRIPT A converted by B2H R4.1 (346) (CMS) by KENTALA -->
|
|
<!-- at RCHVMW2 on 2 Oct 1998 at 16:04:13 -->
|
|
<!-- (C) Copyright IBM Corporation, 2004 -->
|
|
<!-- 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. -->
|
|
<!-- File cleanup completed Feb 2002 by v2cdijab -->
|
|
<!-- 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 language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
|
</script>
|
|
|
|
|
|
|
|
<h2>Retrieve Service Attributes (QESRSRVA) API</h2>
|
|
|
|
<div class="box" style="width: 90%;">
|
|
|
|
<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="40%">Receiver variable</td>
|
|
<td align="left" valign="top" width="25%">Output</td>
|
|
<td align="left" valign="top" width="25%">Char(*)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">2</td>
|
|
<td align="left" valign="top">Length of receiver variable</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">3</td>
|
|
<td align="left" valign="top">Number of service attribute keys</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">Service attribute keys</td>
|
|
<td align="left" valign="top">Input</td>
|
|
<td align="left" valign="top">Array(*) of Binary(4)</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">5</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 Retrieve Service Attributes (QESRSRVA) API copies specified service
|
|
attributes into the receiver variable.</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>Receiver variable</strong></dt>
|
|
|
|
<dd>OUTPUT; CHAR(*)</dd>
|
|
|
|
<dd>
|
|
<p>The variable in which this API returns the data. See <a href=
|
|
"#HDRRECVAR2">Receiver Variable Format</a></p>
|
|
</dd>
|
|
|
|
<dt><strong>Length of receiver variable</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)</dd>
|
|
|
|
<dd>
|
|
<p>The length of the receiver variable. The length of the receiver variable is
|
|
16 times the number of service attributes to be retrieved, plus the length of
|
|
each service attribute retrieved, plus 4.</p>
|
|
|
|
<p>As an example, the size of the receiver variable needed to retrieve the
|
|
automatic problem analysis and automatic problem reporting attributes is (16 *
|
|
2) + 1 + 1 + 4.</p>
|
|
|
|
<p><strong>Note:</strong> If this value is larger than the actual size of the
|
|
receiver variable, the results may not be predictable.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Number of service attribute keys</strong></dt>
|
|
|
|
<dd>INPUT; BINARY(4)</dd>
|
|
|
|
<dd>
|
|
<p>The total number of service attributes to retrieve.</p>
|
|
</dd>
|
|
|
|
<dt><strong>Service attribute keys</strong></dt>
|
|
|
|
<dd>INPUT: ARRAY(*) of BINARY(4)</dd>
|
|
|
|
<dd>
|
|
<p>A list of keys that identify which service attributes to retrieve. The keys
|
|
and their associated service attributes are:</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="10 90" -->
|
|
<tr>
|
|
<th align="left" valign="top">Key</th>
|
|
<th align="left" valign="top">Service attribute</th>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">1</td>
|
|
<td align="left" valign="top">Automatic problem analysis</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">2</td>
|
|
<td align="left" valign="top">Automatic problem reporting</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">3</td>
|
|
<td align="left" valign="top">Service provider to report problem</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">4</td>
|
|
<td align="left" valign="top">PTF install type</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">5</td>
|
|
<td align="left" valign="top">Critical message recipients</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">6</td>
|
|
<td align="left" valign="top">Send data packets</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><img src="delta.gif" alt="Start of change">7</td>
|
|
<td align="left" valign="top">Copy PTFs
|
|
<img src="deltaend.gif" alt="End of change">
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">10</td>
|
|
<td align="left" valign="top">System-disabled reporting connection number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">11</td>
|
|
<td align="left" valign="top">System-disabled call-back connection number</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">12</td>
|
|
<td align="left" valign="top">Service provider connection number</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
</dd>
|
|
|
|
<dt><strong>Error code</strong></dt>
|
|
|
|
<dd>I/O; CHAR(*)</dd>
|
|
|
|
<dd>
|
|
<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="HDRRECVAR2">Receiver Variable Format</a></h3>
|
|
|
|
<p>The format of the receiver variable is:</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%">Number of service attributes
|
|
retrieved</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">ARRAY(*) of BINARY(4)</td>
|
|
<td align="left" valign="top">Offsets to service attribute templates</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">*</td>
|
|
<td align="center" valign="top">*</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Service attribute templates</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h4>Field Descriptions</h4>
|
|
|
|
<strong>Number of service attributes retrieved.</strong>
|
|
|
|
<p>The number of service attributes the API put into the receiver variable.
|
|
This number will be less than the number requested if the receiver variable is
|
|
too small.</p>
|
|
|
|
<p><strong>Offsets to service attribute templates.</strong> A list of values.
|
|
Each value is an offset from the beginning of the receiver variable to a
|
|
service attribute template.</p>
|
|
|
|
<p><strong>Service attribute templates.</strong> The templates of the requested
|
|
service attributes. There is one template for each service attribute retrieved.
|
|
The formats of the templates are shown in <a href="#HDRTEMPLAT">Service
|
|
Attribute Template Format</a></p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRTEMPLAT">Service Attribute Template Format</a></h3>
|
|
|
|
<p>The format of a service attribute template is:</p>
|
|
|
|
<table border>
|
|
<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%">Service attribute key</td>
|
|
</tr>
|
|
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top"><img src="delta.gif" alt="Start of change">Data type of service attribute
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">5</td>
|
|
<td align="center" valign="top">5</td>
|
|
<td align="left" valign="top">CHAR(1)</td>
|
|
<td align="left" valign="top"><img src="delta.gif" alt="Start of change">Status of service attribute
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="center" valign="top">6</td>
|
|
<td align="left" valign="top">CHAR(2)</td>
|
|
<td align="left" valign="top"><img src="delta.gif" alt="Start of change">Reserved
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="center" valign="top">8</td>
|
|
<td align="left" valign="top">BINARY(4)</td>
|
|
<td align="left" valign="top"><img src="delta.gif" alt="Start of change">Length of service attribute
|
|
<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">12</td>
|
|
<td align="center" valign="top">C</td>
|
|
<td align="left" valign="top">CHAR(*)</td>
|
|
<td align="left" valign="top">Service attribute</td>
|
|
</tr>
|
|
</table>
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Data type of service attribute.</strong> The type of data
|
|
returned.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The service attribute was not available.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The service attribute is returned in character
|
|
format.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>2</em></td>
|
|
<td align="left" valign="top">The service attribute is returned in binary
|
|
format.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p><strong>Length of service attribute.</strong> The length of the service
|
|
attribute. If the service attribute was not available, this value is 0.</p>
|
|
|
|
<p><strong>Reserved.</strong> This field will contain null characters.</p>
|
|
|
|
<p><strong>Service attribute.</strong> The requested service attribute. See <a
|
|
href="#HDRFORMATS">Service Attributes Format</a> for the formats of the service
|
|
attributes.</p>
|
|
|
|
<p><strong>Service attribute key.</strong> A value that identifies the service
|
|
attribute that was retrieved.</p>
|
|
|
|
<p><strong>Status of service attribute.</strong> Whether the service attribute
|
|
was available for retrieval.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">The service attribute was available.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The service attribute was locked.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="HDRFORMATS"></a>Service Attributes Format</h3>
|
|
|
|
<p>The Service Attributes Format has the following self-explanatory keys to
|
|
solve problems:</p>
|
|
|
|
<ul>
|
|
<li><a href="#key1">Key 1--Automatic Problem Analysis</a></li>
|
|
|
|
<li><a href="#key2">Key 2--Automatic Problem Reporting</a></li>
|
|
|
|
<li><a href="#key3">Key 3--Service Provider to Report Problem</a></li>
|
|
|
|
<li><a href="#key4">Key 4--PTF Install Type</a></li>
|
|
|
|
<li><a href="#key5">Key 5--Critical Message Recipients</a></li>
|
|
|
|
<li><a href="#key6">Key 6--Send Data Packets</a></li>
|
|
|
|
<li><a href="#key7">
|
|
<img src="delta.gif" alt="Start of change">
|
|
Key 7--Copy PTFs</a>
|
|
<img src="deltaend.gif" alt="End of change"></li>
|
|
|
|
<li><a href="#key10">Key 10--System-Disabled Reporting Connection
|
|
Number</a></li>
|
|
|
|
<li><a href="#key11">Key 11--System-Disabled Call-Back Connection
|
|
Number</a></li>
|
|
|
|
<li><a href="#key12">Key 12--Service Provider Connection Number</a></li>
|
|
</ul>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="key1"></a>Key 1--Automatic Problem Analysis</h3>
|
|
|
|
<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%">CHAR(1)</td>
|
|
<td align="left" valign="top" width="60%">Attribute</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Attribute.</strong> The problem analysis attribute specifies when to
|
|
analyze problems.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Problems will not be analyzed when they are
|
|
logged. Instead, the operator must analyze the problem from the QSYSOPR message
|
|
queue or from the Work with Problems (WRKPRB) command.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">The system will analyze the problem as soon as
|
|
the problem is logged.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="key2">Key 2--Automatic Problem Reporting</a></h3>
|
|
|
|
<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%">CHAR(1)</td>
|
|
<td align="left" valign="top" width="60%">Attribute</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Attribute.</strong> The problem reporting attribute specifies when
|
|
to report problems.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Problems will not be reported when they are
|
|
logged. Instead, the operator must report the problem from the QSYSOPR message
|
|
queue or from the Work with Problems (WRKPRB) command.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">If the problem analysis attribute specifies that
|
|
problems are to be analyzed as soon as the problem is logged, the system will
|
|
report the problem to the service provider specified in the Service provider to
|
|
report problem attribute as soon as the problem is analyzed.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="key3">Key 3--Service Provider to Report Problem</a></h3>
|
|
|
|
<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%">CHAR(1)</td>
|
|
<td align="left" valign="top" width="60%">Name format</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">1</td>
|
|
<td align="center" valign="top">1</td>
|
|
<td align="left" valign="top">CHAR(17)</td>
|
|
<td align="left" valign="top">Service provider name</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Name format.</strong> This is an 'A' to show that the name is an SNA
|
|
node name.</p>
|
|
|
|
<p><strong>Service provider name.</strong> This identifies the service provider
|
|
to report problems to if the automatic problem reporting' attribute specifies
|
|
that problems are to be reported as soon as a problem is analyzed. If this
|
|
field contains *IBMSRV, problems will be sent to IBM. Otherwise, the first
|
|
eight characters of this field contain the control point name of the service
|
|
provider. The next nine characters contain either the network identifier of the
|
|
service provider, or *LCLNETID if the network identifier of the service
|
|
provider is the same as that of the system that is reporting the problem.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="key4">Key 4--PTF Install Type</a></h3>
|
|
|
|
<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%">CHAR(10)</td>
|
|
<td align="left" valign="top" width="60%">Type of PTF install</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Type of PTF install.</strong> This service attribute determines
|
|
whether the immediate PTFs are applied immediately or delayed.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DLYIPL</em></td>
|
|
<td align="left" valign="top">All PTFs will be marked for delayed apply and the
|
|
system will be IPLed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*DLYALL</em></td>
|
|
<td align="left" valign="top">All PTFs will be marked for delayed apply and the
|
|
system will not be IPLed.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*IMMONLY</em></td>
|
|
<td align="left" valign="top">The immediate PTFs will be applied and the
|
|
delayed PTFs marked for apply at the next IPL.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*IMMDLY</em></td>
|
|
<td align="left" valign="top">Only the immediate PTFs will be applied and the
|
|
system will not be IPLed.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="key5">Key 5--Critical Message Recipients</a></h3>
|
|
|
|
<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%">Number of entries</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="center" valign="top">4</td>
|
|
<td align="left" valign="top">ARRAY(50) of CHAR(10)</td>
|
|
<td align="left" valign="top">User list</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Number of entries.</strong> This is the number of entries in the
|
|
user list.</p>
|
|
|
|
<p><strong>User list.</strong> This is an ordered list of user identifiers and
|
|
user classes. If the system detects a critical condition such as a DASD
|
|
failure, and the first entry in this list is a user identifier, and that user
|
|
is signed on, the system will send a break message to that user. If the first
|
|
entry is a user class, the system will try to send a break message to all the
|
|
users in that class that are signed on.</p>
|
|
|
|
<p>If the specified user is not signed on, or none of the users in the user
|
|
class are signed on, the system tries to send the break message to the user
|
|
identifier or user class in the second entry of this list.</p>
|
|
|
|
<p>The system keeps trying to find a user that is signed on until it reaches
|
|
the end of the list.</p>
|
|
|
|
<p>This function is only used if problem analysis routines are run
|
|
automatically at the time of failure (the ANZPRBAUTO service attribute is
|
|
*YES).</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="15 85" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SYSOPR</em></td>
|
|
<td align="left" valign="top">All users of user class *SYSOPR will receive a
|
|
message when a critical message is sent.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SECOFR</em></td>
|
|
<td align="left" valign="top">All users of user class *SECOFR will receive a
|
|
message when a critical message is sent.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*SECADM</em></td>
|
|
<td align="left" valign="top">All users of user class *SECADM will receive a
|
|
message when a critical message is sent.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*PGMR</em></td>
|
|
<td align="left" valign="top">All users of user class *PGMR will receive a
|
|
message when a critical message is sent.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>*USER</em></td>
|
|
<td align="left" valign="top">All users of user class *USER will receive a
|
|
message when a critical message is sent.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><a name="key6">Key 6--Send Data Packets</a></h3>
|
|
|
|
<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%">CHAR(1)</td>
|
|
<td align="left" valign="top" width="60%">Attribute</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Attribute.</strong> The Send data packets attribute specifies
|
|
whether or not to send problem data to the service provider.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">Data will not be sent to the service
|
|
provider.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">Up to 2000 bytes of data will be sent to the
|
|
service provider.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3><img src="delta.gif" alt="Start of change"><a name="key7">Key 7--Copy PTFs</a></h3>
|
|
|
|
<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%">CHAR(1)</td>
|
|
<td align="left" valign="top" width="60%">Attribute</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Attribute.</strong> The Copy PTFs attribute specifies
|
|
whether or not to copy PTF save files and cover letters
|
|
into *SERVICE when PTFs are loaded
|
|
from a tape or optical device. PTF save files must be in *SERVICE when
|
|
distributing PTFs to other systems or when using the Save System
|
|
Information (SAVSYSINF) command.</p>
|
|
|
|
<table cellpadding="5">
|
|
<!-- cols="5 95" -->
|
|
<tr>
|
|
<td align="left" valign="top"><em>0</em></td>
|
|
<td align="left" valign="top">PTF save files and cover letters
|
|
are not copied into *SERVICE
|
|
when PTFs are loaded from tape or optical.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top"><em>1</em></td>
|
|
<td align="left" valign="top">PTF save files and cover letters
|
|
that do not already exist
|
|
are copied into *SERVICE when PTFs are loaded from tape
|
|
or optical.<img src="deltaend.gif" alt="End of change"></td>
|
|
</tr>
|
|
</table>
|
|
|
|
|
|
<br>
|
|
<br>
|
|
|
|
<h3><a name="key10">Key 10--System-Disabled Reporting Connection
|
|
Number</a></h3>
|
|
|
|
<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%">CHAR(30)</td>
|
|
<td align="left" valign="top" width="60%">System-disabled reporting connection
|
|
number</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>System-disabled reporting connection number.</strong> The complete
|
|
electronic connection number used for automatic reporting to external support
|
|
when this system is disabled. This number should include the entire sequence of
|
|
numbers required to complete the call, including international access codes,
|
|
country or region codes, area codes, exchanges, and so on, as appropriate.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="key11">Key 11--System-Disabled Call-Back Connection
|
|
Number</a></h3>
|
|
|
|
<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%">CHAR(30)</td>
|
|
<td align="left" valign="top" width="60%">System-disabled call-back connection
|
|
number</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>System-disabled call-back connection number.</strong> The complete
|
|
electronic connection number used to call back this system from external
|
|
support when this system is disabled. This number should include the entire
|
|
sequence of numbers required to complete the call, including international
|
|
access codes, country or region codes, area codes, exchanges, and so on, as
|
|
appropriate.</p>
|
|
|
|
<br>
|
|
|
|
|
|
<h3><a name="key12">Key 12--Service Provider Connection Number</a></h3>
|
|
|
|
<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%">CHAR(30)</td>
|
|
<td align="left" valign="top" width="60%">Service provider connection
|
|
number</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
<br>
|
|
|
|
|
|
<h3>Field Descriptions</h3>
|
|
|
|
<p><strong>Service provider connection number.</strong> The complete electronic
|
|
connection number to the service provider. This number should include the
|
|
entire sequence of numbers required to complete the call, including
|
|
international access codes, country or region codes, area codes, exchanges,
|
|
and so on, as appropriate.</p>
|
|
|
|
<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">CPF3C19 E</td>
|
|
<td align="left" valign="top">Error occurred with receiver variable
|
|
specified.</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">CPF8C50 E</td>
|
|
<td align="left" valign="top">Key in input list not valid.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF8C51 E</td>
|
|
<td align="left" valign="top">Error with receiver variable length.</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td align="left" valign="top">CPF8C52 E</td>
|
|
<td align="left" valign="top">Number of values in input list 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>
|
|
</table>
|
|
|
|
<br>
|
|
<hr>
|
|
API introduced: V3R1
|
|
|
|
<hr>
|
|
<center>
|
|
<table cellpadding="2" cellspacing="2">
|
|
<tr align="center">
|
|
<td valign="middle" align="center"><a href="#top_of_page">Top</a> | <a href=
|
|
"pm1.htm">Problem Management APIs</a> | <a href="aplist.htm">APIs by
|
|
category</a></td>
|
|
</tr>
|
|
</table>
|
|
</center>
|
|
</body>
|
|
</html>
|
|
|