ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/cmppfm.htm

526 lines
21 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Compare Physical File Member (CMPPFM)</title>
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body bgcolor="white">
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<a name="CMPPFM.Top_Of_Page"></a>
<h2>Compare Physical File Member (CMPPFM)</h2>
<table width="100%">
<tr>
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
<b>Threadsafe: </b>No
</td>
<td valign="top" align="right">
<a href="#CMPPFM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CMPPFM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CMPPFM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CMPPFM"></a>
<p>This command allows you to compare source physical file members.
</p>
<h3>Error messages for CMPPFM</h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CMPPFM.PARAMETERS.TABLE">Parameters</a></h3>
<table border="1" cellpadding="4" cellspacing="0">
<!-- col1="10" col2="15" col3="30" col4="10" -->
<tr>
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CMPPFM.NEWFILE"><b>NEWFILE</b></a></td>
<td valign="top">New file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: New file</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CMPPFM.NEWMBR"><b>NEWMBR</b></a></td>
<td valign="top">New member</td>
<td valign="top">Single values: <b><u>*FIRST</u></b>, *ALL<br>Other values (up to 25 repetitions): <i>Character value</i></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CMPPFM.OLDFILE"><b>OLDFILE</b></a></td>
<td valign="top">Old file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Old file</td>
<td valign="top"><i>Name</i>, <b><u>*NEWFILE</u></b></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CMPPFM.OLDMBR"><b>OLDMBR</b></a></td>
<td valign="top">Old member</td>
<td valign="top">Single values: <b><u>*NEWMBR</u></b>, *FIRST<br>Other values (up to 25 repetitions): <i>Name</i></td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top"><a href="#CMPPFM.CMPTYPE"><b>CMPTYPE</b></a></td>
<td valign="top">Compare type</td>
<td valign="top"><b><u>*LINE</u></b>, *FILE, *WORD</td>
<td valign="top">Optional, Positional 5</td>
</tr>
<tr>
<td valign="top"><a href="#CMPPFM.RPTTYPE"><b>RPTTYPE</b></a></td>
<td valign="top">Report type</td>
<td valign="top"><b><u>*DIFF</u></b>, *SUMMARY, *CHANGE, *DETAIL</td>
<td valign="top">Optional, Positional 6</td>
</tr>
<tr>
<td valign="top"><a href="#CMPPFM.OUTPUT"><b>OUTPUT</b></a></td>
<td valign="top">Output</td>
<td valign="top"><b><u>*</u></b>, *PRINT, *OUTFILE</td>
<td valign="top">Optional, Positional 7</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CMPPFM.OUTFILE"><b>OUTFILE</b></a></td>
<td valign="top">File to receive output</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 8</td>
</tr>
<tr>
<td valign="top">Qualifier 1: File to receive output</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top" rowspan="3"><a href="#CMPPFM.OUTMBR"><b>OUTMBR</b></a></td>
<td valign="top">Output member options</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional, Positional 9</td>
</tr>
<tr>
<td valign="top">Element 1: Member to receive output</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Replace or add records</td>
<td valign="top">
<b><u>*REPLACE</u></b>, *ADD</td>
</tr>
<tr>
<td valign="top"><a href="#CMPPFM.SRCTYPE"><b>SRCTYPE</b></a></td>
<td valign="top">Select source type</td>
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b></td>
<td valign="top">Optional, Positional 10</td>
</tr>
<tr>
<td valign="top"><a href="#CMPPFM.OPTION"><b>OPTION</b></a></td>
<td valign="top">Process option</td>
<td valign="top">Values (up to 10 repetitions): *IGNORECASE, *COUNT, *CBLSRCCOL, *RPGSRCCOL, *RPGLESRCCOL, *OMTDUP, *OMTREFMT, *OMTBASCMT, *OMTBLANK, *OMTCCMT, *OMTCBLCMT, *OMTCLCMT, *OMTCMDCMT, *OMTDDSCMT, *OMTPASCMT, *OMTPLICMT, *OMTRPGCMT, *OMTRPGLECMT, *FLGMOVLIN, *CHGFLGS, *CHANGES, *LONGLINES, *NARROW, *CMPSEQDAT, *COUNTREFMT, *WIDE</td>
<td valign="top">Optional, Positional 11</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CMPPFM.STMTFILE"><b>STMTFILE</b></a></td>
<td valign="top">Statement file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 12</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Statement file</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: Library</td>
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CMPPFM.STMTMBR"><b>STMTMBR</b></a></td>
<td valign="top">Statement member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b></td>
<td valign="top">Optional, Positional 13</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CMPPFM.NEWFILE"></a>
<h3>New file (NEWFILE)</h3>
<p>Identifies the new physical file containing the members to be compared.
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>Use the library list of the job.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library of the job.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Use the specified library.
</dd>
<dt><b><i>new-file-name</i></b></dt>
<dd>Use the specified new file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.NEWMBR"></a>
<h3>New member (NEWMBR)</h3>
<p>Identifies the members to be compared in the new file.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>Use the first member of the file.
</dd>
<dt><b><i>new-file-member-name</i></b></dt>
<dd>Use the specified member or list of members.
<p>To enter multiple values for this parameter, type a plus sign (+) in the <u> + for more</u> prompt, and press the Enter key.
</p>
</dd>
<dt><b><i>generic*</i></b></dt>
<dd>Use the members that match the specified pattern.
</dd>
<dt><b>*ALL</b></dt>
<dd>Use all members in the file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.OLDFILE"></a>
<h3>Old file (OLDFILE)</h3>
<p>Identifies the old physical file containing the members to be compared.
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>Use the library list of the job.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library of the job.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Use the specified library.
</dd>
<dt><b><u>*NEWFILE</u></b></dt>
<dd>Use the old file with the same name as is specified for the NEWFILE keyword.
</dd>
<dt><b><i>old-file-name</i></b></dt>
<dd>Use the specified old file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.OLDMBR"></a>
<h3>Old member (OLDMBR)</h3>
<p>Identifies the members to be compared in the old file.
</p>
<dl>
<dt><b><u>*NEWMBR</u></b></dt>
<dd>Use the same member or member list as is specified for the NEWMBR keyword.
</dd>
<dt><b><i>old-file-member-name</i></b></dt>
<dd>Use the specified member or list of members.
<p>To enter multiple values for this parameter, type a plus sign (+) in the <u> + for more</u> prompt, and press the Enter key.
</p>
</dd>
<dt><b>*FIRST</b></dt>
<dd>Use the first member of the file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.CMPTYPE"></a>
<h3>Compare type (CMPTYPE)</h3>
<p>Specifies the type of comparison to be performed.
</p>
<dl>
<dt><b><u>*LINE</u></b></dt>
<dd>Compare for differences on a line level, identifying inserted and deleted lines.
</dd>
<dt><b>*FILE</b></dt>
<dd>Compare for differences on a file level, without reporting where the differences are. The results of this type of comparison indicate whether the members compared are different or the same, and provide the names of any nonpaired members. This method produces only summary information, but is the fastest type of comparison.
</dd>
<dt><b>*WORD</b></dt>
<dd>Compare for differences on a word level. This comparison is similar to the *LINE comparison, except words on adjacent lines can be matched. Words are delimited by blanks or the end of a line. The members are processed as long sequences of words without line boundaries or record lengths. The output of this comparison does not necessarily maintain the original spacing between words. Blanks may be added in the output listing so that you can clearly see the differences.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.RPTTYPE"></a>
<h3>Report type (RPTTYPE)</h3>
<p>Specifies the listing type for the result report.
</p>
<dl>
<dt><b><u>*DIFF</u></b></dt>
<dd>List only the differences between the members being compared, followed by a summary. The differences are flagged in the listing.
</dd>
<dt><b>*SUMMARY</b></dt>
<dd>List a summary of the results of the comparison, without showing the detailed differences. A group comparison generates an individual summary line for each member in the group, as well as the list of processing options.
</dd>
<dt><b>*CHANGE</b></dt>
<dd>Provide the same information as the *DIFF report type, with 10 lines before and after the differences. The extra lines allow you to see the differences within the context of the surrounding data.
</dd>
<dt><b>*DETAIL</b></dt>
<dd>List the entire new file member (and deletions from the old file member), indicate the differences, and provide a summary of the results.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.OUTPUT"></a>
<h3>Output (OUTPUT)</h3>
<p>Specifies whether the result of the comparison is displayed, printed, or stored to a physical file.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>Display the result.
</dd>
<dt><b>*PRINT</b></dt>
<dd>Print the result to the spooled file.
</dd>
<dt><b>*OUTFILE</b></dt>
<dd>Store the result to a physical file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.OUTFILE"></a>
<h3>File to receive output (OUTFILE)</h3>
<p>Specifies the file to which the output results are directed.
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>Use the library list of the job.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library of the job.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Use the specified library.
</dd>
<dt><b><i>output-physical-file-name</i></b></dt>
<dd>Use the specified physical file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.OUTMBR"></a>
<h3>Output member options (OUTMBR)</h3>
<p>Specifies the member to which the output is directed. Do not specify a value for this parameter if the OUTFILE keyword specifies a printer file.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>Use the first member of the file.
</dd>
<dt><b><i>output-file-member-name</i></b></dt>
<dd>Use the specified member.
</dd>
<dt><b><u>*REPLACE</u></b></dt>
<dd>If the member exists, replace it.
</dd>
<dt><b>*ADD</b></dt>
<dd>Add this member to the file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.SRCTYPE"></a>
<h3>Select source type (SRCTYPE)</h3>
<p>Specifies the source member type to be compared. One type or all types can be selected.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Compare all source members.
</dd>
<dt><b><i>source-member-type</i></b></dt>
<dd>Compare only the members with the specified source type.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.OPTION"></a>
<h3>Process option (OPTION)</h3>
<p>Specifies a list of process options to customize the comparison. You can specify up to 10 process options in the list.
</p>
<p>To enter multiple values for this parameter, type a plus sign (+) in the <u> + for more</u> prompt, and press the Enter key.
</p>
<p>
<b>Note: </b>When you use the OMTxxx options to omit comments, the utility may recognize some non-comment strings as comments.
</p>
<p>For example, if the string /*...*/ is imbedded within a program's executable code, the string may or may not be ignored during processing if you have used the *OMTCCMT process option.
</p>
<dl>
<dt><b>*CBLSRCCOL</b></dt>
<dd>Compare only COBOL source columns (7-72 inclusive). This option limits the scope of the comparison to the source code column area. This option is valid for line and word comparisons.
</dd>
<dt><b>*CHANGES</b></dt>
<dd>List only changed entries in the summary. Normally, all paired members are listed in a group comparison. When you specify *CHANGES in a group comparison, only the member pairs with changes are listed in the summary section. This option is valid for line, file, and word comparisons.
</dd>
<dt><b>*CHGFLGS</b></dt>
<dd>Generate listings denoting changes in the new file by placing a change flag (&gt;) in column one of the appropriate line in the new file. Deleted lines are indicated by flagging the line following the deletion. This option is valid for line and word comparisons.
</dd>
<dt><b>*CMPSEQDAT</b></dt>
<dd>Set the origin of the source sequence to 1. Compares the sequence and date fields of the source physical file member. This option is valid for line and word comparisons.
</dd>
<dt><b>*COUNT</b></dt>
<dd>Count the lines from nonpaired members in a group (line) comparison, and include the results in the summary. If this option is not used, you only obtain statistics on lines from paired members.
</dd>
<dt><b>*COUNTREFMT</b></dt>
<dd>Reformatted lines are not flagged, but they are counted for the overall summary statistics. This option is valid for line and word comparisons.
</dd>
<dt><b>*FLGMOVLIN</b></dt>
<dd>Flag moved lines. Identify inserted lines in the new file that match deleted lines in the old file. This option is valid only for line comparisons.
</dd>
<dt><b>*IGNORECASE</b></dt>
<dd>Ignore differences due to case (upper, lower, mixed). This option is valid for line and word comparisons.
</dd>
<dt><b>*LONGLINES</b></dt>
<dd>Create a listing with 198 columns, reflecting up to 176 columns from the files. This option is valid for line comparisons.
</dd>
<dt><b>*NARROW</b></dt>
<dd>Create a 132 listing file with 55 columns for each side. Inserted and deleted lines are flagged and appear side-by-side in the listing output. This option is valid for line comparisons.
</dd>
<dt><b>*OMTBASCMT</b></dt>
<dd>Omit BASIC comments. BASIC comments are blanked out and excluded.
</dd>
<dt><b>*OMTBLANK</b></dt>
<dd>Omit lines in which the columns being compared are blank. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTCBLCMT</b></dt>
<dd>Omit COBOL comments. COBOL comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTCCMT</b></dt>
<dd>Omit C comments. C comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTCLCMT</b></dt>
<dd>Omit CL comments. CL program comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTCMDCMT</b></dt>
<dd>Omit CMD comments. CL command comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTDDSCMT</b></dt>
<dd>Omit DDS comments. DDS comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTDUP</b></dt>
<dd>Omit duplicate lines. Old file source lines that match new file source lines are omitted from the side-by-side listing. This option is valid for line comparisons.
</dd>
<dt><b>*OMTPASCMT</b></dt>
<dd>Omit Pascal comments. Pascal comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTPLICMT</b></dt>
<dd>Omit PLI comments. PLI comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTREFMT</b></dt>
<dd>Omit reformatted lines. Reformatted lines in the old file member are omitted from the listing. Reformatted lines in the new file member are included in the listing. Normally both are listed. This option is valid for line comparisons.
</dd>
<dt><b>*OMTRPGCMT</b></dt>
<dd>Omit RPG comments. RPG comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*OMTRPGLECMT</b></dt>
<dd>Omit ILE RPG comments. ILE RPG comments and blank lines are excluded from the compare set, to yield a listing with all comments removed or blanked out. This option is valid for line and word comparisons.
</dd>
<dt><b>*RPGLESRCCOL</b></dt>
<dd>Compare only ILE RPG source columns (6-100 inclusive). This limits the comparison scope to the source code column area. This option is valid for line and word comparisons.
</dd>
<dt><b>*RPGSRCCOL</b></dt>
<dd>Compare only RPG source columns (6-74 inclusive). This limits the comparison scope to the source code column area. This option is valid for line and word comparisons.
</dd>
<dt><b>*WIDE</b></dt>
<dd>Create a wide 198 side-by-side (80 columns per side) listing. This option is valid for line and word comparisons.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.STMTFILE"></a>
<h3>Statement file (STMTFILE)</h3>
<p>Specifies a user-defined source physical file that holds process statements. Records in this file can be of any length, but only the first 80 bytes are read.
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>Use the library list of the job.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library of the job.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Use the specified library.
</dd>
<dt><b><i>statement-file-name</i></b></dt>
<dd>Use the specified file as the statement file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CMPPFM.STMTMBR"></a>
<h3>Statement member (STMTMBR)</h3>
<p>Specifies the file member containing the process statements to use in the comparison.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>Use the first member of the file.
</dd>
<dt><b><i>statement-file-member-name</i></b></dt>
<dd>Use the specified member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CMPPFM.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CMPPFM.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CMPPFM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>