<!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 Message File Attributes (QMHRMFAT) 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. --> <!-- MH1TEMP SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at --> <!-- RCHVMW2 on 26 Jan 1999 at 10:37:34 --> <!--File Edited Sept 2001 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 Message File Attributes (QMHRMFAT) API</h2> <div class="box" style="width: 70%;"> <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="50%">Message file information</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">2</td> <td align="left" valign="top">Length of message file information</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">Format name</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">Qualified message file name</td> <td align="left" valign="top">Input</td> <td align="left" valign="top">Char(20)</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 Message File Attributes (QMHRMFAT) API provides information about the attributes of a message file.</p> <br> <h3>Authorities and Locks</h3> <dl> <dt><em>Message file</em></dt> <dd>*USE</dd> <dt><em>Message file library</em></dt> <dd>*EXECUTE</dd> </dl> <br> <h3>Required Parameter Group</h3> <dl> <dt><strong>Message file information</strong></dt> <dd>OUTPUT; CHAR(*) <p>The parameter to receive the message file information. The format of the returned data is specified in the format name parameter.</p> </dd> <dt><strong>Length of message file information</strong></dt> <dd>INPUT; BINARY(4) <p>The size of the area to contain the message information, in bytes. If the length specified is larger than the actual size of the message file information parameter, the results may not be predictable. The minimum length is 8 bytes.</p> </dd> <dt><strong>Format name</strong></dt> <dd>INPUT; CHAR(8) <p>The format of the information to be returned. You must use the following format name:</p> <table cellpadding="5"> <!-- cols="15 85" --> <tr> <td align="left" valign="top"><em>RMFA0100</em></td> <td align="left" valign="top">This format is described in <a href= "#HDRRMFA100">RMFA0100 Format</a>.</td> </tr> </table> <br> </dd> <dt><strong>Qualified message file name</strong></dt> <dd>INPUT; CHAR(20) <p>The message file and the library in which the message file is located. The first 10 characters contain the message file name, and the second 10 characters contain the message file library. You can use these special values for the library name:</p> <table cellpadding="5"> <!-- cols="15 85" --> <tr> <td align="left" valign="top"><em>*CURLIB</em></td> <td align="left" valign="top">The job's current library</td> </tr> <tr> <td align="left" valign="top"><em>*LIBL</em></td> <td align="left" valign="top">The library list</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> <h3><a name="HDRRMFA100">RMFA0100 Format</a></h3> <p>The following table shows the information returned in the message file information parameter for the RMFA0100 format. For a detailed description of each field, see <a href="#HDRRMFAFD">Field Descriptions</a>.</p> <table border width="80%"> <tr> <th align="center" valign="bottom" colspan="2">Offset</th> <th align="left" valign="bottom" rowspan="2">Type</th> <th align="left" valign="bottom" rowspan="2">Field</th> </tr> <tr> <th align="center" valign="bottom">Dec</th> <th align="center" valign="bottom">Hex</th> </tr> <tr> <td align="center" valign="top" width="10%">0</td> <td align="center" valign="top" width="10%">0</td> <td align="left" valign="top" width="20%">BINARY(4)</td> <td align="left" valign="top" width="60%">Bytes returned</td> </tr> <tr> <td align="center" valign="top">4</td> <td align="center" valign="top">4</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Bytes available</td> </tr> <tr> <td align="center" valign="top">8</td> <td align="center" valign="top">8</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">Message file used</td> </tr> <tr> <td align="center" valign="top">18</td> <td align="center" valign="top">12</td> <td align="left" valign="top">CHAR(10)</td> <td align="left" valign="top">Message file library used</td> </tr> <tr> <td align="center" valign="top">28</td> <td align="center" valign="top">1C</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Current storage size</td> </tr> <tr> <td align="center" valign="top">32</td> <td align="center" valign="top">20</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Increment storage size</td> </tr> <tr> <td align="center" valign="top">36</td> <td align="center" valign="top">24</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Number of increments</td> </tr> <tr> <td align="center" valign="top">40</td> <td align="center" valign="top">28</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Maximum increments</td> </tr> <tr> <td align="center" valign="top">44</td> <td align="center" valign="top">2C</td> <td align="left" valign="top">BINARY(4)</td> <td align="left" valign="top">Coded character set identifier (CCSID)</td> </tr> <tr> <td align="center" valign="top">48</td> <td align="center" valign="top">30</td> <td align="left" valign="top">CHAR(50)</td> <td align="left" valign="top">Text description</td> </tr> </table> <br> <br> <h3><a name="HDRRMFAFD">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>Coded character set identifier (CCSID).</strong> The coded character set identifier (CCSID) associated with this message file. A special value of 65535 means that no conversions are to occur when adding or retrieving message descriptions from this message file. A special value of 65534 means to use the CCSID associated with the message description when conversions are to occur. For more information about message handler use of CCSIDs, see <a href= "../nls/rbagsccsidmsgsup2.htm">CCSIDs: Message Support</a> in the Globalization topic.</p> <p><strong>Current storage size.</strong> The current storage size of the message file in bytes.</p> <p><strong>Increment storage size.</strong> The number of bytes added each time the message file is increased in size.</p> <p><strong>Maximum increments.</strong> The maximum number of times the message file can be increased in size.</p> <p><strong>Message file library used.</strong> The actual library name that contains the message file.</p> <p><strong>Message file used.</strong> The name of the message file whose attributes were returned.</p> <p><strong>Number of increments.</strong> The number of times the message file has been increased in size.</p> <p><strong>Reserved.</strong> An ignored field.</p> <p><strong>Text description.</strong> Text that briefly describes the message file.</p> <br> <h3>Error Messages</h3> <table width="100%" cellpadding="5"> <tr> <th align="left" valign="top">Message ID</th> <th align="left" valign="top">Error Message Text</th> </tr> <tr> <td align="left" valign="top" width="15%">CPF24B4 E</td> <td align="left" valign="top" width="85%">Severe error while addressing parameter list.</td> </tr> <tr> <td align="left" valign="top">CPF2401 E</td> <td align="left" valign="top">Not authorized to library &1.</td> </tr> <tr> <td align="left" valign="top">CPF2407 E</td> <td align="left" valign="top">Message file &1 in &2 not found.</td> </tr> <tr> <td align="left" valign="top">CPF2411 E</td> <td align="left" valign="top">Not authorized to message file &1 in &2.</td> </tr> <tr> <td align="left" valign="top">CPF2483 E</td> <td align="left" valign="top">Message file currently in use.</td> </tr> <tr> <td align="left" valign="top">CPF2536 E</td> <td align="left" valign="top">Value &1, for the length of message queue information not valid.</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">CPF3C21 E</td> <td align="left" valign="top">Format name &1 is not valid.</td> </tr> <tr> <td align="left" valign="top">CPF3C90 E</td> <td align="left" valign="top">Literal value cannot be changed.</td> </tr> <tr> <td align="left" valign="top">CPF9830 E</td> <td align="left" valign="top">Cannot assign library &1.</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= "mh1.htm">Message Handling APIs</a> | <a href="aplist.htm">APIs by category</a></td> </tr> </table> </center> </body> </html>