219 lines
7.0 KiB
HTML
219 lines
7.0 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Change PF Trigger (CHGPFTRG)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="CHGPFTRG.Top_Of_Page"></a>
|
|
<h2>Change PF Trigger (CHGPFTRG)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#CHGPFTRG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGPFTRG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGPFTRG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGPFTRG"></a>
|
|
<p>The Change Physical File Trigger (CHGPFTRG) command changes the state of one or all triggers for a file. The triggers have been defined with either the SQL CREATE TRIGGER or the Add Physical File Trigger (ADDPFTRG) command.
|
|
</p>
|
|
<p>The state of a trigger can be changed to disabled (stopped from being called during I/O operations) or, if it has been disabled, to enabled (called during I/O operations again). The alternative to changing the state of the trigger is to remove it when you do not want it to be called, and add it again when you need it.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ul>
|
|
<li>You must have object management (*OBJMGT) or object alter (*OBJALTER) authority to the physical file.
|
|
</li>
|
|
<li>You must have execute (*EXECUTE) authority to the library that contains the physical file.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPFTRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGPFTRG.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGPFTRG.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">File</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: File</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CHGPFTRG.TRG"><b>TRG</b></a></td>
|
|
<td valign="top">Trigger</td>
|
|
<td valign="top"><i>Character value</i>, *ALL</td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGPFTRG.TRGLIB"><b>TRGLIB</b></a></td>
|
|
<td valign="top">Trigger library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALL</u></b>, *CURLIB</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGPFTRG.STATE"><b>STATE</b></a></td>
|
|
<td valign="top">Trigger state</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *ENABLED, *DISABLED</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPFTRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGPFTRG.FILE"></a>
|
|
<h3>File (FILE)</h3>
|
|
<p>Specifies the file for which a trigger is to be changed. The file must be a physical file.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: File</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the physical file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be searched.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPFTRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPFTRG.TRG"></a>
|
|
<h3>Trigger (TRG)</h3>
|
|
<p>Specifies the name of the trigger to be changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All of the triggers for the file are changed.
|
|
<p>
|
|
<b>Note: </b>When *ALL is specified, all triggers defined for the file will be changed. Any value specified for the <b>Trigger library (TRGLIB)</b> parameter will be ignored.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>character-value</i></b></dt>
|
|
<dd>Specify the name of the trigger.
|
|
<p>
|
|
<b>Note: </b>The case is preserved when lowercase characters are specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPFTRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPFTRG.TRGLIB"></a>
|
|
<h3>Trigger library (TRGLIB)</h3>
|
|
<p>Specifies the library for the trigger to be changed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All triggers in all trigger libraries will be used.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used. If no library is specified as the current library for the job, the QGPL library is used.
|
|
<p>
|
|
<b>Note: </b>The special value *CURLIB is the value of the job running when the trigger is changed.
|
|
</p>
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the library to be used.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPFTRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGPFTRG.STATE"></a>
|
|
<h3>Trigger state (STATE)</h3>
|
|
<p>Specifies the state to which the trigger is to be changed. You can use this parameter to temporarily stop a trigger from being called (disable), or to make a trigger that was previously disabled called again during I/O operations (enable).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value does not change.
|
|
</dd>
|
|
<dt><b>*ENABLED</b></dt>
|
|
<dd>The trigger that was disabled will be called during I/O operations again.
|
|
</dd>
|
|
<dt><b>*DISABLED</b></dt>
|
|
<dd>The trigger will not be called during I/O operations.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPFTRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGPFTRG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
CHGPFTRG FILE(ADMN/PERSONNEL) TRG(*ALL) STATE(*DISABLED)
|
|
</pre>
|
|
</p>
|
|
<p>This command disables all triggers for the PERSONNEL file in the ADMN library.
|
|
</p>
|
|
<p>The following command causes all triggers to be called again:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGPFTRG FILE(ADMN/PERSONNEL) TRG(*ALL) STATE(*ENABLED)
|
|
</pre>
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPFTRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGPFTRG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF32C6</b></dt>
|
|
<dd>Trigger operation not successful.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGPFTRG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|