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

302 lines
9.0 KiB
HTML

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Merge Source (MRGSRC)</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="MRGSRC.Top_Of_Page"></a>
<h2>Merge Source (MRGSRC)</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="#MRGSRC.PARAMETERS.TABLE">Parameters</a><br>
<a href="#MRGSRC.COMMAND.EXAMPLES">Examples</a><br>
<a href="#MRGSRC.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="MRGSRC"></a>
<p>This command allows you to merge updates from maintenance file members into target file members.
</p>
<p>You provide the MRGSRC command with the names of the following source files:
</p>
<dl>
<dt><b>Root</b></dt>
<dd>The original version of the source file, on which the updates are based
</dd>
<dt><b>Maintenance</b></dt>
<dd>The source file containing the updates to be merged into the target file
</dd>
<dt><b>Target</b></dt>
<dd>The source file into which the updates from the maintenance file are merged
</dd>
</dl>
<p>The MRGSRC command compares each target member and maintenance member with its corresponding root member. The results of these comparisons are used to determine the updates that have occurred.
</p>
<h3>Error messages for MRGSRC</h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="MRGSRC.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="#MRGSRC.TGTFILE"><b>TGTFILE</b></a></td>
<td valign="top">Target 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: Target 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="#MRGSRC.TGTMBR"><b>TGTMBR</b></a></td>
<td valign="top">Target member</td>
<td valign="top"><i>Name</i>, *ALL</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#MRGSRC.MAINTFILE"><b>MAINTFILE</b></a></td>
<td valign="top">Maintenance 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: Maintenance file</td>
<td valign="top"><i>Name</i>, <b><u>*TARGET</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="#MRGSRC.MAINTMBR"><b>MAINTMBR</b></a></td>
<td valign="top">Maintenance member</td>
<td valign="top"><i>Name</i>, <b><u>*TARGET</u></b></td>
<td valign="top">Optional, Positional 4</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#MRGSRC.ROOTFILE"><b>ROOTFILE</b></a></td>
<td valign="top">Root file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 5</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Root file</td>
<td valign="top"><i>Name</i>, <b><u>*MAINT</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="#MRGSRC.ROOTMBR"><b>ROOTMBR</b></a></td>
<td valign="top">Root member</td>
<td valign="top"><i>Name</i>, <b><u>*MAINT</u></b></td>
<td valign="top">Optional, Positional 6</td>
</tr>
<tr>
<td valign="top"><a href="#MRGSRC.SELECT"><b>SELECT</b></a></td>
<td valign="top">Select updates</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#MRGSRC.RPTONLY"><b>RPTONLY</b></a></td>
<td valign="top">Report only</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="MRGSRC.TGTFILE"></a>
<h3>Target file (TGTFILE)</h3>
<p>Specifies the source physical file into which the maintenance updates are merged.
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>Use the library list.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Use the specified library.
</dd>
<dt><b><i>file-name</i></b></dt>
<dd>Use the specified file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGSRC.TGTMBR"></a>
<h3>Target member (TGTMBR)</h3>
<p>Specifies the member into which the maintenance updates are merged.
</p>
<dl>
<dt><b>*ALL</b></dt>
<dd>Select all members.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Select the specified member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGSRC.MAINTFILE"></a>
<h3>Maintenance file (MAINTFILE)</h3>
<p>Specifies the source physical file containing the updates to merge.
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>Use the library list.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Use the specified library.
</dd>
<dt><b><u>*TARGET</u></b></dt>
<dd>Use the file specified for the target file.
</dd>
<dt><b><i>file-name</i></b></dt>
<dd>Use the specified file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGSRC.MAINTMBR"></a>
<h3>Maintenance member (MAINTMBR)</h3>
<p>Specifies the member containing the updates to merge.
</p>
<dl>
<dt><b><u>*TARGET</u></b></dt>
<dd>Select the same member as is specified for the TGTMBR keyword.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Select the specified member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGSRC.ROOTFILE"></a>
<h3>Root file (ROOTFILE)</h3>
<p>Specifies the source file on which the merge process is based.
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>Use the library list.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>Use the current library.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Use the specified library.
</dd>
<dt><b><u>*MAINT</u></b></dt>
<dd>Use the file specified for the maintenance file.
</dd>
<dt><b><i>file-name</i></b></dt>
<dd>Use the specified file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGSRC.ROOTMBR"></a>
<h3>Root member (ROOTMBR)</h3>
<p>Specifies the source file member on which the merge process is based.
</p>
<dl>
<dt><b><u>*MAINT</u></b></dt>
<dd>Select the same member as is specified for the MAINTMBR parameter. This parameter is required if TGTMBR(*ALL) is specified.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Select the specified member.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGSRC.SELECT"></a>
<h3>Select updates (SELECT)</h3>
<p>Specifies whether to show the Split Merge display for selecting the maintenance updates.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Show the Split Merge display so that you can select the maintenance updates to merge into the target member. No report is generated.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not show the Split Merge display, and print a Merge Summary report.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MRGSRC.RPTONLY"></a>
<h3>Report only (RPTONLY)</h3>
<p>Indicates whether to merge the maintenance updates into the target member or just print a Merge Summary report to show the scope of the updates.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Perform the merge and print a Merge Summary report.
</dd>
<dt><b>*YES</b></dt>
<dd>Print the Merge Summary report without performing the merge.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="MRGSRC.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="MRGSRC.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#MRGSRC.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>