158 lines
11 KiB
HTML
158 lines
11 KiB
HTML
|
<?xml version="1.0" encoding="UTF-8"?>
|
|||
|
|
<!DOCTYPE html
|
|||
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|||
|
|
<html lang="en-us" xml:lang="en-us">
|
|||
|
|
<head>
|
|||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|||
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
|
|||
|
|
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
|
|||
|
|
<meta name="security" content="public" />
|
|||
|
|
<meta name="Robots" content="index,follow" />
|
|||
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|||
|
|
<meta name="DC.Type" content="concept" />
|
|||
|
|
<meta name="DC.Title" content="Messages and message monitors in files by the server" />
|
|||
|
|
<meta name="abstract" content="Displayed messages are the primary source of information for an operator or a programmer who is testing a new application. A message typically contains more specific information than the file status code, the indicators, and the major and minor return code. The control language lets you monitor messages so that the CL program can intercept a message and take corrective action." />
|
|||
|
|
<meta name="description" content="Displayed messages are the primary source of information for an operator or a programmer who is testing a new application. A message typically contains more specific information than the file status code, the indicators, and the major and minor return code. The control language lets you monitor messages so that the CL program can intercept a message and take corrective action." />
|
|||
|
|
<meta name="DC.subject" content="displayed message, message, diagnostic, data management, message number ranges, file error ranges, displayed" />
|
|||
|
|
<meta name="keywords" content="displayed message, message, diagnostic, data management, message number ranges, file error ranges, displayed" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rbal3ts.htm" />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="../rbam6/rbam6clmain.htm" />
|
|||
|
|
<meta name="DC.Format" content="XHTML" />
|
|||
|
|
<meta name="DC.Identifier" content="rbal3mmm" />
|
|||
|
|
<meta name="DC.Language" content="en-us" />
|
|||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|||
|
|
<!-- US Government Users Restricted Rights -->
|
|||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|||
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|||
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|||
|
|
<title>Messages and message monitors in files by the server</title>
|
|||
|
|
</head>
|
|||
|
|
<body id="rbal3mmm"><a name="rbal3mmm"><!-- --></a>
|
|||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|||
|
|
<h1 class="topictitle1">Messages and message monitors in files by the server</h1>
|
|||
|
|
<div><p>Displayed messages are the primary source of information for an
|
|||
|
|
operator or a programmer who is testing a new application. A message typically
|
|||
|
|
contains more specific information than the file status code, the indicators,
|
|||
|
|
and the major and minor return code. The control language lets you monitor
|
|||
|
|
messages so that the CL program can intercept a message and take corrective
|
|||
|
|
action.</p>
|
|||
|
|
<p>The Messages section in the CL topic more
|
|||
|
|
information about message types and message monitors. In most high-level languages,
|
|||
|
|
the file status code and return codes (which are described in the following
|
|||
|
|
section) are more convenient sources of information.</p>
|
|||
|
|
<p>Message numbers are assigned in categories to make it easier for a program
|
|||
|
|
to monitor for a group of related messages. The table below shows the message
|
|||
|
|
number ranges that are assigned for file error messages.</p>
|
|||
|
|
|
|||
|
|
<div class="tablenoborder"><a name="rbal3mmm__rbal3msg"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rbal3mmm__rbal3msg" width="100%" frame="hsides" border="0" rules="none"><caption>Table 1. <span class="keyword">OS/400<sup>®</sup></span> File
|
|||
|
|
Management Message Number Ranges. Message number ranges that are
|
|||
|
|
assigned for file error messages, in order to make it easier for a program
|
|||
|
|
to monitor for a group of related messages.</caption><thead align="left"><tr><th align="left" valign="bottom" width="33.33333333333333%" id="d0e46">Message IDs</th>
|
|||
|
|
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e48">Operation</th>
|
|||
|
|
<th align="left" valign="bottom" width="33.33333333333333%" id="d0e50">Message Type</th>
|
|||
|
|
</tr>
|
|||
|
|
</thead>
|
|||
|
|
<tbody><tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF4001-40FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">Open</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Diagnostic and status.</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e48 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e50 "> </td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF4101-43FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">Open</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Escapes that make the file unusable.</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e48 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e50 "> </td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF4401-44FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">Close</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Diagnostic and status.</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e48 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e50 "> </td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF4501-46FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">Close</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Escapes that make the file unusable.</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e48 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e50 "> </td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF4701-48FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">I/O, Acquire, and Release</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Notify with a default reply of cancel, status
|
|||
|
|
and escapes that do not make the file or device unusable.</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e48 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e50 "> </td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF4901-49FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">I/O, Acquire, and Release</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Notify with a default reply of ignore or
|
|||
|
|
go.</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e48 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e50 "> </td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF5001-50FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">I/O, Acquire, and Release</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Notify with a default reply of cancel.</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e48 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e50 "> </td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF5101-53FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">I/O, Acquire, and Release</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Escapes that make the file or device unusable.</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e48 "> </td>
|
|||
|
|
<td valign="top" width="33.33333333333333%" headers="d0e50 "> </td>
|
|||
|
|
</tr>
|
|||
|
|
<tr><td align="left" valign="top" width="33.33333333333333%" headers="d0e46 ">CPF5501-56FF</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e48 ">I/O, Acquire, and Release</td>
|
|||
|
|
<td align="left" valign="top" width="33.33333333333333%" headers="d0e50 ">Escapes that make the file or device unusable.</td>
|
|||
|
|
</tr>
|
|||
|
|
</tbody>
|
|||
|
|
</table>
|
|||
|
|
</div>
|
|||
|
|
<p>Some status messages, CPF4018 for example, are preceded by a diagnostic
|
|||
|
|
message that provides additional information. Diagnostic messages can be kept
|
|||
|
|
in the job log, depending on the message logging level of the job. If a CL
|
|||
|
|
program monitors for CPF4018, CPF5041, or similar messages, it can retrieve
|
|||
|
|
the accompanying diagnostic message from the program message queue.</p>
|
|||
|
|
<p>If an error occurs for which an escape message is issued and the message
|
|||
|
|
is not monitored, your program will be ended and the message displayed for
|
|||
|
|
the operator. You can also monitor status messages, but if you do not monitor
|
|||
|
|
them the program continues. Most high-level languages except CL monitor for
|
|||
|
|
all the file errors that you are likely to encounter, and provide some standard
|
|||
|
|
recovery. Depending on the serverity of the error, the high-level language
|
|||
|
|
might end the program and issue a message of its own. Alternatively, the application
|
|||
|
|
programmer can code an error recovery routine to handle errors that are anticipated
|
|||
|
|
in that particular application.</p>
|
|||
|
|
<p>Within these error-handling routines, it is typically necessary to examine
|
|||
|
|
the file status or major and minor return codes to determine the cause of
|
|||
|
|
the error. The books for the language you are using explain how to access
|
|||
|
|
file status and major and minor return codes. The information for each language
|
|||
|
|
also explains the file status codes as each language defines them.</p>
|
|||
|
|
</div>
|
|||
|
|
<div>
|
|||
|
|
<div class="familylinks">
|
|||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3ts.htm" title="iSeries provides server reports and error messages when errors occur. You can take corresponding actions according to the errors.">Troubleshoot database file management</a></div>
|
|||
|
|
</div>
|
|||
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
|||
|
|
<div><a href="../rbam6/rbam6clmain.htm">Control language (CL)</a></div>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
</body>
|
|||
|
|
</html>
|