friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/QPDETCVT.htm

1506 lines
53 KiB
HTML
Raw Normal View History

Add readme and dist folders
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>Convert Format of Service Information (QPDETCVT) 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. -->
<!-- Created for V5R4 by Gabriela Perez (gabyp) Dxxxxx -->
<!-- Reason v5r4m0 Dev Date 041130 Change -->
<!-- Change History: -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
</script>
<a name="Top_Of_Page"></a>
<h2><img src="delta.gif" alt="Start of change">Convert Format of Service Information (QPDETCVT) API</h2>
<div class="box" style="width: 70%;">
<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="50%">Receiver variable</td>
<td align="left" valign="top" width="20%">Output</td>
<td align="left" valign="top" width="20%">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">2</td>
<td align="left" valign="top" width="50%">Length of receiver variable</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">3</td>
<td align="left" valign="top">Format of receiver variable</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">4</td>
<td align="left" valign="top">Information to convert</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(*)</td>
</tr>
<tr>
<td align="center" valign="top">5</td>
<td align="left" valign="top">Format of information to convert</td>
<td align="left" valign="top">Input</td>
<td align="left" valign="top">Char(8)</td>
</tr>
<tr>
<td align="center" valign="top">6</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: Yes<br>
<!-- iddvc RMBR -->
<br>
</div>
<p>The <strong>Convert Format of Service Information(QPDETCVT) API </strong>
will take the data input and convert it to a string containing an XML object.</p>
<br>
<h3>Authorities and Locks</h3>
<dl>
<dt><em>Authority to use the API</em></dt>
<dd>No authorities needed. <br>
<br>
</dd>
</dl>
<br>
<h3>Required Parameter Group</h3>
<dl>
<dt><strong>Receiver Variable</strong></dt>
<dd>OUTPUT; CHAR(*)
<p>The receiver variable that receives the information requested. The data returned will be a formatted XML string.</p>
<br></dd>
<dt><strong>Length of receiver variable </strong></dt>
<dd>INPUT; BINARY(4)
<p>The size of the area to contain the information returned, in bytes. </p>
<p>This parameter must specify the size of the variable you use for the receiver variable parameter. If this parameter specifies a longer size, other parts of storage could be overwritten when the API returns the information.</p>
<p>To determine how much information the API actually returns in response to this call, see the bytes returned field in the receiver variable format. To determine how much information the API could return if space were available, see the bytes available field.</p>
<p>If the bytes available is greater than the length supplied, no XML data will be returned and the bytes returned field will be set to 8.</p>
<br></dd>
<dt><strong>Format of receiver variable </strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the information passed back to the caller of this API. The possible format names are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>CVTR0100</em></td>
<td align="left" valign="top">The information returned to the caller of this API. For more information, see <a href="#CVTR0100"> CVTR0100 Format</a> for information to convert</td>
</tr>
</table>
<br>
</dd>
<dt><strong>Information to convert</strong></dt>
<dd> INPUT; CHAR(*)
<p>The data to be converted.</p>
</dd>
<dt><strong>Format of information to convert</strong></dt>
<dd>INPUT; CHAR(8)
<p>The format of the information passed in the information to convert. The possible format names are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em><a href="#CVTS0100">CVTS0100</a></em></td>
<td align="left" valign="top">The information to convert and the receiver variable are for
LIC Log data typically associated with the exit program specified in <a href="../cl/strwch.htm">Start Watch </a>(STRWCH) command or API.
The format of the receiver variable will be described by the XSD file specified in the returned
XML object.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#CVTS0200">CVTS0200</a></em></td>
<td align="left" valign="top">The information to convert and the receiver variable are for
message data typically associated with the <a href="../cl/strwch.htm">Start Watch </a>(STRWCH) command or API exit program.
The format of the receiver variable will be described by the XSD file specified in the returned
XML object.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#CVTS0300">CVTS0300</a></em></td>
<td align="left" valign="top">The information to convert and the receiver variable are for message
data typically associated with the <a href="QGYOLMSG.htm"> Open List of Messages</a>
(QGYOLMSG) API or the <a href="QMHLSTM.htm"> List Nonprogram Messages</a> (QMHLSTM) API. For more information, see <a href="#CVTS0300">CVTS0300 Format</a> for information to convert.
The format of the receiver variable will be described by the XSD file specified in the returned
XML object.</td>
</tr>
<tr>
<td align="left" valign="top"><em><a href="#CVTS0400">CVTS0400</a></em></td>
<td align="left" valign="top">The information to convert and the receiver variable are for message
data typically associated with the<a href="QGYOLJBL.htm"> Open List of Job Log Messages</a> (QGYOLJBL) API or
the <a href="QMHLJOBL.htm"> List Job Log Messages </a>(QMHLJOBL) API. For more information, see <a href="#CVTS0400">CVTS0400 Format</a> for information to convert.
The format of the receiver variable will be described by the XSD file specified in the returned XML
object.</td>
</tr>
</table>
<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>
<br>
<h3><a name="CVTR0100">CVTR0100 - Format for receiver variable </a></h3>
The following table shows the format of the returned information. For a detailed description of each field,
see <a href="#fields"> Field Descriptions</a>.<br>
<br>
<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="left" valign="bottom">Dec</th>
<th align="left" 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%">Bytes returned</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">4</td>
<td align="center" valign="top" width="10%">4</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Bytes available</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">8</td>
<td align="center" valign="top" width="10%">8</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">XML data length</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">12</td>
<td align="center" valign="top" width="10%">C</td>
<td align="left" valign="top" width="20%">CHAR(*)</td>
<td align="left" valign="top" width="60%">XML data</td>
</tr>
</table>
<br>
<h3><a name="CVTS0100">CVTS0100 - Format for LIC Log conversion </a></h3>
The following table shows the input for converting a LIC Log to XML. Any data not available should be initialized with '00'x.
<br>For a detailed description of each field, see <a href="#fields"> Field Descriptions</a><br>
<br>
<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="left" valign="bottom">Dec</th>
<th align="left" 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%">Length of watch information</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">4</td>
<td align="center" valign="top" width="10%">4</td>
<td align="left" valign="top" width="20%">CHAR(4)</td>
<td align="left" valign="top" width="60%">LIC Log major code</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">8</td>
<td align="center" valign="top" width="10%">8</td>
<td align="left" valign="top" width="20%">CHAR(4)</td>
<td align="left" valign="top" width="60%">LIC Log minor code</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">12</td>
<td align="center" valign="top" width="10%">C</td>
<td align="left" valign="top" width="20%">CHAR(8)</td>
<td align="left" valign="top" width="60%">LIC Log identifier</td>
</tr><tr>
<td align="center" valign="top" width="10%">20</td>
<td align="center" valign="top" width="10%">14</td>
<td align="left" valign="top" width="20%">CHAR(8)</td>
<td align="left" valign="top" width="60%">LIC Log timestamp</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">28</td>
<td align="center" valign="top" width="10%">1C</td>
<td align="left" valign="top" width="20%">CHAR(8)</td>
<td align="left" valign="top" width="60%">TDE number</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">36</td>
<td align="center" valign="top" width="10%">24</td>
<td align="left" valign="top" width="20%">CHAR(16)</td>
<td align="left" valign="top" width="60%">Task name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">52</td>
<td align="center" valign="top" width="10%">34</td>
<td align="left" valign="top" width="20%">CHAR(30)</td>
<td align="left" valign="top" width="60%">Server type</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">82</td>
<td align="center" valign="top" width="10%">52</td>
<td align="left" valign="top" width="20%">CHAR(2)</td>
<td align="left" valign="top" width="60%">Exception ID</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">84</td>
<td align="center" valign="top" width="10%">54</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">LIC job name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">94</td>
<td align="center" valign="top" width="10%">5E</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">LIC job user name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">104</td>
<td align="center" valign="top" width="10%">68</td>
<td align="left" valign="top" width="20%">CHAR(6)</td>
<td align="left" valign="top" width="60%">LIC job number</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">110</td>
<td align="center" valign="top" width="10%">6E</td>
<td align="left" valign="top" width="20%">CHAR(4)</td>
<td align="left" valign="top" width="60%">Reserved</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">114</td>
<td align="center" valign="top" width="10%">72</td>
<td align="left" valign="top" width="20%">CHAR(8)</td>
<td align="left" valign="top" width="60%">Thread ID</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">122</td>
<td align="center" valign="top" width="10%">7A</td>
<td align="left" valign="top" width="20%">CHAR(8)</td>
<td align="left" valign="top" width="60%">LIC module compile binary timestamp</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">130</td>
<td align="center" valign="top" width="10%">82</td>
<td align="left" valign="top" width="20%">CHAR(8)</td>
<td align="left" valign="top" width="60%">LIC module offset</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">138</td>
<td align="center" valign="top" width="10%">8A</td>
<td align="left" valign="top" width="20%">CHAR(8)</td>
<td align="left" valign="top" width="60%">LIC module RU name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">146</td>
<td align="center" valign="top" width="10%">92</td>
<td align="left" valign="top" width="20%">CHAR(48)</td>
<td align="left" valign="top" width="60%">LIC module name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">194</td>
<td align="center" valign="top" width="10%">DA</td>
<td align="left" valign="top" width="20%">CHAR(128)</td>
<td align="left" valign="top" width="60%">LIC module entry point name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">322</td>
<td align="center" valign="top" width="10%">142</td>
<td align="left" valign="top" width="20%">CHAR(2)</td>
<td align="left" valign="top" width="60%">Reserved</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">324</td>
<td align="center" valign="top" width="10%">144</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to comparison data</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">328</td>
<td align="center" valign="top" width="10%">148</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of comparison data</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">*</td>
<td align="center" valign="top" width="10%">*</td>
<td align="left" valign="top" width="20%">CHAR(*)</td>
<td align="left" valign="top" width="60%">LIC Log comparison data</td>
</tr>
</table>
<br>
<br>
<h3><a name="CVTS0200">CVTS0200 - Format for message conversion (STRWCH) </a></h3>
<p>The following table shows the input for converting messages received from the Start Watch command or API to XML. Any data not available should be initialized with '00'x.</p>
<p>For a detailed description of each field, see <a href="#fields"> 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="left" valign="bottom">Dec</th>
<th align="left" 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%">Length of watch information</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">4</td>
<td align="center" valign="top" width="10%">4</td>
<td align="left" valign="top" width="20%">CHAR(7)</td>
<td align="left" valign="top" width="60%">Message ID</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">11</td>
<td align="center" valign="top" width="10%">B</td>
<td align="left" valign="top" width="20%">CHAR(1)</td>
<td align="left" valign="top" width="60%">Reserved</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">12</td>
<td align="center" valign="top" width="10%">C</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Message queue name</td>
</tr><tr>
<td align="center" valign="top" width="10%">22</td>
<td align="center" valign="top" width="10%">16</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Message queue library</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">32</td>
<td align="center" valign="top" width="10%">20</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Job name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">42</td>
<td align="center" valign="top" width="10%">2A</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Job user name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">52</td>
<td align="center" valign="top" width="10%">34</td>
<td align="left" valign="top" width="20%">CHAR(6)</td>
<td align="left" valign="top" width="60%">Job number</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">58</td>
<td align="center" valign="top" width="10%">3A</td>
<td align="left" valign="top" width="20%">CHAR(4)</td>
<td align="left" valign="top" width="60%">Reserved</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">62</td>
<td align="center" valign="top" width="10%">3E</td>
<td align="left" valign="top" width="20%">CHAR(256)</td>
<td align="left" valign="top" width="60%">Sending program name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">318</td>
<td align="center" valign="top" width="10%">13E</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Sending module name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">328</td>
<td align="center" valign="top" width="10%">148</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to sending procedure name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">332</td>
<td align="center" valign="top" width="10%">14C</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of sending procedure name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">336</td>
<td align="center" valign="top" width="10%">150</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Receiving program name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">346</td>
<td align="center" valign="top" width="10%">15A</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Receiving module name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">356</td>
<td align="center" valign="top" width="10%">164</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to receiving procedure name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">360</td>
<td align="center" valign="top" width="10%">168</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of receiving procedure name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">364</td>
<td align="center" valign="top" width="10%">16C</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Message severity</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">368</td>
<td align="center" valign="top" width="10%">170</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Symbolic message type</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">378</td>
<td align="center" valign="top" width="10%">17A</td>
<td align="left" valign="top" width="20%">CHAR(8)</td>
<td align="left" valign="top" width="60%">Message timestamp</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">386</td>
<td align="center" valign="top" width="10%">182</td>
<td align="left" valign="top" width="20%">CHAR(4)</td>
<td align="left" valign="top" width="60%">Message key</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">390</td>
<td align="center" valign="top" width="10%">186</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Message file name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">400</td>
<td align="center" valign="top" width="10%">190</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Message file library</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">410</td>
<td align="center" valign="top" width="10%">19A</td>
<td align="left" valign="top" width="20%">CHAR(2)</td>
<td align="left" valign="top" width="60%">Reserved</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">412</td>
<td align="center" valign="top" width="10%">19C</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to comparison data</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">416</td>
<td align="center" valign="top" width="10%">1A0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of comparison data</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">420</td>
<td align="center" valign="top" width="10%">1A4</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Compare against</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">430</td>
<td align="center" valign="top" width="10%">1AE</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Reserved</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">432</td>
<td align="center" valign="top" width="10%">1B0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Comparison data CCSID</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">436</td>
<td align="center" valign="top" width="10%">1B4</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset where comparison data was found</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">440</td>
<td align="center" valign="top" width="10%">1B8</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to message replacement data</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">444</td>
<td align="center" valign="top" width="10%">1BC</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Length of message replacement data</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">448</td>
<td align="center" valign="top" width="10%">1C0</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Replacement data CCSID</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">*</td>
<td align="center" valign="top" width="10%">*</td>
<td align="left" valign="top" width="20%">CHAR(*)</td>
<td align="left" valign="top" width="60%">Sending procedure name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">*</td>
<td align="center" valign="top" width="10%">*</td>
<td align="left" valign="top" width="20%">CHAR(*)</td>
<td align="left" valign="top" width="60%">Receiving procedure name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">*</td>
<td align="center" valign="top" width="10%">*</td>
<td align="left" valign="top" width="20%">CHAR(*)</td>
<td align="left" valign="top" width="60%">Message comparison data</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">*</td>
<td align="center" valign="top" width="10%">*</td>
<td align="left" valign="top" width="20%">CHAR(*)</td>
<td align="left" valign="top" width="60%">Message replacement data</td>
</tr>
</table>
<br>
<br>
<h3><a name="CVTS0300">CVTS0300 - Format for message conversion (QGYOLMSG) </a></h3>
The following table shows the input for converting messages received from the Open
List of Messages in format LSTM0100 to XML. For a detailed description of each field,
For a detailed description of each field, see <a href="#fields"> Field Descriptions</a>.
<br>
Any data not available should be initialized with '00'x. <br>
<br>
<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="left" valign="bottom">Dec</th>
<th align="left" 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%">Length of fixed header</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">4</td>
<td align="center" valign="top" width="10%">4</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to first message</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">8</td>
<td align="center" valign="top" width="10%">8</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Number of messages to convert</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="15" colspan="2">These fields repeat for each message identifier specified.</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Displacement to the next entry</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Displacement to fields</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of fields</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Message severity</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Message identifier</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Message type</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Message key</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message file name</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message file library specified at send time</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message queue</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message queue library used</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Date sent</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Time Sent</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Microseconds</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<table border width="80%">
<tr>
<td align="left" valign="top" rowspan="9" colspan="2" width="20%">These fields repeat for each
identifier field specified.</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" >Displacement to the next field information </td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of field information </td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Identifier field</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Type of data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Status of data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(14)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<br>
<h3><a name="CVTS0400">CVTS0400 - Format for message conversion (QGYOLJBL) </a></h3>
The following table shows the input for converting messages received from the
Open list of Joblog Messages in format OLJL0100 to XML. For a detailed description
of each field, see <a href="#fields"> Field Descriptions</a>.
<br>
Any data not available should be initialized with '00'x. <br>
<br> <br>
<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="left" valign="bottom">Dec</th>
<th align="left" 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%">Length of fixed header</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">4</td>
<td align="center" valign="top" width="10%">4</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Offset to first message</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">8</td>
<td align="center" valign="top" width="10%">8</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top" width="60%">Number of messages to convert</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">12</td>
<td align="center" valign="top" width="10%">C</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Job name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">22</td>
<td align="center" valign="top" width="10%">16</td>
<td align="left" valign="top" width="20%">CHAR(10)</td>
<td align="left" valign="top" width="60%">Job user name</td>
</tr>
<tr>
<td align="center" valign="top" width="10%">32</td>
<td align="center" valign="top" width="10%">20</td>
<td align="left" valign="top" width="20%">CHAR(6)</td>
<td align="left" valign="top" width="60%">Job number</td>
</tr>
<tr>
<td align="left" valign="top" rowspan="15" colspan="2" >These fields repeat for each message identifier specified.</td>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Displacement to the next entry </td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Displacement to fields</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Number of fields</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Message severity</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Message identifier</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Message type</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(4)</td>
<td align="left" valign="top">Message key</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message file name</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(10)</td>
<td align="left" valign="top">Message file library specified at send time</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(7)</td>
<td align="left" valign="top">Date sent</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Time sent</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(6)</td>
<td align="left" valign="top">Microseconds </td>
</tr>
<tr>
<td align="left" valign="top">CHAR(2)</td>
<td align="left" valign="top">Message type</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<table border width="80%">
<tr>
<td align="left" valign="top" rowspan="9" colspan="2" width="20%">These fields repeat for each identifier field specified.</td>
<td align="left" valign="top" width="20%">BINARY(4)</td>
<td align="left" valign="top">Displacement to the next field information returned</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of field information returned</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Identifier field</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Type of data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(1)</td>
<td align="left" valign="top">Status of data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(14)</td>
<td align="left" valign="top">Reserved</td>
</tr>
<tr>
<td align="left" valign="top">BINARY(4)</td>
<td align="left" valign="top">Length of data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Data</td>
</tr>
<tr>
<td align="left" valign="top">CHAR(*)</td>
<td align="left" valign="top">Reserved</td>
</tr>
</table>
<br>
<h3><a name="fields">Field Descriptions</a></h3>
<p><strong>Bytes available.</strong> The number of bytes of data available to be returned.
All available data is returned if enough space is provided.</p>
<p><strong>Bytes returned.</strong>
The number of bytes of data returned.</p>
<p><strong>Compare against.</strong>
The part of the message the data specified in message comparison data
field was compared against. This field is set to blanks if zero was
specified for the length of comparison data field. The possible values are:</p>
<table cellpadding="5">
<!-- cols="15 85" -->
<tr>
<td align="left" valign="top"><em>*MSGDTA</em></td>
<td align="left" valign="top">The message comparison data was compared
against the message replacement data.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*FROMPGM</em></td>
<td align="left" valign="top">The message comparison data was compared against the sending program name.</td>
</tr>
<tr>
<td align="left" valign="top"><em>*TOPGM</em></td>
<td>The message comparison data was compared against the receiving program name.</td>
</tr>
</table>
<p><strong>Comparison data CCSID.</strong> The coded character set identifier (CCSID)
of the message comparison data.</p>
<p><strong>Data</strong>. The data associated with the specified identifier field.</p>
<p><strong>Date Sent</strong>. The date on which the message was sent, in CYYMMDD
(century, year, month, and day) format.</p>
<p><strong>Displacement to fields.</strong> The displayment displacement, in bytes, from the beginning
of the repeating information for each message variable to the beginning of the
first repeating identifier field of the CVTS0300 or CVTS0400 format.</p>
<p><strong>Displacement to the next entry. </strong>The displacement, in bytes,
from the beginning of the first message entry to the beginning of the next message
entry. If there is no next entry, this field should be set to 0.</p>
<p><strong>Displacement to the next field information.</strong> The displacement,
in bytes, from the beginning of the first message entry to the beginning of the
next repeating identifier field of the CVTS0300 format.</p>
<p><strong>Exception ID.</strong> The exception that caused the Log entry to be
requested. This is a 2-byte hexadecimal field formed by concatenating to the
high-order 1-byte exception group number a low-order 1-byte exception subtype number.
Exception identifier is binary zeros if the LIC Log entry was not
requested as a result of an exception.</p>
<p><strong>Identifier field.</strong> The field returned. See <em>QGYOLMSG</em> - Open List
of Messages, the <em> Valid Field Identifiers</em> for the list of valid field identifiers.</p>
<p><strong>Job name.</strong> The name of the job that sent the message.</p>
<p><strong>Job number.</strong> The job number (000001-999999) to further qualify the job name
and user name of the job that sent the message</p>
<p><strong>Job user name.</strong> The user name of the job that sent the message.</p>
<p><strong>Length of comparison data.</strong> The length of the user specified text which was
compared against the message or LIC Log event data.</p>
<p><strong>Length of data.</strong> The length of the data returned in the data field, in bytes.
If no data is returned, this value will be set to 0.</p>
<p><strong>Length of field information.</strong> The total length of information in this
field, in bytes.</p>
<p><strong>Length of fixed header.</strong> The total length of fixed header information,
in bytes. The possible values are:</p>
<table cellpadding="5">
<!-- cols="5 85" -->
<tr>
<td>12</td>
<td>- when using format CVTS0300</td>
</tr>
<tr>
<td>38</td>
<td>- when using format CVTS0400</td>
</tr>
</table>
<p><strong>Length of message replacement data.</strong> The length of the message replacement
data, in bytes.</p>
<p><strong>Length of receiving procedure name.</strong> The length of the procedure
the message was sent to when the message was sent to a procedure within an ILE program.
This field is set to zero if the message was sent to an original program model (OPM)
program or when the message is sent to a nonprogram message queue.</p>
<p><strong>Length of sending procedure name.</strong> The length of the procedure
sending the message when the message was sent from a procedure within an ILE program.
This field is set to zero if the message was sent from an original program model
(OPM) program.</p>
<p><strong>Length of watch information.</strong> The length of the Information
to convert parameter , including the 4-byte length of this field, associated
with the the data in format CVTS0100 or format CVTS0200.</p>
<p><strong>LIC job name.</strong> The name of the job which requested the
Log entry. LIC job name is blank (hex 40s) if the Log entry was not
requested by a job.</p>
<p><strong>LIC job number.</strong> The job number (000001-999999) to
further qualify the job name and user name of the job which requested
the LIC Log entry. LIC job number is blank (hex 40s) if the LIC Log
entry was not requested by a job.</p>
<p><strong>LIC job user name.</strong> The user name of the job which
requested the LIC Log entry. LIC user name is blank (hex 40s) if the
LIC Log entry was not requested by a job.</p>
<p><strong>LIC Log comparison data.</strong> The user specified text
string used to compare against the entry data of the watched for log
entry. This is an optional field.</p>
<p><strong>LIC Log identifier.</strong> The LIC Log entry identifier of
the LIC Log that occurred. The LIC Log entry identifier is binary zeros
if the entry was not added to the LIC Log by the time this event was
signalled.</p>
<p><strong>LIC Log major code.</strong> The major code of the LIC Log
that occurred.</p>
<p><strong>LIC Log minor code.</strong> The minor code of the LIC Log
that occurred.</p>
<p><strong>LIC Log timestamp.</strong> The binary timestamp of when
the entry was requested to be added to the LIC Log. The format for
this field is the system time-stamp format.</p>
<p><strong>LIC module compile binary timestamp.</strong> The binary
timestamp of when the LIC module was compiled. The format for this
field is the system time-stamp format.</p>
<p><strong>LIC module entry point name.</strong> The name of the entry
point which requested the LIC Log entry. If the entry point name is
greater than 128 characters, the LIC module entry point name is
truncated to 128 characters.</p>
<p><strong>LIC module name.</strong> The name of the module which
requested the LIC Log entry. If the module name is greater than 48
characters, the LIC module name is truncated to 48 characters.</p>
<p><strong>LIC module offset.</strong> The byte offset into the LIC
module text which requested the LIC Log entry.</p>
<p><strong>LIC module RU name.</strong> The replaceable unit name of
the module which requested the LIC Log entry. LIC module RU name is
always in upper case EBCDIC.</p>
<p><strong>Message comparison data.</strong> The user specified text
string used to compare against the entry data of the watched for
message ID.</p>
<p><strong>Message file library.</strong> The name of the library
containing the message file.</p>
<p><strong>Message file library specified at send time.</strong>
The name of the library containing the message file as specified
when the message was sent. If *CURLIB or *LIBL was specified for
the library when the message was sent, that value is returned as
the library here.</p>
<p><strong>Message file name.</strong> The name of the message file
that was used to send the message.</p>
<p><strong>Message ID.</strong> The identifier of the message that
occurred.</p>
<p><strong>Message identifier.</strong> The identifying code of the
message listed. If an immediate message is listed, this field is
set to blanks.</p>
<p><strong>Message key.</strong> The message reference key of the
message that occurred. This field is set to blanks if *JOBLOG is
specified for the message queue name.</p>
<p><strong>Message queue.</strong> The name of the message queue
where the message was listed.</p>
<p><strong>Message queue library.</strong> The name of the library
where the message queue is located. This field is set to blanks if
*JOBLOG is specified for the message queue name.</p>
<p><strong>Message queue library used.</strong> The actual library
that contains the message queue.</p>
<p><strong>Message queue name.</strong> The name of the message
queue where the message was sent. The following special values are
accepted:</p>
<table cellpadding="5">
<!-- cols="10 90" -->
<tr>
<td>Value</td>
<td>Message Type</td>
</tr>
<tr>
<td>*JOBLOG</td>
<td>The message ID was found in the job specified in the job name,
user name and job number fields.</td>
</tr>
</table>
<p><strong>Message replacement data.</strong> The values for substitution
variables in the message sent.</p>
<p><strong>Message severity.</strong> The severity code, ranging from 00
through 99, of the message.</p>
<p><strong>Message timestamp.</strong> The timestamp of when the message
was sent. The format for this field is the system time-stamp format.</p>
<p><strong>Message type.</strong> The type of message listed. The
possible values and their meanings follow:<br> </p>
<br>
<table cellpadding="5" border width="80%">
<!-- cols="10 90" -->
<tr>
<td>Value</td>
<td>Message Type</td>
</tr>
<tr>
<td>01</td>
<td>Completion</td>
</tr>
<tr>
<td>02</td>
<td>Diagnostic</td>
</tr>
<tr>
<td>04</td>
<td>Informational</td>
</tr>
<tr>
<td>05</td>
<td>Inquiry</td>
</tr>
<tr>
<td>06</td>
<td>Sender's copy</td>
</tr>
<tr>
<td>08</td>
<td>Request</td>
</tr>
<tr>
<td>10</td>
<td>Request with prompting</td>
</tr>
<tr>
<td>14</td>
<td>Notify, exception already handled when API is called</td>
</tr>
<tr>
<td>15</td>
<td>Escape, exception already handled when API is called</td>
</tr>
<tr>
<td>16</td>
<td>Notify, exception not handled when API is called</td>
</tr>
<tr>
<td>17</td>
<td>Escape, exception not handled when API is called</td>
</tr>
<tr>
<td>21</td>
<td>Reply, not checked for validity</td>
</tr>
<tr>
<td>22</td>
<td>Reply, checked for validity</td>
</tr>
<tr>
<td>23</td>
<td>Reply, message default used</td>
</tr>
<tr>
<td>24</td>
<td>Reply, system default used</td>
</tr>
<tr>
<td>25</td>
<td>Reply, from system reply list</td>
</tr>
<tr>
<td>26</td>
<td>Reply, from exit program</td>
</tr>
</table>
<p><strong>Microseconds.</strong> The microseconds part of the
time sent.</p>
<p><strong>Number of fields.</strong> The number of identifier fields provided to
the application</p>
<p><strong>Number of messages to convert.</strong> The number of messages
provided to the application</p>
<p><strong>Offset to comparison data.</strong> The offset to the field that
holds the comparison data. If there was no comparison data, this field should
be set to 0.</p>
<p><strong>Offset to first message.</strong> The offset , in bytes, from the beginning
of the message information to convert variable to the beginning of the first
repeating message entry of the CVTS0300 or CVTS0400 format.</p>
<p><strong>Offset to message replacement data.</strong> The offset to the field
that holds the replacement data.</p>
<p><strong>Offset to receiving procedure name.</strong> The offset to the field
that holds the procedure the message was sent to when the message was sent to a procedure
within an ILE program. This field is set to zero if the message was sent to an original
program model (OPM) program or when the message is sent to a nonprogram message queue.</p>
<p><strong>Offset to sending procedure name.</strong> The offset to the field that
holds the procedure sending the message when the message was sent from a procedure within
an ILE program. This field is set to zero if the message was sent from an original program
model (OPM) program.</p>
<p><strong>Offset where comparison data was found.</strong> The offset in the message
replacement data, the sending program name or the receiving program name, where the
message comparison data was found. This field is set to zero if zero was specified
for the length of comparison data field.</p>
<p><strong>Receiving module name.</strong> The name of the module receiving the
message when the message was sent to a procedure within an ILE program. If the
message was sent to an original program model (OPM) program, this field is set
to blanks. This field will be blank when the message is sent to a nonprogram
message queue.</p>
<p><strong>Receiving procedure name.</strong> The name of the procedure the
message was sent to when the message was sent to a procedure within an ILE
program. A nested procedure name has each procedure name separated by a colon.
The outermost procedure name is identified first followed by the procedures it
contains. The innermost procedure is identified last in the string.</p>
<p><strong>Receiving program name.</strong> The name of the program the message
was sent to, or the Integrated Language Environment (ILE) program name that
contains the procedure receiving the message. This field will be blank when
the message is sent to a nonprogram message queue.</p>
<p><strong>Replacement data CCSID.</strong> The coded character set identifier
(CCSID) that the message data is in. This only applies to the part of the
replacement data that corresponds to a convertible character data type (*CCHAR).
All other replacement data has not be converted and can be considered to have
a CCSID of 65535. If there is no *CHAR replacement data, this field may be
set to 65535.</p>
<p>For more information about message handler and its use of CCSIDS,
see <em> CCSIDS: Message Support </em>in the Gobalization topic. For more
information about the *CCHAR field type, see the <em> Add Message Description </em>
(ADDMSGD) command.
<p><strong>Reserved.</strong> A reserved field. This field must be set to
hexadecimal or binary zero.
<p><strong>Sending module name.</strong> The name of the module the sending
message when the sender is a procedure within an ILE program.</p>
<p><strong>Sending procedure name.</strong> The name of the procedure sending
the message when the sender is a procedure within an ILE program. A nested
procedure name has each procedure name separated by a colon. The outermost
procedure name is identified first followed by the procedures it contains.
The innermost procedure is identified last in the string.</p>
<p><strong>Sending program name.</strong> The program name or ILE program
name that contains the procedure sending the message.</p>
<p><strong>Server type.</strong> The type of server that requested the LIC
Log entry. Server type is blank (hex 40s) if the LIC Log entry was not
requested by a server.</p>
<p><strong>Status of data.</strong> The status of the data listed for this
message. Possible values and their meanings follow:</p>
<table cellpadding="5" border width="80%">
<!-- cols="10 90" -->
<tr>
<td><em>blank</em></td>
<td>The data returned is complete.</td>
</tr>
<tr>
<td><em>A</em></td>
<td>The caller of the API was not authorized to view the data. This occurs
when the caller of the API is not authorized to the message file or message
file library containing a stored message being listed.</td>
</tr>
<tr>
<td><em>D</em></td>
<td>The data was damaged. This occurs when the message file or library
specified at send time for a stored message is damaged when the API is
called.</td>
</tr>
<tr>
<td><em>U</em></td>
<td>The data was unavailable. This occurs when the message file or library
specified at send time for a stored message is exclusively used by another
process when the API is called.</td>
</tr>
<tr>
<td><em>N</em></td>
<td>The data was not found. This occurs when the message file or library
specified at send time for a stored message cannot be found or resolved
when the API is called.</td>
</tr>
</table>
<p>This field is applicable to the field identifiers that are retrieved
from the message file for a stored message. A description of the action
that occurs for specific field identifiers when the status of data field
is not blank follows:</p>
<table cellpadding="15" border width="80%">
<!-- cols="15 85" -->
<tr>
<td><em>0101</em></td>
<td>When the status of data field is not blank, the alert option field identifier
contains blanks.</td>
</tr>
<tr>
<td><em>0301, 0302</em></td>
<td>When the status of data field is not blank, these message field identifiers
contain message text about the problem encountered while attempting to access
the message file. Both fields have the replacement data substituted.</td>
</tr>
<tr>
<td><em>0401, 0402, 0403, 0404</em></td>
<td>When the status of data field is not blank, these message help field identifiers
contain the text of the message regarding the problem encountered while attempting
to access the message file. All fields have the replacement data substituted. The
message help with formatting characters and message help with replacement data and
formatting characters field identifiers also have the message formatting characters
included.</td>
</tr>
<tr>
<td><em>0501</em></td>
<td>When the status of data field is not blank, the default reply field identifier
contains the system default reply.</td>
</tr>
<tr>
<td><em>0801</em></td>
<td>When the status of data field is not blank, the message file library used field
identifier contains blanks.</td>
</tr>
</table>
<p>This field is also applicable to the various sending information fields
(identifiers 0601, 0603) when a problem is encountered while attempting to retrieve
this information. When one of these fields cannot be retrieved from the message:</p>
<ul>
<li>The status of data field is set to N.</li>
<li>The length of data field is set to 0.</li>
</ul>
<p>The status of data field is always blank for the other field identifiers.
The length of data field is zero.</p>
<p><strong>Symbolic message type.</strong> The type assigned to the message when it
was sent. The possible values are:</p>
<table cellpadding="5" border width="50%">
<!-- cols="10 90" -->
<tr>
<td><em>*COMP</em></td>
<td>Completion</td>
</tr>
<tr>
<td><em>*DIAG</em></td>
<td>Diagnostic</td>
</tr>
<tr>
<td><em>*ESCAPE</em></td>
<td>Escape</td>
</tr>
<tr>
<td><em>*INFO</em></td>
<td>Informational</td>
</tr>
<tr>
<td><em>*INQ</em></td>
<td>Inquiry</td>
</tr>
<tr>
<td><em>*NOTIFY</em></td>
<td>Notify</td>
</tr>
<tr>
<td><em>*RQS</em></td>
<td>Request</td>
</tr>
<tr>
<td><em>*STATUS</em></td>
<td>Status</td>
</tr>
</table>
<p><strong>Task name.</strong> The name of the task which requested the
LIC Log entry. Task name is blank (hex 40s) if the LIC Log entry was not
requested by a task.</p>
<p><strong>TDE number.</strong> The number of the task dispatching element
(TDE) which requested the LIC Log entry.</p>
<p><strong>Thread ID.</strong> The thread which requested the LIC Log entry.
Thread identifier is binary zeros if the LIC Log entry was not requested by
a thread.</p>
<p><strong>Time sent.</strong> The time at which the message being listed was
sent, in HHMMSS (hour, minute, and second) format.</p>
<p><strong>Type of data.</strong> The type of data returned.</p>
<table cellpadding="5">
<!-- cols="5 95" -->
<tr>
<td><em>C</em></td>
<td>The data is returned in character format.</td>
</tr>
<tr>
<td><em>B</em></td>
<td>The data is returned in binary format.</td>
</tr>
<tr>
<td><em>M</em></td>
<td>The data is returned in a mixed form</td>
</tr>
</table>
<p><strong>XML data.</strong> The XML data being returned.</p>
<p><strong>XML data length.</strong> The length of the XML object being returned.</p>
<br>
<h3>Error Messages</h3>
<p>The following messages may be sent from this function:</p>
<table width="100%" cellpadding="5">
<!-- cols="15 85" -->
<tr>
<th align="left" valign="top">Message ID</th>
<th align="left" valign="top">Error Message Text</th>
</tr>
<tr>
<td valign="top">CPF0CC1</td>
<td valign="top">Error initializing the XML parser.</td>
</tr>
<tr>
<td valign="top">CPF3C21</td>
<td valign="top">Format name &amp;1 is not valid.</td>
</tr>
<tr>
<td valign="top">CPF3C24</td>
<td valign="top">Length of the receiver variable is not valid.</td>
</tr>
<tr>
<td valign="top">CPF3C36</td>
<td valign="top">Number of parameters, &amp;1, entered for this API
was not valid.</td>
</tr>
<tr>
<td valign="top">CPF3CF1</td>
<td valign="top">Error code parameter not valid.</td>
</tr>
<tr>
<td valign="top">CPF3CF2</td>
<td valign="top">Error(s) occurred during running of &amp;1 API.</td>
</tr>
</table>
<br>
<br>
<p><img src="deltaend.gif" alt="End of change"></p>
<hr>
API introduced: V5R4
<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>
Reference in New Issue Copy Permalink