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

72 lines
3.5 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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_LogTraceData" />
<meta name="DC.Relation" scheme="URI" content="rzaiksvcapilist2.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_logtracedata" />
<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_LogTraceData</title>
</head>
<body id="cwbsv_logtracedata"><a name="cwbsv_logtracedata"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">cwbSV_LogTraceData</h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4>
<p>This function will log the supplied trace data to the currently active
trace file. The product and component ID's set in the entry will be written
along with the date and time of the when the data was logged.</p>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4>
<pre>
unsigned int CWB_ENTRY cwbSV_LogTraceData(
cwbSV_TraceDataHandle traceDataHandle,
char *traceData,
unsigned long traceDataLength);</pre>
</div>
<div class="section"><h4 class="sectiontitle">Parameters</h4>
<dl><dt class="dlterm">cwbSV_TraceDataHandle traceDataHandle - input</dt>
<dd>Handle that was returned by a previous call to cwbSV_CreateTraceDataHandle().</dd>
<dt class="dlterm">char * traceData - input</dt>
<dd>Points to a buffer that contains the trace data you want to log. The
buffer can contain binary data because the length parameter is used in determining
the amount to trace.</dd>
<dt class="dlterm">unsigned long traceDataLength - input</dt>
<dd>Specifies the number of bytes in the trace data buffer to log for this
trace 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>Handle is not valid.</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="rzaiksvcapilist2.htm" title="Use these APIs to write trace data to a detail trace file">Serviceability APIs list: Writing trace data</a></div>
</div>
</div>
</body>
</html>