349 lines
11 KiB
HTML
349 lines
11 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>Change S/36 Source Attributes (CHGS36SRCA)</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="CHGS36SRCA.Top_Of_Page"></a>
|
|
<h2>Change S/36 Source Attributes (CHGS36SRCA)</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="#CHGS36SRCA.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGS36SRCA.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGS36SRCA.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGS36SRCA"></a>
|
|
<p>The Change System/36 Source Attributes (CHGS36SRCA) command changes the attributes of the specified source member.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGS36SRCA.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"><a href="#CHGS36SRCA.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">S/36 source member</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Key, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGS36SRCA.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Source file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Key, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Source file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QS36SRC</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="#CHGS36SRCA.SRCTYPE"><b>SRCTYPE</b></a></td>
|
|
<td valign="top">Source type</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, ARS36, ASM36, BASP36, BAS36, BGC36, BGD36, BGF36, CBL36, DFU36, DSPF36, DTA36, FOR36, MNU36, MSGF36, PHL36, RPG36, RPT36, SRT36, WSU36, UNS36</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGS36SRCA.REFNBR"><b>REFNBR</b></a></td>
|
|
<td valign="top">Reference number</td>
|
|
<td valign="top">0-999999, <b><u>*SAME</u></b>, *NEXT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGS36SRCA.RCDLEN"><b>RCDLEN</b></a></td>
|
|
<td valign="top">Logical record length</td>
|
|
<td valign="top">40-120, <b><u>*SAME</u></b>, *FILE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGS36SRCA.MAXDEV"><b>MAXDEV</b></a></td>
|
|
<td valign="top">Maximum devices</td>
|
|
<td valign="top">0-256, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGS36SRCA.DFRWRT"><b>DFRWRT</b></a></td>
|
|
<td valign="top">Defer write</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGS36SRCA.MBR"></a>
|
|
<h3>S/36 source member (MBR)</h3>
|
|
<p>Specifies the name of the source member that is having its attributes changed.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>source-member-name</i></b></dt>
|
|
<dd>Specify the name of the source member.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGS36SRCA.FILE"></a>
|
|
<h3>Source file (FILE)</h3>
|
|
<p>Specifies the name of the physical file containing the source member.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QS36SRC</u></b></dt>
|
|
<dd>Specifies the name of the default physical file.
|
|
</dd>
|
|
<dt><b><i>source-file-name</i></b></dt>
|
|
<dd>Specify the name of the physical file.
|
|
</dd>
|
|
</dl>
|
|
<p>The possible library values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>The library list is used to locate the file.
|
|
</dd>
|
|
<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 for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGS36SRCA.SRCTYPE"></a>
|
|
<h3>Source type (SRCTYPE)</h3>
|
|
<p>Specifies the source type of the source member.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The SRCTYPE value does not change.
|
|
</dd>
|
|
<dt><b><i>source-type</i></b></dt>
|
|
<dd>Specify the source type of the source member.
|
|
<dl>
|
|
<dt><b>Value</b></dt>
|
|
<dd><b> Type of Member
|
|
</b></dd>
|
|
<dt><b>ARS36</b></dt>
|
|
<dd>Automatic response member
|
|
</dd>
|
|
<dt><b>ASM36</b></dt>
|
|
<dd>Assembler member
|
|
</dd>
|
|
<dt><b>BASP36</b></dt>
|
|
<dd>BASIC procedure (source member)
|
|
</dd>
|
|
<dt><b>BAS36</b></dt>
|
|
<dd>BASIC member
|
|
</dd>
|
|
<dt><b>BGC36</b></dt>
|
|
<dd>Business graphics utility member
|
|
</dd>
|
|
<dt><b>BGD36</b></dt>
|
|
<dd>Business graphics utility data member
|
|
</dd>
|
|
<dt><b>BGF36</b></dt>
|
|
<dd>Business graphics utility format member
|
|
</dd>
|
|
<dt><b>CBL36</b></dt>
|
|
<dd>COBOL member
|
|
</dd>
|
|
<dt><b>DFU36</b></dt>
|
|
<dd>Data file utility member
|
|
</dd>
|
|
<dt><b>DSPF36</b></dt>
|
|
<dd>Display format member
|
|
</dd>
|
|
<dt><b>DTA36</b></dt>
|
|
<dd>Data member
|
|
</dd>
|
|
<dt><b>FOR36</b></dt>
|
|
<dd>FORTRAN member
|
|
</dd>
|
|
<dt><b>MNU36</b></dt>
|
|
<dd>Menu member
|
|
</dd>
|
|
<dt><b>MSGF36</b></dt>
|
|
<dd>Message member
|
|
</dd>
|
|
<dt><b>PHL36</b></dt>
|
|
<dd>Telephone list member
|
|
</dd>
|
|
<dt><b>RPG36</b></dt>
|
|
<dd>RPG for iSeries member
|
|
</dd>
|
|
<dt><b>RPT36</b></dt>
|
|
<dd>RPG for iSeries automatic report member
|
|
</dd>
|
|
<dt><b>SRT36</b></dt>
|
|
<dd>Sort member
|
|
</dd>
|
|
<dt><b>WSU36</b></dt>
|
|
<dd>Work station utility member
|
|
</dd>
|
|
<dt><b>UNS36</b></dt>
|
|
<dd>Unspecified
|
|
</dd>
|
|
</dl>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGS36SRCA.REFNBR"></a>
|
|
<h3>Reference number (REFNBR)</h3>
|
|
<p>Specifies the reference number assigned to the source member.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The REFNBR value does not change.
|
|
</dd>
|
|
<dt><b>*NEXT</b></dt>
|
|
<dd>The current reference number is increased by one.
|
|
</dd>
|
|
<dt><b><i>reference-number</i></b></dt>
|
|
<dd>Specify the reference number of the procedure member. Valid values range from 0 through 999,999.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGS36SRCA.RCDLEN"></a>
|
|
<h3>Logical record length (RCDLEN)</h3>
|
|
<p>Specifies the logical record length of the statements in the source member.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGS36SRCA.MAXDEV"></a>
|
|
<h3>Maximum devices (MAXDEV)</h3>
|
|
<p>Specifies the maximum number of devices for an SFGR source member.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The maximum number of devices does not change.
|
|
</dd>
|
|
<dt><b><i>number-of-devices</i></b></dt>
|
|
<dd>Specify the maximum number of devices for a source member. Valid values range from 0 through 256.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGS36SRCA.DFRWRT"></a>
|
|
<h3>Defer write (DFRWRT)</h3>
|
|
<p>Specifies that the writing of data to the display file is delayed until a read operation is requested. Control is returned to the requesting program immediately after the data is received for output. This may result in improved performance.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The postpone option does not change. If the DFRWRT source attribute has not been set, *YES is used.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>When a write request is made, control is returned after the buffer is processed. The actual display of data may take place later when a read or combined read/write operation is performed. The program buffer is immediately available for the next read or combined read/write operation.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>When a write request is made, control is not returned to the requesting program until the input/output request is completed. The data is shown and the input/output feedback information is available.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGS36SRCA.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Specifying Maximum Devices and Record Length</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGS36SRCA MBR(SFGRSRC) FILE(SDALIB/QS36SRC) REFNBR(*NEXT)
|
|
RCDLEN(80) MAXDEV(5)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes source member SFGRSRC in file QS36SRC in library SDALIB to allow up to five devices and to have a record length of 80. It also increases the current reference number by one.
|
|
</p>
|
|
<p><b>Example 2: Turning Off the Defer Write Attribute</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGS36SRCA MBR(SFGRSRC) FILE(SDALIB/QS36SRC) REFNBR(*NEXT)
|
|
RCDLEN(80) MAXDEV(5) DFRWRT(*NO)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes source member SFGRSRC in the file QS36SRC in library SDALIB to allow up to five devices and to have a record length of 80. It also increases the current reference number by one and turns off the defer write attribute.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGS36SRCA.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2C0A</b></dt>
|
|
<dd>Member &3 attributes not changed.
|
|
</dd>
|
|
<dt><b>CPF2C0B</b></dt>
|
|
<dd>Changing attributes not allowed for SSP member &3.
|
|
</dd>
|
|
<dt><b>CPF2C08</b></dt>
|
|
<dd>File &1 is not a source file.
|
|
</dd>
|
|
<dt><b>CPF9803</b></dt>
|
|
<dd>Cannot allocate object &2 in library &3.
|
|
</dd>
|
|
<dt><b>CPF9812</b></dt>
|
|
<dd>File &1 in library &2 not found.
|
|
</dd>
|
|
<dt><b>CPF9815</b></dt>
|
|
<dd>Member &5 file &2 in library &3 not found.
|
|
</dd>
|
|
<dt><b>CPF9820</b></dt>
|
|
<dd>Not authorized to use library &1.
|
|
</dd>
|
|
<dt><b>CPF9822</b></dt>
|
|
<dd>Not authorized to file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9826</b></dt>
|
|
<dd>Cannot allocate file &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGS36SRCA.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|