ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaik_5.4.0.1/rzaikcwbsvlogmessagetext.htm

70 lines
3.4 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="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="reference" />
<meta name="DC.Title" content="cwbSV_LogMessageText" />
<meta name="DC.Relation" scheme="URI" content="rzaiksvcapilist1.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="cwbsv_logmessagetext" />
<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>cwbSV_LogMessageText</title>
</head>
<body id="cwbsv_logmessagetext"><a name="cwbsv_logmessagetext"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">cwbSV_LogMessageText</h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4>
<p>This function will log the supplied message text to the currently active
history log. The product and component ID's set in the entry will be written
along with the date and time of the when the text was logged.</p>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4>
<pre>
unsigned int CWB_ENTRY cwbSV_LogMessageText(
cwbSV_MessageTextHandle messageTextHandle,
char *messageText,
unsigned long messageTextLength);</pre>
</div>
<div class="section"><h4 class="sectiontitle">Parameters</h4>
<dl><dt class="dlterm">cwbSV_MessageTextHandle messageTextHandle - input</dt>
<dd>Handle that was returned by a previous call to cwbSV_CreateMessageTextHandle().</dd>
<dt class="dlterm">char * messageText - input</dt>
<dd>Points to a buffer that contains the message text you want to log.</dd>
<dt class="dlterm">unsigned long messageTextLength - input</dt>
<dd>Specifies the number of bytes in the message text buffer to log for
this message entry.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Return Codes</h4>
<p>The following list shows common return values.</p>
<dl><dt class="dlterm">CWB_OK</dt>
<dd>Successful completion.</dd>
<dt class="dlterm">CWB_INVALID_HANDLE</dt>
<dd>Unusable handle passed in on request.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Usage</h4>
<p>None</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiksvcapilist1.htm" title="Use these APIs to write message text to a history log">Serviceability APIs list: Writing to history log</a></div>
</div>
</div>
</body>
</html>