928 lines
58 KiB
HTML
928 lines
58 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="reference" />
|
|
<meta name="DC.Title" content="Work with output of the RTVDIRINF and PRTDIRINF commands" />
|
|
<meta name="abstract" content="The Retrieve Directory Information (RTVDIRINF) command is used to collect attributes for objects in the integrated file system. The collected information is stored in database files (tables) that are named using the information file prefix specified by the INFFILEPFX parameter. The tables are created in the library specified by the INFLIB parameter." />
|
|
<meta name="description" content="The Retrieve Directory Information (RTVDIRINF) command is used to collect attributes for objects in the integrated file system. The collected information is stored in database files (tables) that are named using the information file prefix specified by the INFFILEPFX parameter. The tables are created in the library specified by the INFLIB parameter." />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaaxifscmd.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaaxaccdata.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzaaxusedata.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rtvdirinf.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../apis/getpthff.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../apis/qsetattr.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/apyjrnchg.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/rmvjrnchg.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/chgjrnobj.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/prtdirinf.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rzaaxwwcomm" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Work with output of the RTVDIRINF and PRTDIRINF commands</title>
|
|
</head>
|
|
<body id="rzaaxwwcomm"><a name="rzaaxwwcomm"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Work with output of the <span class="cmdname">RTVDIRINF</span> and <span class="cmdname">PRTDIRINF</span> commands</h1>
|
|
<div><p>The <span class="cmdname">Retrieve Directory Information (RTVDIRINF)</span> command
|
|
is used to collect attributes for objects in the integrated file system. The
|
|
collected information is stored in database files (tables) that are named
|
|
using the information file prefix specified by the INFFILEPFX parameter. The
|
|
tables are created in the library specified by the INFLIB parameter.</p>
|
|
<div class="section"><p>Three tables are created as a result of the <span class="cmdname">RTVDIRINF</span> command.
|
|
One table stores object attributes, one is for directories, and the last table
|
|
is used to determine which files were used to store object attributes.</p>
|
|
<p>The following table describes the fields that are provided
|
|
for the table that stores the object attributes. If *GEN is specified in the
|
|
information file prefix (INFFILEPFX) parameter, the database files are created
|
|
with a unique prefix generated by this command. The prefix begins with QAEZD
|
|
followed by four digits. The files created to store the collected information
|
|
are named using this prefix followed by either the letter D (for the file
|
|
which contains directory information) or the letter O (for the file that contains
|
|
information about objects in directories). For example, the first time that
|
|
the command is run with *GEN specified, files QAEZD0001D and QAEZD0001O are
|
|
created in the library specified by the Information library (INFLIB) parameter.
|
|
Users can specify a file prefix to use for naming this database, which can
|
|
be up to nine characters long.</p>
|
|
|
|
<div class="tablenoborder"><a name="rzaaxwwcomm__rzaaxstrobj"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzaaxwwcomm__rzaaxstrobj" frame="border" border="1" rules="all"><caption>Table 1. QAEZDxxxxO
|
|
(store object's attributes)</caption><thead align="left"><tr><th valign="top" width="15.19434628975265%" id="d0e41">Field name</th>
|
|
<th valign="top" width="17.6678445229682%" id="d0e43">Field type</th>
|
|
<th valign="top" width="67.13780918727915%" id="d0e45">Field description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZACCTIM</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">TIMESTAMP</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The date and time that the object's data was last accessed.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZALCSIZE <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">BIGINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The number of bytes that have been allocated for this
|
|
object.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZALWCKPW</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether a stream file (*STMF) can be shared with readers
|
|
and writers during the save-while-active checkpoint processing. Valid values
|
|
are: <p>0 - The object can be shared with readers only.</p>
|
|
<p>1 - The object
|
|
can be shared with readers and writers.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZASP</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The auxiliary storage pool in which the object is stored.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZAUDT</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The auditing value associated with the object. Valid
|
|
values are: <p>*NONE - No auditing occurs for this object when it is read
|
|
or changed regardless of the user who is accessing the object.</p>
|
|
<p>*USRPRF
|
|
- Audit this object only if the current user is being audited. The current
|
|
user is tested to determine if auditing should be done for this object. The
|
|
user profile can specify if only change access is audited or if both read
|
|
and change accesses are audited for this object.</p>
|
|
<p>*CHANGE - Audit all
|
|
change access to this object by all users on the system.</p>
|
|
<p>*ALL - Audit
|
|
all access to this object by all users on the system. All access is defined
|
|
as a read or change operation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZAUTLST</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The name of the authorization list that is used to secure
|
|
the named object. The value *NONE indicates that no authorization list is
|
|
used in determining authority to the object.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZBLKSIZ</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The block size of an object.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCASE</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Indicates the Case Sensitivity of the file system that
|
|
contains this object. <p>0 - File system is not case sensitive.</p>
|
|
<p>1 -
|
|
File system is case sensitive.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCCSID</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The CCSID of the data and extended attributes of the
|
|
object.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCEAS</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">BIGINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Number of critical extended attributes associated with
|
|
this object.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCHGTIMA <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">TIMESTAMP</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The date and time that the object's attributes were
|
|
last changed.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCHGTIMD</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">TIMESTAMP</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The date and time that the object's data was last changed.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCHKOUT <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">An indicator as to whether an object is checked out.
|
|
Valid values are: <p>0 - The object is not checked out.</p>
|
|
<p>1 - The object
|
|
is checked out.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCHKOWN</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The user who has the object checked out. This field
|
|
is blank if it is not checked out.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCHKTIM</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">TIMESTAMP</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The date and time the object was checked out. <span>If
|
|
the object is not checked out, this field will have NULL as its value.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCLSTRSP</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The object is the storage which was allocated for Integrated xSeries<sup>®</sup> servers
|
|
to use as virtual disk drives for the xSeries servers. From the perspective
|
|
of the iSeries™ server,
|
|
virtual drives appear as byte stream files within the integrated file system. <p>0
|
|
- Object is not virtual disk storage.</p>
|
|
<p>1 - Object is virtual disk storage.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCRTAUD</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The auditing value associated with an object created
|
|
in this directory. Valid values are: <p>*NONE - No auditing occurs for this
|
|
object when it is read or changed regardless of the user who is accessing
|
|
the object.</p>
|
|
<p>*USRPRF - Audit this object only if the current user is
|
|
being audited. The current user is tested to determine if auditing should
|
|
be done for this object. The user profile can specify if only change accesses
|
|
are audited or if both read and change accesses are audited for this object.</p>
|
|
<p>*CHANGE
|
|
- Audit all change accesses to this object by all users on the system.</p>
|
|
<p>*ALL
|
|
- Audit all accesses to this object by all users on the system. All accesses
|
|
are defined as a read or change operation.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZCRTTIM</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">TIMESTAMP</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The date and time at which the object was created.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZDIRIDX</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The parent directory index.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZDIRTYP2</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The format of the specified directory object. Valid
|
|
values are: <p>0 - The directory format is *TYPE1.</p>
|
|
<p>1 - The directory
|
|
format is *TYPE2.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZDOM</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The domain of the object. Valid values are: <p>*SYSTEM
|
|
- Object exists in system domain.</p>
|
|
<p>*USER - Object exists in user domain.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZDSTGOPT</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">This option should be used to determine how auxiliary
|
|
storage is allocated by the system for the specified object. This option can
|
|
only be specified for stream files in the "root" (/), QOpenSys and user-defined
|
|
file systems. This option will be ignored for *TYPE1 byte stream files. Valid
|
|
values are: <p>0 - The auxiliary storage will be allocated normally. That
|
|
is, as additional auxiliary storage is required, it will be allocated in logically
|
|
sized extents to accommodate the current space requirement, and anticipated
|
|
future requirements, while minimizing the number of disk I/O operations.</p>
|
|
<p>1
|
|
- The auxiliary storage will be allocated to minimize the space used by the
|
|
object. That is, as additional auxiliary storage is required, it will be allocated
|
|
in small sized extents to accommodate the current space requirement. Accessing
|
|
an object composed of many small extents may increase the number of disk I/O
|
|
operations for that object.</p>
|
|
<p>2 - The system will dynamically determine
|
|
the optimum auxiliary storage allocation for the object, balancing space used
|
|
versus disk I/O operations. For example, if a file has many small extents,
|
|
yet is frequently being read and written, then future auxiliary storage allocations
|
|
will be larger extents to minimize the number of disk I/O operations. Or,
|
|
if a file is frequently truncated, then future auxiliary storage allocations
|
|
will be small extents to minimize the space used. Additionally, information
|
|
will be maintained on the stream file sizes for this system and its activity.
|
|
This file size information will also be used to help determine the optimum
|
|
auxiliary storage allocations for this object as it relates to the other objects
|
|
sizes.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZDTASIZE</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">BIGINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The size in bytes of the data in this object. This size
|
|
does not include object headers or the size of extended attributes associated
|
|
with the object.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZEAS</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">BIGINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Number of extended attributes associated with this object.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZEXTATRS</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">BIGINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Total number of bytes for all the extended attribute
|
|
data.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZFILEID <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (16)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The file ID for the object. An identifier associated
|
|
with the object. A file ID can be used with <a href="../apis/getpthffu.htm"><span class="apiname">Qp0lGetPathFromFileID()</span></a> to
|
|
retrieve an object's path name.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZFILEIDS</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The 4 byte file ID of the file. This number uniquely
|
|
identifies the object within a file system. This number cannot identify the
|
|
object in the whole system.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZFILTYP2 <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The format of the stream file (*STMF). Valid values
|
|
are: <p>0 - The stream file format is *TYPE1.</p>
|
|
<p>1 - The stream file format
|
|
is *TYPE2.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZFSID</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">BIGINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The file system ID to which the object belongs. This
|
|
number uniquely identifies the file system to which the object belongs.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZGENID</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">BIGINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The generation ID associated with the file ID.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZGID</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Group profiles are identified by a unique numeric group
|
|
identification number (GID).</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZINHSCN</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (1)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the objects created in a directory will be scanned
|
|
when exit programs are registered with any of the integrated file system scan-related
|
|
exit points. <p>Valid
|
|
values are:</p>
|
|
<div class="p"><img src="./delta.gif" alt="Start of change" />x'00' - After an object is created
|
|
in the directory, the object will not be scanned according to the rules described
|
|
in the scan-related exit programs.<div class="note"><span class="notetitle">Note:</span> 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.</div>
|
|
<img src="./deltaend.gif" alt="End of change" /></div>
|
|
<p><img src="./delta.gif" alt="Start of change" />x'01' - After an object is created in the directory,
|
|
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.<img src="./deltaend.gif" alt="End of change" /></p>
|
|
<div class="p"><img src="./delta.gif" alt="Start of change" />x'02'
|
|
- After an object is created in the directory, 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 SCANNING_YES.<div class="note"><span class="notetitle">Note:</span> 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.</div>
|
|
<img src="./deltaend.gif" alt="End of change" /></div>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJAFTERI</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">When journaling is active, the image of the object after
|
|
a change is journaled. <p>0 - Object is not journaled with after images.</p>
|
|
<p>1
|
|
- Object is journaled with after images.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJBEFORI</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">When journaling is active, the image of the object before
|
|
a change is journaled. <p>0 - Object is not journaled with before images.</p>
|
|
<p>1
|
|
- Object is journaled with before images.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJOPTENT</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">When journaling is active, entries that are considered
|
|
optional are journaled. The list of optional journal entries varies for each
|
|
object type. <p>0 - Object is not journaled with optional entries.</p>
|
|
<p>1
|
|
- Object is journaled with optional entries.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJRCVASP</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC(10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The name of the ASP that contains the journal receiver
|
|
needed to successfully apply journal changes. The valid values are: <p>*SYSBAS
|
|
- The journal receiver resides in the system or user ASP.</p>
|
|
<p>ASP device
|
|
- The name of the ASP device that contains the journal receiver.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJRCVLIB</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC(10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The name of the library that contains the journal receiver
|
|
needed to successfully apply journal changes. <span>This
|
|
field is blank if the object has never been journaled.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJRCVNAM</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC(10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The oldest journal receiver needed to successfully apply
|
|
journal changes. When the Apply information field is set to PARTIAL_TRANSACTION
|
|
the journal receiver contains the start of the partial transaction. Otherwise;
|
|
the journal receiver contains the start of the save operation. <span>This
|
|
field is blank if the object has never been journaled.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJRNID</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">This field associates the object being journaled with
|
|
an identifier that can be used on various journaling-related commands and
|
|
APIs. <span>This field is blank if the object has never
|
|
been journaled.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJRNLIB</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">If the value of the journaling status is JOURNALED,
|
|
then this field contains the name of the library containing the currently
|
|
used journal. If the value of the journaling status is NOT_JOURNALED, then
|
|
this field contains the name of the library containing the last used journal. <span>This field is blank if the object has never been
|
|
journaled.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJRNNAM</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">If the value of the journaling status is JOURNALED,
|
|
then this field contains the name of the journal currently being used. If
|
|
the value of the journaling status is NOT_JOURNALED, then this field contains
|
|
the name of the journal last used for this object. <span>This
|
|
field is blank if the object has never been journaled.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJRNSTR</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">TIMESTAMP</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The number of seconds since the Epoch that corresponds
|
|
to the last date and time for which the object had journaling started for
|
|
it. <span>This field has NULL as its value if the object
|
|
has never been journaled.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJRNSTS <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Current journaling status of the object. This field
|
|
will be one of the following values: <p>0 (NOT_JOURNALED) - The object is
|
|
currently not being journaled.</p>
|
|
<p>1 (JOURNALED) - The object is currently
|
|
being journaled.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJSUBTRE</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">When this flag is returned, this object is a directory
|
|
with integrated file system journaling subtree semantics. <p>0 - The object
|
|
is not journaled with subtree semantics.</p>
|
|
<p>1 - The object is journaled
|
|
with subtree semantics. New objects created within this directory's subtree
|
|
will inherit the journaling attributes and options from this directory.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZJTRNI</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC(1)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">This field describes information about the current state
|
|
of the object as it relates to commitment control boundaries. The valid values
|
|
are: <p>x'00' (NONE) - There are no partial transactions.</p>
|
|
<p>x'01' (PARTIAL_TRANSACTION)
|
|
- The object was restored with partial transactions. This object cannot be
|
|
used until the <span class="cmdname">Apply Journaled Changes (APYJRNCHG)</span> or <span class="cmdname">Remove
|
|
Journaled Changes (RMVJRNCHG)</span> command is used to complete or rollback
|
|
the partial transactions.</p>
|
|
<p>x'02' (ROLLBACK_ENDED) - The object had a
|
|
rollback operation ended using the "End Rollback" option on the Work with
|
|
Commitment Definition (WRKCMTDFN) screen. It is recommended that the object
|
|
be restored as it cannot be used. As a last option, the <span class="cmdname">Change Journaled
|
|
Object (CHGJRNOBJ)</span> command can be used to allow the object to be
|
|
used. Doing this, however, can leave the object in an inconsistent state.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZLANGID</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (3)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 "><span>A three character ID representing
|
|
the language that the object name (field QEZOBJNAM) is in.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZLOCAL</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether an object is stored locally or stored on a remote
|
|
system. The decision of whether an object is local or remote varies according
|
|
to the respective file system rules. Objects in file systems that do not carry
|
|
either a local or remote indicator are treated as remote. Valid values are: <p>1
|
|
- The object's data is stored locally.</p>
|
|
<p>2 - The object's data is on a
|
|
remote system.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZMLTSIG</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether an object has more than one <span class="keyword">i5/OS™</span> digital
|
|
signature. Valid values are: <p>0 - The object has only one digital signature.</p>
|
|
<p>1
|
|
- The object has more than one digital signature. If the QEZSYSSIG field has
|
|
the value 1, at least one of the signatures is from a source trusted by the
|
|
system.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZMODE</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The file access mode and type. For more information
|
|
about mode, see <a href="../apis/open.htm">open()</a> API.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZMSTGOPT</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">This option should be used to determine how main storage
|
|
is allocated and used by the system for the specified object. This option
|
|
can only be specified for stream files in the "root" (/), QOpenSys and user-defined
|
|
file systems. Valid values are: <p>0 - The main storage will be allocated
|
|
normally. That is, as much main storage as possible will be allocated and
|
|
used. This minimizes the number of disk I/O operations since the information
|
|
is cached in main storage.</p>
|
|
<p>1 - The main storage will be allocated to
|
|
minimize the space used by the object. That is, as little main storage as
|
|
possible will be allocated and used. This minimizes main storage usage while
|
|
increasing the number of disk I/O operations since less information is cached
|
|
in main storage.</p>
|
|
<p>2 - The system will dynamically determine the optimum
|
|
main storage allocation for the object depending on other system activity
|
|
and main storage contention. That is, when there is little main storage contention,
|
|
as much storage as possible will be allocated and used to minimize the number
|
|
of disk I/O operations. And when there is significant main storage contention,
|
|
less main storage will be allocated and used to minimize the main storage
|
|
contention. This option only has an effect when the storage pool's paging
|
|
option is *CALC. When the storage pool's paging option is *FIXED, the behavior
|
|
is the same as STG_NORMAL. When the object is accessed through a file server,
|
|
this option has no effect. Instead, its behavior is the same as STG_NORMAL.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZNLNK</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The number of hard links to the object.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZNMCCSID</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 "><span>The
|
|
CCSID in which the object name (field QEZOBJNAM) is represented.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZNONSAV</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object can be saved or not. Valid values
|
|
are: <p>0 - Object will be saved. </p>
|
|
<p>1 - Object will not be saved. Additionally,
|
|
if this object is a directory, none of the objects in the directory's subtree
|
|
will be saved unless they were explicitly specified as an object to be saved.
|
|
The subtree includes all subdirectories and the objects within those subdirectories.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZOBJLEN</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 "><span>Number of bytes contained
|
|
in the object name (field QEZOBJNAM).</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZOBJNAM <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">VARGRAPHIC (1024)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The object name. <sup>2</sup></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZOBJTYPE <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The object type.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZOFLOW</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Indicates if the object has overflowed the auxiliary
|
|
storage pool it resides in. Valid values are: <p>0 - Auxiliary storage pool
|
|
is not overflowed.</p>
|
|
<p>1 - Auxiliary storage pool is overflowed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZOWN <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The name of the user profile that is the owner of the
|
|
object or the following special value: <p>*NOUSRPRF - This special value is
|
|
used by the Network File System to indicate that there is no user profile
|
|
on the local iSeries server
|
|
with a user ID (UID) matching the UID of the remote object.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZOWNPGP</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (10)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The name of the user profile that is the primary group
|
|
of the object or the following special values: <p>*NONE - The object does
|
|
not have a primary group</p>
|
|
<p>*NOUSRPRF - This special value is used by the
|
|
Network File System to indicate that there is no user profile on the local
|
|
server with a group ID (GID) matching the GID of the remote object.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZPCARC</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object has changed since the last time the
|
|
object was examined. <p>0 - The object has not changed.</p>
|
|
<p>1 - The object
|
|
has changed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZPCHID <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object can be displayed using an ordinary
|
|
directory listing. <p>0 - The object is not hidden.</p>
|
|
<p>1 - The object is
|
|
hidden.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZPCREAD</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object can be written to or deleted, have
|
|
its extended attributes changed or deleted, or have its size changed. Valid
|
|
values are: <p>0 - The object can be changed.</p>
|
|
<p>1 - The object cannot
|
|
be changed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZPCSYS</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object is a system file and is excluded
|
|
from normal directory searches. <p>0 - The object is not a system file.</p>
|
|
<p>1
|
|
- The object is a system file.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZPRMLNK</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">When an object has several names, this field will be
|
|
set only for the first name found.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZRDEV</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">BIGINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">If the object represents a device special file, the
|
|
real device it represents.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZREGION</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (2)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 "><span>A two-character ID representing
|
|
the country of the object name (field QEZOBJNAM). This ID affects actions
|
|
that tend to be defined by the location of the action, such as collating sequence.</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSBINARY</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (1)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">This indicates if the object has been scanned in binary
|
|
mode when it was previously scanned. This field will be one of the following
|
|
values: <p>x'00' - The object was not scanned in binary mode.</p>
|
|
<p>x'01'
|
|
- The object was scanned in binary mode. If the object scan status is SCAN_SUCCESS,
|
|
then the object was successfully scanned in binary. If the object scan status
|
|
is SCAN_FAILURE, then the object failed the scan in binary.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSCCSID1</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">This indicates if the object has been scanned in the
|
|
listed CCSID when it was previously scanned. If the object scan status is
|
|
SCAN_SUCCESS, then the object was successfully scanned in this CCSID. If the
|
|
object scan status is SCAN_FAILURE, then the object failed the scan in this
|
|
CCSID. A value of 0 means this field does not apply.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSCCSID2</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">This indicates if the object has been scanned in the
|
|
listed CCSID when it was previously scanned. If the object scan status is
|
|
SCAN_SUCCESS, then the object was successfully scanned in this CCSID. If the
|
|
object scan status is SCAN_FAILURE, then this field will be 0. A value of
|
|
0 means this field does not apply.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSCN</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (1)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object will be scanned when exit programs
|
|
are registered with any of the integrated file system scan-related exit points. <p>Valid values are:</p>
|
|
<p><img src="./delta.gif" alt="Start of change" />x'00' (SCANNING_NO) - The object
|
|
will not be scanned according to the rules described in the scan-related exit
|
|
programs.<img src="./deltaend.gif" alt="End of change" /></p>
|
|
<div class="note"><span class="notetitle">Note:</span> 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.</div>
|
|
<p><img src="./delta.gif" alt="Start of change" />x'01'
|
|
(SCANNING_YES) - 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.<img src="./deltaend.gif" alt="End of change" /></p>
|
|
<p><img src="./delta.gif" alt="Start of change" />x'02' (SCANNING_CHGONLY) - 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 SCANNING_YES.<img src="./deltaend.gif" alt="End of change" /></p>
|
|
<div class="note"><span class="notetitle">Note:</span> 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.</div>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSIG <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether an object has an <span class="keyword">i5/OS</span> digital
|
|
signature. Valid values are: <p>0 - The object does not have an <span class="keyword">i5/OS</span> digital signature.</p>
|
|
<p>1
|
|
- The object does have an <span class="keyword">i5/OS</span> digital
|
|
signature.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSSIGDF</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (1)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The scan signatures give an indication of the level
|
|
of the scanning software support. <p>When an object is in an independent ASP
|
|
group, the object scan signature is compared to the associated independent
|
|
ASP group scan signature. When an object is not in an independent ASP group,
|
|
the object scan signature is compared to the global scan signature value.
|
|
This field will be one of the following values:</p>
|
|
<p>x'00' - The compared
|
|
signatures are not different.</p>
|
|
<p>x'01' - The compared signatures are different.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSSTATUS</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">GRAPHIC (1)</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The scan status associated with this object. This field
|
|
will be one of the following values: <p>x'00' (SCAN_REQUIRED) - A scan is
|
|
required for the object either because it has not yet been scanned by the
|
|
scan-related exit programs, or because the objects data or CCSID has been
|
|
modified since it was last scanned. Examples of object data or CCSID modifications
|
|
are: writing to the object, directly or through memory mapping; truncating
|
|
the object; clearing the object; and changing the objects CCSID attribute.</p>
|
|
<p>x'01'
|
|
(SCAN_SUCCESS) - The object has been scanned by a scan-related exit program,
|
|
and at the time of that last scan request, the object did not fail the scan.</p>
|
|
<p>x'02'
|
|
(SCAN_FAILURE) - The object has been scanned by a scan-related exit program,
|
|
and at the time of that last scan request, the object failed the scan and
|
|
the operation did not complete. Once an object has been marked as a failure,
|
|
it will not be scanned again until the object's scan signature is different
|
|
than the global scan key signature or independent ASP group scan key signature
|
|
as appropriate. Therefore, subsequent requests to work with the object will
|
|
fail with a scan failure indication. Examples of requests which will fail
|
|
are opening the object, changing the CCSID of the object, copying the object.</p>
|
|
<p>x'05'
|
|
(SCAN_PENDING_CVN) - The object is not in a *TYPE2 directory, and therefore
|
|
will not be scanned until the directory is converted.</p>
|
|
<p>x'06' (SCAN_NOT_REQUIRED)
|
|
- The object does not require any scanning because the object is marked to
|
|
not be scanned. </p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSTGFREE <sup>1</sup></td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object's data has been moved offline, freeing
|
|
its online storage. Valid values are: <p>0 - The object's data is not offline.</p>
|
|
<p>1
|
|
- The object's data is offline.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSYSARC</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object has changed and needs to be saved.
|
|
It is set on when an object's change time is updated, and set off when the
|
|
object has been saved. <p>0 - The object has not changed and does not need
|
|
to be saved.</p>
|
|
<p>1 - The object has changed and does need to be saved.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZSYSSIG</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Whether the object was signed by a source that is trusted
|
|
by the system. Valid values are: <p>0 - None of the signatures came from a
|
|
source that is trusted by the system.</p>
|
|
<p>1 - The object was signed by a
|
|
source that is trusted by the system. If the object has multiple signatures,
|
|
at least one of the signatures came from a source that is trusted by the system.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZUDATE</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">TIMESTAMP</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The number of seconds since the Epoch that corresponds
|
|
to the date the object was last used. This field is zero when the object is
|
|
created. If usage data is not maintained for the <span class="keyword">i5/OS</span> type
|
|
or the file system to which an object belongs, this field is zero.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZUDCOUNT</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The number of days an object has been used. Usage has
|
|
different meanings according to the specific file system and according to
|
|
the individual object types supported within a file system. Usage can indicate
|
|
the opening or closing of a file or can refer to adding links, renaming, restoring,
|
|
or checking out an object. This count is increased each day that an object
|
|
is used and is reset to zero by calling the <a href="../apis/qsetattr.htm">Qp0lSetAttr()</a> API.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZUDFTYP2</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">SMALLINT</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The default file format of stream files (*STMF) created
|
|
in the user-defined file system. Valid values are: <p>0 - The stream file
|
|
format is *TYPE1.</p>
|
|
<p>1 - The stream file format is *TYPE2.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZUID</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">Each user on the system must have a unique numeric user
|
|
identification number (UID).</td>
|
|
</tr>
|
|
<tr><td valign="top" width="15.19434628975265%" headers="d0e41 ">QEZURESET</td>
|
|
<td valign="top" width="17.6678445229682%" headers="d0e43 ">INTEGER</td>
|
|
<td valign="top" width="67.13780918727915%" headers="d0e45 ">The number of seconds since the Epoch that corresponds
|
|
to the date the days used count was last reset to zero (0). This date is set
|
|
to the current date when the <a href="../apis/qsetattr.htm">Qp0lSetAttr()</a> API is called to reset the Days
|
|
used count to zero.</td>
|
|
</tr>
|
|
<tr><td colspan="3" align="left" valign="top" headers="d0e41 d0e43 d0e45 "><div class="note"><span class="notetitle">Notes:</span> <ol><li>This field is included in the subset of fields used by the <span class="cmdname">PRTDIRINF</span> command.</li>
|
|
<li>In this field, only the object name is stored. The rest of the path name
|
|
is stored in field QEZDIRNAM1 if the length of the directory name is below
|
|
1 KB ( equals 1024 bytes) or in QEZDIRNAM2 if the directory names are above
|
|
1 KB (equals 1024 bytes).</li>
|
|
</ol>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section"><p>The following table is an example of a table that lists the directories
|
|
processed by the RTVDIRINF command.</p>
|
|
|
|
<div class="tablenoborder"><a name="rzaaxwwcomm__rzaaxstrdir"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzaaxwwcomm__rzaaxstrdir" frame="border" border="1" rules="all"><caption>Table 2. QAEZDxxxD (store directory's attributes)</caption><thead align="left"><tr><th valign="top" width="14.285714285714285%" id="d0e926">Field name</th>
|
|
<th valign="top" width="19.51219512195122%" id="d0e928">Field type</th>
|
|
<th valign="top" width="66.2020905923345%" id="d0e930">Field description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDFID</td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">INTEGER</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">The file ID of the directory.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDIRFID</td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">GRAPHIC (16)</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">The file ID of the directory. An identifier associated
|
|
with the object. A file ID can be used with <a href="../apis/getpthffu.htm"><span class="apiname">Qp0lGetPathFromFileID()</span></a> to
|
|
retrieve an object's path name.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDIRFSID</td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">BIGINT</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">The file system ID of the directory.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDIRGID</td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">BIGINT</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">The generation ID.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDIRIDX</td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">INTEGER</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">Identifier of path name (applies only to directories).</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDIRLEN <sup>1</sup></td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">INTEGER</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">Length of directory's path name.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDIRNAM1 <sup>1</sup></td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">VARGRAPHIC (1024)</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 "><span>The parent directory path.
|
|
Only used when path length is below 1 KB (1024 bytes).</span></td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDIRNAM2 <sup>1</sup></td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">DBCLOB (16M)</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 "><span>The parent directory path.
|
|
Only used when path length is above 1 KB (1024 bytes) long.</span> Can store
|
|
paths up to 16 MB long.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDRCCSID</td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">INTEGER</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">The directory CCSID.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZDREGION</td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">GRAPHIC (2)</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">The directory path region ID.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="14.285714285714285%" headers="d0e926 ">QEZLANGID</td>
|
|
<td valign="top" width="19.51219512195122%" headers="d0e928 ">GRAPHIC (3)</td>
|
|
<td valign="top" width="66.2020905923345%" headers="d0e930 ">The directory path language ID.</td>
|
|
</tr>
|
|
<tr><td colspan="3" align="left" valign="top" headers="d0e926 d0e928 d0e930 "><div class="note"><span class="notetitle">Note:</span> <ul><li>This field is included in the subset of fields used by the <span class="cmdname">PRTDIRINF</span> command.</li>
|
|
</ul>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section"><p><img src="./delta.gif" alt="Start of change" />The following table shows the information
|
|
that the <span class="cmdname">RTVDIRINF</span> command stores regarding the files it
|
|
has created when it runs. If the file that contains this information does
|
|
not exist, the <span class="cmdname">RTVDIRINF</span> command creates it; when the command
|
|
runs on subsequent occasions, the information is appended to the existing
|
|
file. The <span class="cmdname">PRTDIRINF</span> command uses this information to determine
|
|
which database files were used to store information that was retrieved by
|
|
different instances of the <span class="cmdname">RTVDIRINF</span> command.<img src="./deltaend.gif" alt="End of change" /></p>
|
|
|
|
<div class="tablenoborder"><a name="rzaaxwwcomm__rzaaxstrfil"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzaaxwwcomm__rzaaxstrfil" frame="border" border="1" rules="all"><caption>Table 3. QUSRSYS/QAEZDBFILE (store files created)</caption><thead align="left"><tr><th valign="top" width="21.897810218978105%" id="d0e1057">Field name</th>
|
|
<th valign="top" width="18.248175182481752%" id="d0e1059">Field type</th>
|
|
<th valign="top" width="59.854014598540154%" id="d0e1061">Field description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZDIRFILE <sup>1</sup></td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">VARGRAPHIC (20)</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">The name of the file generated to store the directory's
|
|
indexes.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZDIRSRC</td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">VARGRAPHIC (5000)</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">Path specified in DIR parameter (<span class="cmdname">RTVDIRINF</span>).</td>
|
|
</tr>
|
|
<tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZENDTIME</td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">TIMESTAMP</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">Date/Time when <span class="cmdname">RTVDIRINF</span> was completed.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZLIB <sup>1</sup></td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">VARGRAPHIC (20)</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">Library where both generated files reside.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZOBJFILE <sup>1</sup></td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">VARGRAPHIC (20)</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">The name of the file generated to store the object's
|
|
attributes.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZPLANGID</td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">GRAPHIC (3)</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">The path language ID</td>
|
|
</tr>
|
|
<tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZPRCCSID</td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">INTEGER</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">The path CCSID.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZPREGION</td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">GRAPHIC (2)</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">The path region ID.</td>
|
|
</tr>
|
|
<tr><td valign="top" width="21.897810218978105%" headers="d0e1057 ">QEZSTRTIME</td>
|
|
<td valign="top" width="18.248175182481752%" headers="d0e1059 ">TIMESTAMP</td>
|
|
<td valign="top" width="59.854014598540154%" headers="d0e1061 ">Date/Time when <span class="cmdname">RTVDIRINF</span> was submitted.</td>
|
|
</tr>
|
|
<tr><td colspan="3" align="left" valign="top" headers="d0e1057 d0e1059 d0e1061 "><div class="note"><span class="notetitle">Note:</span> <ul><li>This field is included in the subset of fields used by the <span class="cmdname">PRTDIRINF</span> command.</li>
|
|
</ul>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="rzaaxaccdata.htm">Access the data of RTVDIRINF</a></strong><br />
|
|
There exist several options for accessing the data in the tables.</li>
|
|
<li class="ulchildlink"><strong><a href="rzaaxusedata.htm">Use the data of RTVDIRINF</a></strong><br />
|
|
Here are examples that display why the data is important or how you can use the data that is produced from each of the three tables.</li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaaxifscmd.htm" title="All of the operations that you can do through the integrated file system menus and displays can be done by entering control language (CL) commands. These commands can operate on files and other objects in any file system that are accessible through the integrated file system interface.">Access using CL commands</a></div>
|
|
</div>
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
|
<div><a href="../cl/rtvdirinf.htm">Retrieve Directory Information (RTVDIRINF) command</a></div>
|
|
<div><a href="../apis/getpthff.htm">Qp01GetPathFromID() API</a></div>
|
|
<div><a href="../apis/qsetattr.htm">Qp0lSetAttr() API</a></div>
|
|
<div><a href="../cl/apyjrnchg.htm">Apply Journaled Changed (APYJRNCHG) command</a></div>
|
|
<div><a href="../cl/rmvjrnchg.htm">Remove Journaled Changes (RMVJRNCHG) command</a></div>
|
|
<div><a href="../cl/chgjrnobj.htm">Change Journaled Object (CHGJRNOBJ) command</a></div>
|
|
<div><a href="../cl/prtdirinf.htm">Print Directory Information (PRTDIRINF) command</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |