289 lines
11 KiB
HTML
289 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>Create Folder (CRTFLR)</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="CRTFLR.Top_Of_Page"></a>
|
|
<h2>Create Folder (CRTFLR)</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="#CRTFLR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTFLR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTFLR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTFLR"></a>
|
|
<p>The Create Folder (CRTFLR) command allows you to create a folder. Folders are used to organize documents and other folders.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<p>If a folder is created into an existing folder, change (*CHANGE) authority to the existing folder is required.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTFLR.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="#CRTFLR.FLR"><b>FLR</b></a></td>
|
|
<td valign="top">Folder</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTFLR.INFLR"><b>INFLR</b></a></td>
|
|
<td valign="top">In folder</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTFLR.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*FLR</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTFLR.AUT"><b>AUT</b></a></td>
|
|
<td valign="top">Authority</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*INFLR</u></b>, *EXCLUDE, *ALL, *CHANGE, *USE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTFLR.ASP"><b>ASP</b></a></td>
|
|
<td valign="top">Auxiliary storage pool ID</td>
|
|
<td valign="top">1-32, <b><u>*INFLR</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CRTFLR.CMDCHRID"><b>CMDCHRID</b></a></td>
|
|
<td valign="top">Command character identifier</td>
|
|
<td valign="top">Single values: <b><u>*SYSVAL</u></b>, *DEVD<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Graphic character set</td>
|
|
<td valign="top">
|
|
<i>Integer</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Code page</td>
|
|
<td valign="top">
|
|
<i>Integer</i></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTFLR.FLR"></a>
|
|
<h3>Folder (FLR)</h3>
|
|
<p>Specifies the name of the folder being created.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name (ranging from 1 through 12 characters, including an optional extension) of the folder being created. If no extension is included, a document or folder name can have a maximum of 8 characters. If an extension is included, the extension must start with a period and can have up to 3 additional characters. An extension in the folder name allows you to identify the folder by using specific information that can help you do a selective listing of folders on your system.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTFLR.INFLR"></a>
|
|
<h3>In folder (INFLR)</h3>
|
|
<p>Specifies the name of the folder that contains the folder being created.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>The folder is not created within another folder; it is considered a first-level folder.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the folder (ranging from 1 through 63 characters) that contains the newly created folder.
|
|
<p>Because folders may reside within other folders, and because any given folder name is only unique within its containing folder, you may be required to link several folder names together to identify a folder. This is commonly called the path to an object within a folder. The folder path is:
|
|
</p>
|
|
<ul>
|
|
<li>One or more folder names. If more than one folder name, each is separated by a forward slash (/). An example of two folder names is FOLDERA/FOLDERB.
|
|
</li>
|
|
<li>Not to exceed 63 characters in total length.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTFLR.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*FLR</u></b></dt>
|
|
<dd>The text is the folder name specified on the <b>Folder (FLR)</b> parameter.
|
|
</dd>
|
|
<dt><b><i>character</i></b></dt>
|
|
<dd>Specify up to 44 characters enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTFLR.AUT"></a>
|
|
<h3>Authority (AUT)</h3>
|
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INFLR</u></b></dt>
|
|
<dd>If the folder is a first-level folder, the authority is *EXCLUDE. If the folder is not a first-level folder, the authority is copied from the folder specified on the <b>In folder (INFLR)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*EXCLUDE</b></dt>
|
|
<dd>The user cannot access the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CHANGE</b></dt>
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*USE</b></dt>
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the authorization list. The public authority is set to *AUTL, and the authorization list is attached to the created folder.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTFLR.ASP"></a>
|
|
<h3>Auxiliary storage pool ID (ASP)</h3>
|
|
<p>Specifies the ID of the auxiliary storage pool (ASP) in which to create the folder. This parameter can be specified only when INFLR(*NONE) is specified (when you are creating a first level folder).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INFLR</u></b></dt>
|
|
<dd>The folder is created in the ASP of its parent folder. When INFLR(*NONE) is specified, this is the system ASP.
|
|
</dd>
|
|
<dt><b><i>1-32</i></b></dt>
|
|
<dd>Specify the identifier (ID) of the ASP in which to create the folder. The value must designate an ASP that is configured on the system. For information on configuring an ASP, see the Backup and Recovery book, SC41-5304.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTFLR.CMDCHRID"></a>
|
|
<h3>Command character identifier (CMDCHRID)</h3>
|
|
<p>Specifies the character identifier (graphic character set and code page) for the data being entered as command parameter values (applies to <b>Text 'description' (TEXT)</b> parameter). The character identifier is related to the display device that was used to enter the command.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
|
<dd>The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*DEVD</b></dt>
|
|
<dd>The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Graphic character set</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-32767</i></b></dt>
|
|
<dd>Specify the graphic character set to use.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Code page</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>1-32767</i></b></dt>
|
|
<dd>Specify the code page to use.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTFLR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Create a Folder in Another Folder</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTFLR FLR(QTR1) INFLR('PAYROLL/1987') AUT(*CHANGE)
|
|
TEXT('first quarter payroll')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates the folder QTR1 in folder PAYROLL/1987. The public is granted *CHANGE authority to the folder, which allows adding a document to the folder, changing the folder description, or showing the contents of the folder. Folder 1987 is in the PAYROLL folder, which is a first-level folder.
|
|
</p>
|
|
<p><b>Example 2: Create a Folder in an ASP</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTFLR FLR(MANFCTNG) INFLR(*NONE) ASP(2) AUT(*USE)
|
|
TEXT('Manufacturing')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates the folder MANFCTNG as a first level folder in user auxiliary storage pool (ASP) 2, which has been previously configured on the system. The public is granted *USE authority to the folder, which allows you to show the description or the contents of the folder.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTFLR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF8A18</b></dt>
|
|
<dd>Folder &1 not created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTFLR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|