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

206 lines
6.0 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>Change Logical File Member (CHGLFM)</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="CHGLFM.Top_Of_Page"></a>
<h2>Change Logical File Member (CHGLFM)</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="#CHGLFM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGLFM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGLFM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGLFM"></a>
<p>The Change Logical File Member (CHGLFM) command changes the attributes of a logical file member.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLFM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGLFM.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="#CHGLFM.FILE"><b>FILE</b></a></td>
<td valign="top">Logical file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Logical 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="#CHGLFM.MBR"><b>MBR</b></a></td>
<td valign="top">Logical file member</td>
<td valign="top"><i>Name</i>, *FIRST</td>
<td valign="top">Required, Key, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLFM.SHARE"><b>SHARE</b></a></td>
<td valign="top">Share open data path</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGLFM.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGLFM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGLFM.FILE"></a>
<h3>Logical file (FILE)</h3>
<p>Specifies the logical file that contains the member to be changed.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Logical file</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the logical file.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the file. If no library is specified as the current library, QGPL is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLFM.MBR"></a>
<h3>Logical file member (MBR)</h3>
<p>Specifies the name of the member to be changed.
</p>
<dl>
<dt><b>*FIRST</b></dt>
<dd>The first member of the specified file is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the logical file member to be changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLFM.SHARE"></a>
<h3>Share open data path (SHARE)</h3>
<p>Specifies whether the open data path (ODP) is shared with other programs in the same routing step. When an ODP is shared, the programs accessing the file share facilities such as the file status and the buffer.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The member's ODP sharing value does not change.
</dd>
</dl>
<dl>
<dt><b>*NO</b></dt>
<dd>The ODP is not shared with other programs in the routing step. A new ODP for the file is created and used every time a program opens the file.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>The same ODP is shared with each program in the job that also specifies *YES when it opens the file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLFM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGLFM.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The text that describes the member does not change.
</dd>
<dt><b>*BLANK</b></dt>
<dd>No text is specified.
</dd>
</dl>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
<dl>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLFM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGLFM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGLFM FILE(*CURLIB/INV) MBR(FEB)
TEXT('Logical file member for FEB')
</pre>
</p>
<p>The command changes the text for the member named FEB in the logical file INV that is found in the specified current library.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLFM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGLFM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF3288</b></dt>
<dd>Member &amp;3 file &amp;1 in &amp;2 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGLFM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>