ibm-information-center/dist/eclipse/plugins/i5OS.ic.dm_5.4.0.1/rbal3trig.htm

65 lines
4.3 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="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<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="Copy records into files that use trigger programs" />
<meta name="abstract" content="Triggers enable you to perform copy actions automatically when a specified change operation occurs." />
<meta name="description" content="Triggers enable you to perform copy actions automatically when a specified change operation occurs." />
<meta name="DC.subject" content="trigger program, copying file, trigger program" />
<meta name="keywords" content="trigger program, copying file, trigger program" />
<meta name="DC.Relation" scheme="URI" content="rbal3records.htm" />
<meta name="DC.Relation" scheme="URI" content="rbal3records.htm" />
<meta name="DC.Relation" scheme="URI" content="../dbp/rbaforzahftra.htm" />
<meta name="DC.Relation" scheme="URI" content="../dbp/rbafokickoff.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rbal3trig" />
<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>Copy records into files that use trigger programs</title>
</head>
<body id="rbal3trig"><a name="rbal3trig"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Copy records into files that use trigger programs</h1>
<div><p>Triggers enable you to perform copy actions automatically when
a specified change operation occurs.</p>
<p>A <dfn class="term">trigger program</dfn> is a program that contains a set of trigger
actions. A trigger action is a set of actions (high-level language statements,
SQL statements, or <span class="keyword">iSeries™</span> utilities)
that are performed automatically when a specified change operation (trigger
event) occurs on a specified table or file.</p>
<p>If records are copied to a physical file that has an *INSERT trigger program
associated with it, the trigger program is called each time a record is copied
to the file. The trigger program is not called if deleted records are copied.
If an error occurs while the trigger program is running, the copy operation
fails. However, records that were successfully copied before the error occurred
remain in the to-file.</p>
<p>If a from-file has a trigger program associated with it, the <a href="../cl/cpyf.htm">CPYF</a> and <a href="../cl/cpyfrmqryf.htm">CPYFRMQRYF</a> commands do not copy the trigger
information to the to-file when the CRTFILE parameter is used.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbal3records.htm" title="Many iSeries copy commands allows you to add or replace existing data in the to-file specifying different attributes on the MBROPT paramete.">Add, replace, and update records (MBROPT parameter)</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rbal3records.htm" title="Many iSeries copy commands allows you to add or replace existing data in the to-file specifying different attributes on the MBROPT paramete.">Add, replace, and update records (MBROPT parameter)</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../dbp/rbaforzahftra.htm">Triggers</a></div>
<div><a href="../dbp/rbafokickoff.htm">Database programming</a></div>
</div>
</div>
</body>
</html>