144 lines
7.7 KiB
HTML
144 lines
7.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="reference" />
|
|||
|
|
<meta name="DC.Title" content="Trigger buffer field descriptions" />
|
|||
|
|
<meta name="abstract" content="This topic describes the fields that are contained in the trigger buffer, in alphabetical order." />
|
|||
|
|
<meta name="description" content="This topic describes the fields that are contained in the trigger buffer, in alphabetical order." />
|
|||
|
|
<meta name="DC.Relation" scheme="URI" content="rbaforzahftrc.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="rbaforzahftrd" />
|
|||
|
|
<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>Trigger buffer field descriptions</title>
|
|||
|
|
</head>
|
|||
|
|
<body id="rbaforzahftrd"><a name="rbaforzahftrd"><!-- --></a>
|
|||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|||
|
|
<h1 class="topictitle1">Trigger buffer field descriptions</h1>
|
|||
|
|
<div><p>This topic describes the fields that are contained in the trigger
|
|||
|
|
buffer, in alphabetical order.</p>
|
|||
|
|
<div class="section"><div class="p"> <dl><dt class="dlterm">CCSID of data</dt>
|
|||
|
|
<dd>The CCSID of the data in the new or the original records. The data is
|
|||
|
|
converted to the job CCSID by the database. SBCS data is converted to the
|
|||
|
|
single byte associated CCSID. DBCS data is converted to the double byte associated
|
|||
|
|
CCSID.</dd>
|
|||
|
|
<dt class="dlterm">Commit lock level</dt>
|
|||
|
|
<dd>The commit lock level of the current application program. The possible
|
|||
|
|
values are: <dl><dt class="dlterm">'0'</dt>
|
|||
|
|
<dd>*NONE</dd>
|
|||
|
|
<dt class="dlterm">'1'</dt>
|
|||
|
|
<dd>*CHG</dd>
|
|||
|
|
<dt class="dlterm">'2'</dt>
|
|||
|
|
<dd>*CS</dd>
|
|||
|
|
<dt class="dlterm">'3'</dt>
|
|||
|
|
<dd>*ALL</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="dlterm"><img src="./delta.gif" alt="Start of change" />File library name<img src="./deltaend.gif" alt="End of change" /></dt>
|
|||
|
|
<dd><img src="./delta.gif" alt="Start of change" />The name of the library in which the database file resides.<img src="./deltaend.gif" alt="End of change" /></dd>
|
|||
|
|
<dt class="dlterm"><img src="./delta.gif" alt="Start of change" />File member name<img src="./deltaend.gif" alt="End of change" /></dt>
|
|||
|
|
<dd><img src="./delta.gif" alt="Start of change" />The name of the database file member.<img src="./deltaend.gif" alt="End of change" /></dd>
|
|||
|
|
<dt class="dlterm"><img src="./delta.gif" alt="Start of change" />File name<img src="./deltaend.gif" alt="End of change" /></dt>
|
|||
|
|
<dd><img src="./delta.gif" alt="Start of change" />The name of the physical file being changed or read.<img src="./deltaend.gif" alt="End of change" /></dd>
|
|||
|
|
<dt class="dlterm">New record</dt>
|
|||
|
|
<dd>A copy of the record that is being inserted or updated in a physical file
|
|||
|
|
as a result of the change operation. The new record only applies to the insert
|
|||
|
|
or update operations.</dd>
|
|||
|
|
<dt class="dlterm">New record length</dt>
|
|||
|
|
<dd>The maximum length is 32 766 bytes.</dd>
|
|||
|
|
<dt class="dlterm">New record null byte map</dt>
|
|||
|
|
<dd>This structure contains the NULL value information for each field of the
|
|||
|
|
new record. Each byte represents one field. The possible values for each byte
|
|||
|
|
are: <dl><dt class="dlterm">'0'</dt>
|
|||
|
|
<dd>Not NULL</dd>
|
|||
|
|
<dt class="dlterm">'1'</dt>
|
|||
|
|
<dd>NULL</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="dlterm">New record null byte map length</dt>
|
|||
|
|
<dd>The length is equal to the number of fields in the physical file.</dd>
|
|||
|
|
<dt class="dlterm">New record null byte map offset</dt>
|
|||
|
|
<dd>The location of the null byte map of the new record. The offset value
|
|||
|
|
is from the beginning of the trigger buffer. This field is not applicable
|
|||
|
|
if the new value of the record does not apply to the change operation, for
|
|||
|
|
example, a delete operation.</dd>
|
|||
|
|
<dt class="dlterm">New record offset</dt>
|
|||
|
|
<dd>The location of the new record. The offset value is from the beginning
|
|||
|
|
of the trigger buffer. This field is not applicable if the new value of the
|
|||
|
|
record does not apply to the change operation, for example, a delete operation.</dd>
|
|||
|
|
<dt class="dlterm">Original record</dt>
|
|||
|
|
<dd>A copy of the original physical record before being updated, deleted,
|
|||
|
|
or read. The original record applies only to update, delete, and read operations.</dd>
|
|||
|
|
<dt class="dlterm">Original record length</dt>
|
|||
|
|
<dd>The maximum length is 32 766 bytes.</dd>
|
|||
|
|
<dt class="dlterm">Original record null byte map</dt>
|
|||
|
|
<dd>This structure contains the NULL value information for each field of the
|
|||
|
|
original record. Each byte represents one field. The possible values for each
|
|||
|
|
byte are: <dl><dt class="dlterm">'0'</dt>
|
|||
|
|
<dd>Not NULL</dd>
|
|||
|
|
<dt class="dlterm">'1'</dt>
|
|||
|
|
<dd>NULL</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="dlterm">Original record null byte map length</dt>
|
|||
|
|
<dd>The length is equal to the number of fields in the physical file.</dd>
|
|||
|
|
<dt class="dlterm">Original record null byte map offset</dt>
|
|||
|
|
<dd>The location of the null byte map of the original record. The offset value
|
|||
|
|
is from the beginning of the trigger buffer. This field is not applicable
|
|||
|
|
if the original value of the record does not apply to the change operation,
|
|||
|
|
for example, an insert operation.</dd>
|
|||
|
|
<dt class="dlterm">Original record offset</dt>
|
|||
|
|
<dd>The location of the original record. The offset value is from the beginning
|
|||
|
|
of the trigger buffer. This field is not applicable if the original value
|
|||
|
|
of the record does not apply to the operation; for example, an insert operation.</dd>
|
|||
|
|
<dt class="dlterm">Relative Record Number</dt>
|
|||
|
|
<dd>The relative record number of the record to be updated or deleted (*BEFORE
|
|||
|
|
triggers) or the relative record number of the record which was inserted,
|
|||
|
|
updated, deleted, or read(*AFTER triggers).</dd>
|
|||
|
|
<dt class="dlterm">Trigger event</dt>
|
|||
|
|
<dd>The event that caused the trigger program to be called. The possible values
|
|||
|
|
are: <dl><dt class="dlterm">'1'</dt>
|
|||
|
|
<dd>Insert operation</dd>
|
|||
|
|
<dt class="dlterm">'2'</dt>
|
|||
|
|
<dd>Delete operation</dd>
|
|||
|
|
<dt class="dlterm">'3'</dt>
|
|||
|
|
<dd>Update operation</dd>
|
|||
|
|
<dt class="dlterm">'4'</dt>
|
|||
|
|
<dd>Read operation</dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd>
|
|||
|
|
<dt class="dlterm">Trigger time</dt>
|
|||
|
|
<dd><p><img src="./delta.gif" alt="Start of change" />The time, relative to the operation on the database
|
|||
|
|
file, when the trigger program is called. The possible values are:<img src="./deltaend.gif" alt="End of change" /></p>
|
|||
|
|
<dl><dt class="dlterm">'1'</dt>
|
|||
|
|
<dd>After the change or read operation</dd>
|
|||
|
|
<dt class="dlterm">'2'</dt>
|
|||
|
|
<dd>Before the change operation</dd>
|
|||
|
|
<dt class="dlterm"><img src="./delta.gif" alt="Start of change" />'3'<img src="./deltaend.gif" alt="End of change" /></dt>
|
|||
|
|
<dd><img src="./delta.gif" alt="Start of change" />Instead of the change operation<img src="./deltaend.gif" alt="End of change" /></dd>
|
|||
|
|
</dl>
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
<div>
|
|||
|
|
<div class="familylinks">
|
|||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rbaforzahftrc.htm" title="The trigger buffer has two logical sections: a static section and a variable section.">Trigger buffer sections</a></div>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
</body>
|
|||
|
|
</html>
|