ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/objdatacmds.htm

92 lines
5.9 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="Data manipulation commands" />
<meta name="abstract" content="A CL procedure or program can use several commands, called data manipulation commands." />
<meta name="description" content="A CL procedure or program can use several commands, called data manipulation commands." />
<meta name="DC.subject" content="variable, indicator declared as variable" />
<meta name="keywords" content="variable, indicator declared as variable" />
<meta name="DC.Relation" scheme="URI" content="wfile.htm" />
<meta name="DC.Relation" scheme="URI" content="../clfinder/finder.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="objdatacmds" />
<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>Data manipulation commands</title>
</head>
<body id="objdatacmds"><a name="objdatacmds"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Data manipulation commands</h1>
<div><p>A CL procedure or program can use several commands, called data
manipulation commands.</p>
<div class="section"><p>These commands let you refer to a display file to send data to
and receive data from device displays. These commands also allows you to refer
to a database file to read records from a database file. These commands are:</p>
<dl><dt class="dlterm"><span class="cmdname">Declare File (DCLF)</span></dt>
<dd>Defines a display or database file to be used in a procedure or program.
The fields in the file are automatically declared as variables for use in
the procedure or program.</dd>
<dt class="dlterm"><span class="cmdname">Send File (SNDF)</span></dt>
<dd>Sends data to the display.</dd>
<dt class="dlterm"><span class="cmdname">Receive File (RCVF)</span></dt>
<dd>Receives data from the display or database.</dd>
<dt class="dlterm"><span class="cmdname">Send/Receive File (SNDRCVF)</span></dt>
<dd>Sends data to the display; then asks for input and, optionally, receives
data from the display.</dd>
<dt class="dlterm"><span class="cmdname">Override with Display File (OVRDSPF)</span></dt>
<dd>Allows a run-time override of a file used by a procedure or program with
a display file.</dd>
<dt class="dlterm"><span class="cmdname">Override with Database File (OVRDBF)</span></dt>
<dd>Allows a run-time override of a file used by a procedure or program with
a database file.</dd>
</dl>
<p>These commands let a running program communicate with a
device display using the display functions provided by DDS, and to read records
from a database file. DDS provides functions for writing menus and performing
basic application-oriented data requests that are characteristic of many CL
applications.</p>
<br /><img src="rbafn505.gif" alt="These commands let a running program communicate with a device display using the display functions provided by DDS, and to read records from a database file. DDS provides functions for writing menus and performing basic application-oriented data requests that are characteristic of many CL applications." /><br /> <p>The fields on the display
or in the record are identified in the DDS for the file. In order for the
CL procedure or program to use the fields, the file must be referred to in
the CL procedure or program by the <span class="cmdname">Declare File (DCLF)</span> command.
This reference causes the fields and indicators in the file to be declared
automatically in your procedure or program as variables. You can use these
variables in any way in CL commands; however, their primary purpose is to
send information to and receive information from a display. The <span class="cmdname">Declare
File (DCLF)</span> command is not used at run time.</p>
<p>The format of
the display and the options for the fields are specified in the device file
and controlled through the use of indicators. Up to 99 indicator values can
be used with DDS and CL support. Indicator variables are declared in your
CL procedure or program in the form of logical variables with names &amp;IN01
through &amp;IN99 for each indicator that appears in the device file record
formats referred to on the <span class="cmdname">Declare File (DCLF)</span> command.
Indicators let you display fields and control data management display functions,
and provide response information to your procedure or program from the device
display. Indicators are not used with database files.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="wfile.htm" title="Two types of files are supported in CL procedures and programs: display files and database files.">Work with files in CL procedures</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../clfinder/finder.htm">CL command finder</a></div>
</div>
</div>
</body>
</html>