<?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="Running Format as a standalone program" />
<meta name="abstract" content="" />
<meta name="description" content="" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzahhcommformatutil" />
<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>Running Format as a standalone program</title>
</head>
<body id="rzahhcommformatutil"><a name="rzahhcommformatutil"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Running Format as a standalone program</h1>
<div><p></p>
<div class="section"><p>In addition to using the Format class in your Java™ programs,
you can run it as a standalone, command line utility to format a communications
trace. The program connects an IFSFileOutputStream to the specified outfile
and writes the data to that file.</p>
<p>Running format as a standalone utility
enables you to format files by using the processing power and storage space
of your iSeries™ server.</p>
</div>
<div class="section"><h4 class="sectiontitle">Running Format from a command line</h4><p>To run the Format
utility from a command line prompt, use the following command:</p>
<pre> java com.ibm.as400.commtrace.Format [options]</pre>
<p>where
[options] equals one or more of the available options. Options include:</p>
<ul><li>The system to which you want to connect</li>
<li>The userID and password for the system</li>
<li>The communications trace that you want to parse</li>
<li>The file in which you want to store the results</li>
</ul>
</div>
<div class="section"><p>For a complete list of available options, see the following information:</p>
<blockquote><a href="javadoc/com/ibm/as400/util/commtrace/Format.html">Javadoc
reference documentation for the Format class</a></blockquote>
</div>
<div class="section"><h4 class="sectiontitle">Running Format remotely</h4><p>To run this class remotely
use the JavaApplicationCall class:</p>
<pre> // Construct a JavaApplicationCall object.
jaCall = new JavaApplicationCall(sys);
// Set the Java application you want to run.
jaCall.setJavaApplication("com.ibm.as400.util.commtrace.Format");
// Set the classpath environment variable used by the JVM on
// the server, so it can find the class to run.
jaCall.setClassPath("/QIBM/ProdData/OS400/JT400/lib/JT400Native.jar");
String[] args2 =
{ "-c", "true", "-t", "/path/to/trace", "-o", "/path/to/trace.extension"};
jaCall.setParameters(args2);
if (jaCall.run() != true) {
// Call Failed
}</pre>
</div>
</div>
</body>
</html>