ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaii_5.4.0.1/rzaiimstexfile.htm

158 lines
8.7 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="concept" />
<meta name="DC.Title" content="File server" />
<meta name="abstract" content="Identify exit point for file server." />
<meta name="description" content="Identify exit point for file server." />
<meta name="DC.Relation" scheme="URI" content="rzaiimst35.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaiimstexfile" />
<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>File server</title>
</head>
<body id="rzaiimstexfile"><a name="rzaiimstexfile"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">File server</h1>
<div><p>Identify exit point for file server.</p>
<p>The file server has one exit point defined:</p>
<p id="rzaiimstexfile__IDX247"><a name="rzaiimstexfile__IDX247"><!-- --></a>QIBM_QPWFS_FILE_SERV Format PWFS0100</p>
<p>The QIBM_QPWFS_FILE_SERV exit point is defined to run an exit program for
the following types of file server requests:</p>
<ul><li>Change file attributes</li>
<li>Create stream file or create directory</li>
<li>Delete file or delete directory</li>
<li>List file attributes</li>
<li>Move</li>
<li>Open stream file</li>
<li>Rename</li>
<li>Allocate conversation</li>
</ul>
<div class="note"><span class="notetitle">Notes:</span> <ul><li>For the file server, the exit program name is resolved when the QSERVER
subsystem is activated. If you change the program name, you must end and restart
the subsystem for the change to take effect.</li>
<li>For file server requests that provide the file name to the exit program,
the user must have a minimum of *RX authority to each directory in the path
name preceding the object. If the user does not have the required authority,
the request will fail.</li>
</ul>
</div>
<div class="section"><h4 class="sectiontitle">Exit point QIBM_QPWFS_FILE_SERV format PWFS0100</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><thead align="left"><tr><th colspan="2" valign="top" id="d0e53">Offset</th>
<th rowspan="2" valign="top" width="20%" id="d0e55">Type</th>
<th rowspan="2" valign="top" width="20%" id="d0e57">Field</th>
<th rowspan="2" valign="top" width="40%" id="d0e59">Description</th>
</tr>
<tr><th valign="top" width="10%" id="d0e62">Dec</th>
<th valign="top" width="10%" id="d0e64">Hex</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="10%" headers="d0e53 d0e62 ">0</td>
<td valign="top" width="10%" headers="d0e53 d0e64 ">0</td>
<td valign="top" width="20%" headers="d0e55 ">CHAR(10)</td>
<td valign="top" width="20%" headers="d0e57 ">User profile name</td>
<td valign="top" width="40%" headers="d0e59 ">The name of the user profile that is calling the server</td>
</tr>
<tr><td valign="top" width="10%" headers="d0e53 d0e62 ">10</td>
<td valign="top" width="10%" headers="d0e53 d0e64 ">A</td>
<td valign="top" width="20%" headers="d0e55 ">CHAR(10)</td>
<td valign="top" width="20%" headers="d0e57 ">Server identifier</td>
<td valign="top" width="40%" headers="d0e59 ">For the file server, the value is *FILESRV.</td>
</tr>
<tr><td valign="top" width="10%" headers="d0e53 d0e62 ">20</td>
<td valign="top" width="10%" headers="d0e53 d0e64 ">14</td>
<td valign="top" width="20%" headers="d0e55 ">BINARY(4)</td>
<td valign="top" width="20%" headers="d0e57 ">Requested function</td>
<td valign="top" width="40%" headers="d0e59 ">The function being performed: <ul><li><span class="uicontrol">X'0000'</span> - Change file attributes request</li>
<li><span class="uicontrol">X'0001'</span> - Create stream file or directory request</li>
<li><span class="uicontrol">X'0002'</span> - Delete file or delete directory request</li>
<li><span class="uicontrol">X'0003'</span> - List file attributes request</li>
<li><span class="uicontrol">X'0004'</span> - Move request</li>
<li><span class="uicontrol">X'0005'</span> - Open stream file request</li>
<li><span class="uicontrol">X'0006'</span> - Rename request</li>
<li><span class="uicontrol">X'0007'</span> - Allocate conversation request</li>
</ul>
</td>
</tr>
<tr><td valign="top" width="10%" headers="d0e53 d0e62 ">24</td>
<td valign="top" width="10%" headers="d0e53 d0e64 ">18</td>
<td valign="top" width="20%" headers="d0e55 ">CHAR(8)</td>
<td valign="top" width="20%" headers="d0e57 ">Format name</td>
<td valign="top" width="40%" headers="d0e59 ">The user exit format name being used. For QIBM_QPWFS_FILE_SERV, the
format name is PWFS0100.</td>
</tr>
<tr><td valign="top" width="10%" headers="d0e53 d0e62 ">32</td>
<td valign="top" width="10%" headers="d0e53 d0e64 ">20</td>
<td valign="top" width="20%" headers="d0e55 ">CHAR(4)</td>
<td valign="top" width="20%" headers="d0e57 ">File access</td>
<td valign="top" width="40%" headers="d0e59 ">If the requested function has a value of <span class="uicontrol">X'0005'</span> (open),
this field contains the following structure: <ul><li>Read access, CHAR(1) <span class="uicontrol">X'F1'</span> - Yes <span class="uicontrol">X'F0'</span> -
No</li>
<li>Write access, CHAR(1) <span class="uicontrol">X'F1'</span> - Yes <span class="uicontrol">X'F0'</span> -
No</li>
<li>Read/Write access, CHAR(1) <span class="uicontrol">X'F1'</span> - Yes <span class="uicontrol">X'F0'</span> -
No</li>
<li>Delete allowed, CHAR(1) <span class="uicontrol">X'F1'</span> - Yes <span class="uicontrol">X'F0'</span> -
No</li>
</ul>
</td>
</tr>
<tr><td valign="top" width="10%" headers="d0e53 d0e62 ">36</td>
<td valign="top" width="10%" headers="d0e53 d0e64 ">24</td>
<td valign="top" width="20%" headers="d0e55 ">BINARY(4)</td>
<td valign="top" width="20%" headers="d0e57 ">File name length</td>
<td valign="top" width="40%" headers="d0e59 ">The length of the file name (the next field). The length can be a maximum
of 16MB. If the requested function has a value of <span class="uicontrol">X'0007'</span> (Allocate
conversation request), the file name length is 0.</td>
</tr>
<tr><td valign="top" width="10%" headers="d0e53 d0e62 ">40</td>
<td valign="top" width="10%" headers="d0e53 d0e64 ">28</td>
<td valign="top" width="20%" headers="d0e55 ">CHAR(*)</td>
<td valign="top" width="20%" headers="d0e57 ">File name</td>
<td valign="top" width="40%" headers="d0e59 ">The name of the file. The length of this field is specified by the
File Name Length (the previous field). The file name is returned in CCSID
1200.<div class="p">If a requested function has a value of one of the following, the file
name is provided and the file name length is set:<ul><li><span class="uicontrol">X'0000'</span> - Change file attributes request</li>
<li><span class="uicontrol">X'0001'</span> - Create stream file or directory request</li>
<li><span class="uicontrol">X'0002'</span> - Delete file or delete directory request</li>
<li><span class="uicontrol">X'0003'</span> - List file attributes request</li>
<li><span class="uicontrol">X'0004'</span> - Move request</li>
<li><span class="uicontrol">X'0005'</span> - Open stream file request</li>
<li><span class="uicontrol">X'0006'</span> - Rename request</li>
</ul>
</div>
</td>
</tr>
<tr><td colspan="5" valign="top" headers="d0e53 d0e55 d0e57 d0e59 d0e62 d0e64 "><div class="note"><span class="notetitle">Notes:</span> <ul><li>This format is defined by member EPWFSEP in files H, QRPGSRC, QRPGLESRC,
QLBLSRC and QCBLLESRC in library QSYSINC.</li>
<li>The APIs available to convert to and from CCSID 1200 are iconv() and CDRCVRT.</li>
</ul>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiimst35.htm" title="Identify exit points for the servers.">Exit program parameters</a></div>
</div>
</div>
</body>
</html>