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

91 lines
6.4 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="Program modification requirements for DDM" />
<meta name="abstract" content="Remote files can be accessed by iSeries application programs written in the HLL and control language." />
<meta name="description" content="Remote files can be accessed by iSeries application programs written in the HLL and control language." />
<meta name="DC.subject" content="DDM architecture, extensions to, recompile considerations, recompiling programs, restrictions, high-level language (HLL), compiling programs, HLL (high-level language)" />
<meta name="keywords" content="DDM architecture, extensions to, recompile considerations, recompiling programs, restrictions, high-level language (HLL), compiling programs, HLL (high-level language)" />
<meta name="DC.Relation" scheme="URI" content="rbae5prepddm.htm" />
<meta name="DC.Relation" scheme="URI" content="rbae5archres.htm" />
<meta name="DC.Relation" scheme="URI" content="rbae5targetres.htm" />
<meta name="DC.Relation" scheme="URI" content="rbae5nonres.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="rbae5compile" />
<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>Program modification requirements for DDM</title>
</head>
<body id="rbae5compile"><a name="rbae5compile"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Program modification requirements for DDM</h1>
<div><p>Remote files can be accessed by <span class="keyword">iSeries™</span> application
programs written in the HLL and control language.</p>
<div class="section"><p>In most cases, these applications can access both local or remote
files without the programs being changed. However, some considerations and
restrictions might require the programs to be changed and recompiled. These
are grouped in three categories:</p>
<ul><li><span class="keyword">iSeries</span> functions that
are not supported by the DDM architecture, but for which a <span class="keyword">System/38™</span> extension
to the architecture might exist. These functions can be used only when the
source and target servers are <span class="keyword">System/38</span>s
or <span class="keyword">iSeries server</span>s.</li>
<li>Restrictions and considerations that apply when the <em>source</em> or <em>target</em> server
is an <span class="keyword">iSeries server</span>.</li>
<li>Restrictions and considerations that apply to all target servers (<span class="keyword">iSeries</span> servers and non-<span class="keyword">iSeries server</span>s).
User programs accessing local files should program for abnormal conditions
such as <em>No record found</em>, <em>End of file</em>, and <em>Record lock time-out
on read for update</em>. These conditions can also occur when a remote file
is being accessed using DDM. In addition, the use of DDM exposes the program
to communication line failures while sending disk I/O operations. <p>When
a communications failure occurs, the server sends an appropriate message to
the job, which is returned to the application program as a generic file error.
Each high-level language provides unique user syntax capabilities for user-controlled
handling or default processing of exceptional results of a disk operation.
Some languages might permit the user to retrieve the job message
identification (ID) that would specifically indicate a DDM communications
failure. Refer to the appropriate language manual for specific capabilities.</p>
<p>For
secondary SDLC lines, it is recommended that the INACTTMR parameter of the <span class="cmdname">Create
Line Description (SDLC) (CRTLINSDLC)</span> command be set on the source
and target servers to detect the stopping of polling by the primary server.
This prevents the possibility of a DDM read-for-update record lock lasting
indefinitely due to a communications failure on the primary server.</p>
</li>
</ul>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="rbae5archres.htm">DDM architecture-related restrictions</a></strong><br />
The items listed in this topic are DDM architecture-related restrictions. Therefore, application programs that use these items might have to be changed and recompiled before they can access remote files.</li>
<li class="ulchildlink"><strong><a href="rbae5targetres.htm">iSeries source and target restrictions and considerations for DDM</a></strong><br />
When the <em>source</em> server is an <span class="keyword">iSeries server</span>, <span class="keyword">iSeries</span> database functions can be used
on remote files. There are some restrictions, however.</li>
<li class="ulchildlink"><strong><a href="rbae5nonres.htm">Non-iSeries target restrictions and considerations for DDM</a></strong><br />
In addition to the restrictions that apply when the target server
is an <span class="keyword">iSeries server</span>, the restrictions
in this topic also might apply when the target server is not an <span class="keyword">iSeries server</span> or
a <span class="keyword">System/38</span>.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbae5prepddm.htm" title="There are several requirements that must be met for DDM to be used properly.">Prepare to use DDM</a></div>
</div>
</div>
</body>
</html>