ibm-information-center/dist/eclipse/plugins/i5OS.ic.ddm_5.4.0.1/rbae5plop.htm

134 lines
7.8 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="PL/I open file requests" />
<meta name="abstract" content="The i5/OS DDM user can access remote CICS files with PL/I programs." />
<meta name="description" content="The i5/OS DDM user can access remote CICS files with PL/I programs." />
<meta name="DC.Relation" scheme="URI" content="rbae5xplcon.htm" />
<meta name="DC.Relation" scheme="URI" content="rbae5pliio.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="rbae5plop" />
<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>PL/I open file requests</title>
</head>
<body id="rbae5plop"><a name="rbae5plop"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">PL/I open file requests</h1>
<div><p>The <span class="keyword">i5/OS™</span> DDM
user can access remote CICS<sup>®</sup> files with PL/I programs.</p>
<div class="section"><p> When opening the file with the RECORD file attribute, the program
must use the file attributes specified in the table below. By noting the values
that appear in this table, you can determine the difference between accessing
an <span class="keyword">iSeries™</span> database file and
a remote VSAM data set.</p>
</div>
<div class="section"> <div class="note"><span class="notetitle">Note:</span> Remote files can also be opened with the PL/I STREAM file
attribute. However, if the STREAM file attribute is used to open a VSAM KSDS,
a server message occurs. This happens because records in a VSAM KSDS cannot
be processed in arrival sequence.</div>
</div>
<div class="section"><p>Unless the CICS system has replaced the CICS/DDM exclusive file
locking program, you cannot use the EXCL and EXCLRD file locking options for
the ENVIRONMENT parameter when opening a remote VSAM data set. </p>
</div>
<div class="tablenoborder"><a name="rbae5plop__rbae5figpl"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rbae5plop__rbae5figpl" width="100%" frame="border" border="1" rules="all"><caption>Table 1. PL/I file attributes</caption><thead align="left"><tr><th rowspan="2" align="left" valign="bottom" width="20%" id="d0e50"> PL/I file attributes</th>
<th colspan="4" align="center" valign="bottom" id="d0e52">VSAM data
set organization</th>
</tr>
<tr><th align="left" valign="bottom" width="20%" id="d0e55">ESDS</th>
<th align="left" valign="bottom" width="20%" id="d0e57">RRDS</th>
<th align="left" valign="bottom" width="20%" id="d0e59">KSDS</th>
<th align="left" valign="bottom" width="20%" id="d0e61">VSAM Path</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="20%" headers="d0e50 ">SEQUENTIAL</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e55 ">R</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e57 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e59 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e61 ">O</td>
</tr>
<tr><td align="left" valign="top" width="20%" headers="d0e50 ">DIRECT</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e55 ">E</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e57 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e59 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e61 ">O</td>
</tr>
<tr><td align="left" valign="top" width="20%" headers="d0e50 ">SEQL KEYED</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e55 ">E</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e57 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e59 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e61 ">O</td>
</tr>
<tr><td align="left" valign="top" width="20%" headers="d0e50 ">INPUT</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e55 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e57 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e59 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e61 ">O</td>
</tr>
<tr><td align="left" valign="top" width="20%" headers="d0e50 ">OUTPUT</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e55 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e57 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e59 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e61 ">E</td>
</tr>
<tr><td align="left" valign="top" width="20%" headers="d0e50 ">UPDATE</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e55 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e57 ">O</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e59 ">E</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e61 ">E</td>
</tr>
<tr><td align="left" valign="top" width="20%" headers="d0e50 ">CONSECUTIVE</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e55 ">R</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e57 ">R</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e59 ">E</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e61 ">E</td>
</tr>
<tr><td align="left" valign="top" width="20%" headers="d0e50 ">INDEXED</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e55 "></td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e57 "></td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e59 ">R</td>
<td align="left" valign="top" width="20%" headers="d0e52 d0e61 ">R</td>
</tr>
<tr><td colspan="5" align="left" valign="top" headers="d0e50 d0e52 d0e55 d0e57 d0e59 d0e61 "><p>Where: </p>
<dl><dt class="dlterm">R</dt>
<dd>Shows the attribute is required for accessing the VSAM data set.</dd>
<dt class="dlterm">O</dt>
<dd>Shows the attribute is optional for accessing the VSAM data set.</dd>
<dt class="dlterm">E</dt>
<dd>Shows the attribute is allowed by PL/I but the open fails when accessing
the VSAM data set.</dd>
<dt class="dlterm"></dt>
<dd>Shows the option is valid for keyed files only.</dd>
</dl>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbae5xplcon.htm" title="These topics summarize the limitations that exist when using PL/I to access remote VSAM data sets from an iSeries server. These limitations should be considered in addition to those already stated in this topic collection.">PL/I considerations</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="rbae5pliio.htm" title="This topic discusses the types of PL/I input/output requests and their restrictions.">PL/I input/output requests</a></div>
</div>
</div>
</body>
</html>