361 lines
15 KiB
HTML
361 lines
15 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>Work with Commitment Def (WRKCMTDFN)</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="WRKCMTDFN.Top_Of_Page"></a>
|
|
<h2>Work with Commitment Def (WRKCMTDFN)</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="#WRKCMTDFN.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#WRKCMTDFN.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#WRKCMTDFN.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="WRKCMTDFN"></a>
|
|
<p>The Work with Commitment Definitions (WRKCMTDFN) command is used to work with the commitment definitions on the system. A commitment definition is used to store information about commitment control when commitment control is started by the Start Commitment Control (STRCMTCTL) command. These commitment definitions may or may not be associated with an active job. Those not associated with an active job have been ended, but one or more of its logical units of work has not yet been completed.
|
|
</p>
|
|
<p>The STATUS parameter can be used to subset the list of commitment definitions by their status. For example, a status value of *RESYNC displays a list of all commitment definitions that are involved with resynchronizing their resources. Commitment definitions may be involved with resynchronizing resources in an effort to reestablish a synchronization point across the logical unit of work. A synchronization point is where all resources within a logical unit of work are in consistent state. A status value of *UNDECIDED displays a list of all commitment definitions involved with a commit operation that are waiting to receive the decision to either commit or rollback. A status value of *XOPEN displays a list of all commitment definitions associated with an X/Open global transaction.
|
|
</p>
|
|
<p>The ASP group parameter can be used to subset the list of commitment definitions by the auxiliary storage pool (ASP) on which they reside.
|
|
</p>
|
|
<p>The logical unit of work identifier (LUWID) parameter can be used when trying to find the commitment definition on the system which is working with a commitment definition on another system. The jobs containing these commitment definitions are communicating using an APPC conversation. An LUWID can be found by displaying the commitment definition on one system and then using it as input to the WRKCMTDFN command to find the corresponding commitment definition.
|
|
</p>
|
|
<p>The duplicate job option (DUPJOBOPT) parameter specifies the action taken when duplicate jobs are found by this command. If duplicate jobs are found they can either be displayed in a list the user can select from or a message can be issued for each duplicate job found.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="WRKCMTDFN.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="4"><a href="#WRKCMTDFN.JOB"><b>JOB</b></a></td>
|
|
<td valign="top">Job name</td>
|
|
<td valign="top">Single values: <b><u>*</u></b>, *ALL<br>Other values: <i>Qualified job name</i></td>
|
|
<td valign="top" rowspan="4">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Job name</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: User</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 3: Number</td>
|
|
<td valign="top">000000-999999</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#WRKCMTDFN.STATUS"><b>STATUS</b></a></td>
|
|
<td valign="top">Status</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *RESYNC, *UNDECIDED, *XOPEN</td>
|
|
<td valign="top">Optional, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKCMTDFN.ASPGRP"><b>ASPGRP</b></a></td>
|
|
<td valign="top">ASP group</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*ALLAVL</u></b>, *SYSBAS</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKCMTDFN.LUWID"><b>LUWID</b></a></td>
|
|
<td valign="top">Logical unit of work ID</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*ALL</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKCMTDFN.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKCMTDFN.DUPJOBOPT"><b>DUPJOBOPT</b></a></td>
|
|
<td valign="top">Duplicate job option</td>
|
|
<td valign="top"><b><u>*SELECT</u></b>, *MSG</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="WRKCMTDFN.JOB"></a>
|
|
<h3>Job name (JOB)</h3>
|
|
<p>Specifies the names of the jobs (if any) whose commitment definitions are shown. If a job name is not qualified, all jobs by that name have their commitment definitions displayed. When *ALL is not specified, only commitment definitions with lock scope *JOB are shown, even though commitment definitions with lock scope *TNSOBJ may be attached to threads in the specified jobs. To show commitment definitions with lock scope *TNSOBJ, *ALL must be specified.
|
|
</p>
|
|
<p>A job identifier is a special value or a qualified name with up to three elements. For example:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
*
|
|
*ALL
|
|
job-name
|
|
user-name/job-name
|
|
job-number/user-name/job-name
|
|
</pre>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>The commitment definitions which are associated with the job where the WRKCMTDFN command is issued are shown.
|
|
</dd>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>Commitment definitions for all jobs on the system are shown.
|
|
</dd>
|
|
<dt><b><i>job-name</i></b></dt>
|
|
<dd>Specify the name of the job which is associated with the commitment definitions to be shown.
|
|
</dd>
|
|
<dt><b><i>user-name</i></b></dt>
|
|
<dd>Specify the name of the user which is associated with the commitment definitions to be shown.
|
|
</dd>
|
|
<dt><b><i>job-number</i></b></dt>
|
|
<dd>Specify the number of the job which is associated with the commitment definitions to be shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKCMTDFN.STATUS"></a>
|
|
<h3>Status (STATUS)</h3>
|
|
<p>Specifies that only the commitment definitions with a status that matches the value specified on this parameter are listed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Commitment definitions with all status' are shown.
|
|
</dd>
|
|
<dt><b>*RESYNC</b></dt>
|
|
<dd>Only commitment definitions which are involved with resynchronizing resources are shown. A commitment definition may be involved with resynchronization in an effort to reestablish a synchronization point. A synchronization point is the point where all resources are in a consistent state.
|
|
</dd>
|
|
<dt><b>*UNDECIDED</b></dt>
|
|
<dd>Only commitment definitions whose logical unit of work is in a state that is undecided are shown. A commitment definition is in an undecided state when the decision to either commit or rollback resources is unknown to the commitment definition.
|
|
</dd>
|
|
<dt><b>*XOPEN</b></dt>
|
|
<dd>Only commitment definitions associated with an X/Open global transaction are shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKCMTDFN.ASPGRP"></a>
|
|
<h3>ASP group (ASP Group)</h3>
|
|
<p>Specifies the Auxiliary Storage Pool (ASP) group of the commitment definitions to be shown.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALLAVL</u></b></dt>
|
|
<dd>All commitment definitions in all online ASPs are shown.
|
|
</dd>
|
|
<dt><b>*SYSBAS</b></dt>
|
|
<dd>Only commitment definitions in the system ASP (ASP number 1) and basic ASPs (ASP numbers 2-32) are shown.
|
|
</dd>
|
|
<dt><b><i>auxiliary-storage-pool-group-name</i></b></dt>
|
|
<dd>Only commitment definitions in the specified ASP group are shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKCMTDFN.LUWID"></a>
|
|
<h3>Logical unit of work ID (LUWID)</h3>
|
|
<p>Specifies the logical unit of work identifier of the commitment definition to be shown.
|
|
</p>
|
|
<p>A logical unit of work identifier is a character string made up of three elements:
|
|
</p>
|
|
<ul>
|
|
<li>Network-qualified logical unit (LU) name
|
|
</li>
|
|
<li>Instance number
|
|
</li>
|
|
<li>Sequence number
|
|
</li>
|
|
</ul>
|
|
<p>The network-qualified LU name consists of a character network ID with a maximum of 8 characters, a period delimiter, followed by a LU name with a maximum of 8 characters. The instance number is entered as a 12 character value, each character representing a single hexadecimal digit. The value must be entered in hexadecimal format. For example, X'123456789012'. The sequence number is a decimal value with values ranging from 1 through 65535. For example:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
APPN.RCHASLGU.X'12578A3BDCFF'.23657
|
|
</pre>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>Commitment definitions associated with all logical units of work are shown.
|
|
</dd>
|
|
<dt><b><i>generic*-logical-unit-of-work-identifier</i></b></dt>
|
|
<dd>Specify the generic name of a logical unit of work identifier. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If a generic name is specified, all commitment definitions with logical unit of work identifiers that begin with the generic name are shown. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete logical unit of work identifier.
|
|
</dd>
|
|
<dt><b><i>logical-unit-of-work-identifier</i></b></dt>
|
|
<dd>Specify a maximum of 39 characters for the logical unit of work identifier associated with a commitment definition.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKCMTDFN.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is shown at the requesting display station or printed with the job's spooled output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.
|
|
</dd>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKCMTDFN.DUPJOBOPT"></a>
|
|
<h3>Duplicate job option (DUPJOBOPT)</h3>
|
|
<p>Specifies the action taken when duplicate jobs are found by this command.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SELECT</u></b></dt>
|
|
<dd>The Selection display is shown when duplicate jobs are found during an interactive session. For a batch job, a message is shown.
|
|
</dd>
|
|
<dt><b>*MSG</b></dt>
|
|
<dd>A message is issued when duplicate jobs are found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKCMTDFN.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Limiting by Job</b>
|
|
</p>
|
|
<p>The following example will display a list of commitment definitions associated with the specified job. Of all the commitment definitions on the system, only those associated with the specified job will be listed.
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKCMTDFN JOB(012345/WULF/WULFS1)
|
|
</pre>
|
|
</p>
|
|
<p><b>Example 2: Limiting by Commitment Definitions Involved with Resynchronizing Resources</b>
|
|
</p>
|
|
<p>The following example will display a list of all of the commitment definitions on the system that are involved with resynchronizing their resources.
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKCMTDFN JOB(*ALL) STATUS(*RESYNC)
|
|
</pre>
|
|
</p>
|
|
<p><b>Example 3: Limiting by Commitment Definitions That Are Undecided</b>
|
|
</p>
|
|
<p>The following example will display a list of all of the commitment definitions on the system that are in an undecided state. The commitment definitions are in an undecided state when their logical unit of work state is either prepared or last-agent pending.
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKCMTDFN JOB(*ALL) STATUS(*UNDECIDED)
|
|
</pre>
|
|
</p>
|
|
<p><b>Example 4: Limiting by Commitment Definitions That Are Associated With An X/Open Global Transaction</b>
|
|
</p>
|
|
<p>The following example will display a list of all the commitment definitions associated with an X/Open global transaction.
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKCMTDFN JOB(*ALL) STATUS(*XOPEN)
|
|
</pre>
|
|
</p>
|
|
<p><b>Example 5: Limiting by LUWID</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKCMTDFN JOB(*ALL) LUWID(APPN.RCHASL7E.X'11223344BDFF'.*)
|
|
</pre>
|
|
</p>
|
|
<p>This command will display a list of all the commitment definitions whose logical unit of work ID begins with the specified generic value. Of all those commitment definitions on the system, only those whose logical unit of work id's begin with the generic value will be listed.
|
|
</p>
|
|
<p><b>Example 6: Limiting by System ASP</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKCMTDFN JOB(*ALL) ASPGRP(*SYSBAS)
|
|
</pre>
|
|
</p>
|
|
<p>This command will display a list of all the commitment definitions that reside on the system auxiliary storage pool (ASP number 1).
|
|
</p>
|
|
<p><b>Example 7: Limiting by ASP Device Description Name</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
WRKCMTDFN JOB(*ALL) ASPGRP(IASP0035)
|
|
</pre>
|
|
</p>
|
|
<p>This command will display a list of all the commitment definitions that reside on the independent auxiliary storage pool (ASP) associated with ASP device description IASP0035.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKCMTDFN.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF0941</b></dt>
|
|
<dd>Job &3/&2/&1 no longer in system.
|
|
</dd>
|
|
<dt><b>CPF1069</b></dt>
|
|
<dd>End of duplicate names.
|
|
</dd>
|
|
<dt><b>CPF1070</b></dt>
|
|
<dd>Job &3/&2/&1 not found.
|
|
</dd>
|
|
<dt><b>CPF1071</b></dt>
|
|
<dd>No authority to job &3/&2/&1.
|
|
</dd>
|
|
<dt><b>CPF83E5</b></dt>
|
|
<dd>Not authorized to jobs.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9850</b></dt>
|
|
<dd>Override of printer file &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF9851</b></dt>
|
|
<dd>Overflow value for file &1 in &2 too small.
|
|
</dd>
|
|
<dt><b>CPF9871</b></dt>
|
|
<dd>Error occurred while processing.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKCMTDFN.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|