ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/qesrsrva.htm

1040 lines
28 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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>
&nbsp;&nbsp;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>
&nbsp;&nbsp;Default Public Authority: *USE<br>
<!-- iddvc RMBR -->
<br>
&nbsp;&nbsp;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 &amp;1 in library
&amp;2 ended. Reason code &amp;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>