399 lines
19 KiB
HTML
399 lines
19 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 User-Defined FS (CRTUDFS)</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="CRTUDFS.Top_Of_Page"></a>
|
|
<h2>Create User-Defined FS (CRTUDFS)</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="#CRTUDFS.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTUDFS.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTUDFS.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTUDFS"></a>
|
|
<p>The Create User-Defined File System (CRTUDFS) command creates a file system that can be made visible to the rest of the integrated file system name space through the Add Mounted File System (ADDMFS) or MOUNT command.
|
|
</p>
|
|
<p>A UDFS is represented by the object type *BLKSF, or block special file.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>The user must have input/output (I/O) system configuration (*IOSYSCFG) special authority to use this command.
|
|
</li>
|
|
<li>The audit (*AUDIT) special authority is required when specifying a value other than *SYSVAL on the <b>Auditing value for objects (CRTOBJAUD)</b> parameter.
|
|
</li>
|
|
<li>The user must have all object (*ALLOBJ) and security administrator (*SECADM) special authorities to specify a value for the <b>Scanning option for objects (CRTOBJSCAN)</b> parameter other than *PARENT.
|
|
</li>
|
|
<li>A maximum of approximately 4,000 user-defined file systems can be created on an independent auxiliary storage pool (ASP).
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTUDFS.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="#CRTUDFS.UDFS"><b>UDFS</b></a></td>
|
|
<td valign="top">User-defined file system</td>
|
|
<td valign="top"><i>Path name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTUDFS.DTAAUT"><b>DTAAUT</b></a></td>
|
|
<td valign="top">Public authority for data</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*INDIR</u></b>, *RWX, *RW, *RX, *WX, *R, *W, *X, *EXCLUDE, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTUDFS.OBJAUT"><b>OBJAUT</b></a></td>
|
|
<td valign="top">Public authority for object</td>
|
|
<td valign="top">Single values: <b><u>*INDIR</u></b>, *NONE, *ALL<br>Other values (up to 4 repetitions): *OBJEXIST, *OBJMGT, *OBJALTER, *OBJREF</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTUDFS.CRTOBJAUD"><b>CRTOBJAUD</b></a></td>
|
|
<td valign="top">Auditing value for objects</td>
|
|
<td valign="top"><b><u>*SYSVAL</u></b>, *NONE, *USRPRF, *CHANGE, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTUDFS.CRTOBJSCAN"><b>CRTOBJSCAN</b></a></td>
|
|
<td valign="top">Scanning option for objects</td>
|
|
<td valign="top"><b><u>*PARENT</u></b>, *YES, *NO, *CHGONLY</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTUDFS.RSTDRNMUNL"><b>RSTDRNMUNL</b></a></td>
|
|
<td valign="top">Restricted rename and unlink</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTUDFS.CASE"><b>CASE</b></a></td>
|
|
<td valign="top">Case sensitivity</td>
|
|
<td valign="top">*MIXED, <b><u>*MONO</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTUDFS.DFTFILEFMT"><b>DFTFILEFMT</b></a></td>
|
|
<td valign="top">Default file format</td>
|
|
<td valign="top">*TYPE1, <b><u>*TYPE2</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTUDFS.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTUDFS.UDFS"></a>
|
|
<h3>User-defined file system (UDFS)</h3>
|
|
<p>Specifies the path name of the file system to be created. It must be in one of the following two forms:
|
|
</p>
|
|
<ul>
|
|
<li><i>/dev/qaspXX/udfsname.udfs</i>, where <i>XX</i> is one of the valid system or basic user auxiliary storage pool (ASP) numbers on the system, and <i>udfsname</i> is the name of the user-defined file system. All other parts of the name must appear as in the example above.
|
|
</li>
|
|
<li><i>/dev/aspname/udfsname.udfs</i>, where <i>aspname</i> is one of the valid independent ASP names on the system, and <i>udfsname</i> is the name of the user-defined file system. All other parts of the name must appear as in the example above.
|
|
</li>
|
|
</ul>
|
|
<p>The name part of the path must be unique within the specified <i>qaspXX</i> or <i>aspname</i> directory.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTUDFS.DTAAUT"></a>
|
|
<h3>Public authority for data (DTAAUT)</h3>
|
|
<p>Specifies the public data authority given to the user for the new user-defined file system (UDFS), or specifies that all authorities are inherited from the directory it is to be created in.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INDIR</u></b></dt>
|
|
<dd>The authority for the UDFS to be created is determined by the directory it is to be created in. This means the new UDFS will inherit its primary group, authorization list, and its public, private and primary group authorities from the <i>/dev/qaspXX</i> or <i>/dev/aspname</i> directory. If the value *INDIR is specified for either the <b>Public authority for object (OBJAUT)</b> parameter or the DTAAUT parameter, then *INDIR must be specified for both parameters.
|
|
</dd>
|
|
<dt><b>*RWX</b></dt>
|
|
<dd>The user can change the object and perform basic functions on the object except those limited to the owner or controlled by object existence (*OBJEXIST), object management (*OBJMGT), object alter (*OBJALTER) and object reference (*OBJREF) authority. Read, write, execute (*RWX) provides object operational (*OBJOPR) and all data authorities.
|
|
</dd>
|
|
<dt><b>*RW</b></dt>
|
|
<dd>The user can view and change the contents of an object. Read, write (*RW) authority provides *OBJOPR and data read (*READ), add (*ADD), update (*UPD) and delete (*DLT) authorities.
|
|
</dd>
|
|
<dt><b>*RX</b></dt>
|
|
<dd>The user can perform basic operations on the object, such as run a program or display the contents of a file. The user is prevented from changing the object. Read, execute (*RX) authority provides *OBJOPR and data *READ and *EXECUTE authorities.
|
|
</dd>
|
|
<dt><b>*WX</b></dt>
|
|
<dd>The user can change the contents of an object and run a program or search a library or directory. Write, execute (*WX) authority provides *OBJOPR and data *READ, *UPD, *DLT, and *EXECUTE authorities.
|
|
</dd>
|
|
<dt><b>*R</b></dt>
|
|
<dd>The user can view the contents of an object. Read (*R) authority provides *OBJOPR and data *READ authorities.
|
|
</dd>
|
|
<dt><b>*W</b></dt>
|
|
<dd>The user can change the contents of an object. Write (*W) authority provides *OBJOPR and data *READ, *UPD, and *DLT authorities.
|
|
</dd>
|
|
<dt><b>*X</b></dt>
|
|
<dd>The user can run a program or search a library or directory. Execute (*X) authority provides *OBJOPR and data *EXECUTE authorities.
|
|
</dd>
|
|
<dt><b>*EXCLUDE</b></dt>
|
|
<dd>The user cannot access the object. The OBJAUT value must be *NONE, if this special value is used.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>The user is given no data authorities to the object. This value cannot be used with OBJAUT value of *NONE.
|
|
</dd>
|
|
<dt><b><i>authorization-list-name</i></b></dt>
|
|
<dd>The format of the authorization list name remains the current ten-character format. The OBJAUT value must be *NONE, if this special value is used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTUDFS.OBJAUT"></a>
|
|
<h3>Public authority for object (OBJAUT)</h3>
|
|
<p>Specifies the public object authority given to users for the user-defined file system, or specifies that all authorities are inherited from the directory it is to be created in.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INDIR</u></b></dt>
|
|
<dd>The object authority for the UDFS to be created is determined by the directory it is to be created in. This means the new UDFS will inherit its primary group, authorization list, and its public, private and primary group authorities from the <i>/dev/qaspXX</i> or <i>/dev/aspname</i> directory. If the value *INDIR is specified for either the OBJAUT parameter or the <b>Public authority for data (DTAAUT)</b> parameter, then *INDIR must be specified for both parameters.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>None of the other object authorities (*OBJEXIST, *OBJMGT, *OBJALTER or *OBJREF) are given to the users. If *EXCLUDE or an authorization list is specified for the DTAAUT parameter, *NONE must be specified. This value cannot be used with the DTAAUT value of *NONE.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All of the other object authorities (*OBJEXIST, *OBJMGT, *OBJALTER or *OBJREF) are given to the users.
|
|
<p><b>The user can specify up to four of the following values:</b>
|
|
</p>
|
|
</dd>
|
|
<dt><b>*OBJEXIST</b></dt>
|
|
<dd>The user is given object existence (*OBJEXIST) authority to the object. The user can delete the object, free storage of the object, perform save and restore operations for the object, and transfer ownership of the object.
|
|
</dd>
|
|
<dt><b>*OBJMGT</b></dt>
|
|
<dd>The user is given object management (*OBJMGT) authority to the object. With this authority the user can specify security for the object, move or rename the object and add members to database files.
|
|
</dd>
|
|
<dt><b>*OBJALTER</b></dt>
|
|
<dd>The user is given object alter (*OBJALTER) authority to the object. The user is able to alter the attributes of the objects. On a database file, the user can add and remove triggers, add and remove referential and unique constraints, and change the attributes of the database file. With this authority on an SQL package, the user can change the attributes of the SQL package. Currently, this authority is used only for database files and SQL packages.
|
|
</dd>
|
|
<dt><b>*OBJREF</b></dt>
|
|
<dd>The user is given object reference (*OBJREF) authority to objects. Used only for database files, the user can reference an object from another object such that operations on that object may be restricted by the other object. On a physical file, the user can add a referential constraint in which the physical file is the parent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTUDFS.CRTOBJAUD"></a>
|
|
<h3>Auditing value for objects (CRTOBJAUD)</h3>
|
|
<p>Specifies the auditing value of root directory objects created in this user-defined file system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SYSVAL</u></b></dt>
|
|
<dd>The object auditing value for the objects in the UDFS is determined by the Create object auditing (QCRTOBJAUD) system value.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>Using or changing this object does not cause an audit entry to be sent to the security journal.
|
|
</dd>
|
|
<dt><b>*USRPRF</b></dt>
|
|
<dd>The user profile of the user accessing this object is used to determine if an audit record is sent for this access. The OBJAUD parameter of the Change User Auditing (CHGUSRAUD) command is used to turn on auditing for a specific user.
|
|
</dd>
|
|
<dt><b>*CHANGE</b></dt>
|
|
<dd>All change accesses to this object by all users are logged.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All change or read accesses to this object by all users are logged.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTUDFS.CRTOBJSCAN"></a>
|
|
<h3>Scanning option for objects (CRTOBJSCAN)</h3>
|
|
<p>Specifies whether the root directory objects created in the user-defined file system will be scanned when exit programs are registered with any of the integrated file system scan-related exit points.
|
|
</p>
|
|
<p>The integrated file system scan-related exit points are:
|
|
</p>
|
|
<ul>
|
|
<li>QIBM_QP0L_SCAN_OPEN - Integrated File System Scan on Open Exit Program
|
|
</li>
|
|
<li>QIBM_QP0L_SCAN_CLOSE - Integrated File System Scan on Close Exit Program
|
|
</li>
|
|
</ul>
|
|
<p>For details on these exit points, see the System API Reference information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
|
</p>
|
|
<p>Even though this attribute can be set for user-defined file systems, only objects which are in *TYPE2 directories in that user-defined file system will actually be scanned, no matter what value is set for this attribute.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PARENT</u></b></dt>
|
|
<dd>The create object scanning attribute value for this user-defined file system is copied from the create object scanning attribute value of the parent directory.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>After an object is created in the user-defined file system, the object will be scanned according to the rules described in the scan-related exit programs if the object has been modified or if the scanning software has been updated since the last time the object was scanned.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>After an object is created in the user-defined file system, the object will not be scanned by the scan-related exit programs.
|
|
<p>
|
|
<b>Note: </b>If the Scan file systems control (QSCANFSCTL) value *NOPOSTRST is not specified when an object with this attribute is restored, the object will be scanned at least once after the restore.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*CHGONLY</b></dt>
|
|
<dd>After an object is created in the user-defined file system, the object will be scanned according to the rules described in the scan-related exit programs only if the object has been modified since the last time the object was scanned. It will not be scanned if the scanning software has been updated. This attribute only takes effect if the Scan file systems control (QSCANFSCTL) system value has *USEOCOATR specified. Otherwise, it will be treated as if the attribute is *YES.
|
|
<p>
|
|
<b>Note: </b>If the Scan file systems control (QSCANFSCTL) value *NOPOSTRST is not specified when an object with this attribute is restored, the object will be scanned at least once after the restore.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTUDFS.RSTDRNMUNL"></a>
|
|
<h3>Restricted rename and unlink (RSTDRNMUNL)</h3>
|
|
<p>Specifies whether special restrictions apply for rename and unlink operations performed on objects within the root directory of the user-defined file system. This attribute is equivalent to the S_ISVTX mode bit for this directory.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>No additional restrictions for renaming or unlinking objects from the root directory of the user-defined file system.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>Objects within the root directory of the user-defined file system may be renamed or unlinked only if one or more of the following are true for the user performing the operation:
|
|
<ol>
|
|
<li>The user is the owner of the object.
|
|
</li>
|
|
<li>The user is the owner of the directory.
|
|
</li>
|
|
<li>The user has all object (*ALLOBJ) special authority.
|
|
</li>
|
|
</ol>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTUDFS.CASE"></a>
|
|
<h3>Case sensitivity (CASE)</h3>
|
|
<p>Specifies the case sensitivity of this file system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MONO</u></b></dt>
|
|
<dd>The file system will not be case sensitive. For example, the names FileA and filea refer to the same object.
|
|
</dd>
|
|
<dt><b>*MIXED</b></dt>
|
|
<dd>The file system will be case sensitive. For example, the names FileA and filea do NOT refer to the same object.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTUDFS.DFTFILEFMT"></a>
|
|
<h3>Default file format (DFTFILEFMT)</h3>
|
|
<p>Specifies the format of stream files (*STMF) created in this user-defined file system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*TYPE2</u></b></dt>
|
|
<dd>A *TYPE2 *STMF has high performance file access and was new in Version 4 Release 4 of i5/OS. It has a minimum object size of 4096 bytes and a maximum object size of approximately 1 terabyte. A *TYPE2 stream file is capable of memory mapping as well as the ability to specify an attribute to optimize disk storage allocation.
|
|
</dd>
|
|
<dt><b>*TYPE1</b></dt>
|
|
<dd>A *TYPE1 *STMF has the same format as *STMF objects created on releases prior to Version 4 Release 4 of i5/OS. It has a minimum size of 4096 bytes and a maximum object size of approximately 256 gigabytes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTUDFS.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Text description for the user-defined file system.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>Text is not specified.
|
|
</dd>
|
|
<dt><b><i>character</i></b></dt>
|
|
<dd>Specify no more than 50 characters, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTUDFS.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Create UDFS in System ASP</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTUDFS UDFS('/dev/QASP01/joe.udfs) TEXT('Joe Smith')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a user-defined file system (UDFS) named <i>joe.udfs</i> in the system auxiliary storage pool (ASP 1).
|
|
</p>
|
|
<p><b>Example 2: Create UDFS in ASP 3</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTUDFS UDFS('/dev/QASP03/harry.udfs') CASE(*MIXED)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a case-sensitive user-defined file system (UDFS) named <i>harry.udfs</i> in user auxiliary storage pool (ASP) 3.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTUDFS.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPFA0A2</b></dt>
|
|
<dd>Information passed to this operation was not valid.
|
|
</dd>
|
|
<dt><b>CPFA09C</b></dt>
|
|
<dd>Not authorized to object. Object is &1.
|
|
</dd>
|
|
<dt><b>CPFA0A9</b></dt>
|
|
<dd>Object not found. Object is &1.
|
|
</dd>
|
|
<dt><b>CPFA0B1</b></dt>
|
|
<dd>Requested operation not allowed. Access problem.
|
|
</dd>
|
|
<dt><b>CPFA1B8</b></dt>
|
|
<dd>*IOSYSCFG authority required to use &1.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTUDFS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|