298 lines
11 KiB
HTML
298 lines
11 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>Create CRQ Description (CRTCRQD)</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="CRTCRQD.Top_Of_Page"></a>
|
||
|
|
<h2>Create CRQ Description (CRTCRQD)</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="#CRTCRQD.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CRTCRQD.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CRTCRQD.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CRTCRQD"></a>
|
||
|
|
<p>The Create Change Request Description (CRTCRQD) command can be used to create a change request description. A change request description contains a list of activities that are performed to complete the specified change.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CRTCRQD.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="#CRTCRQD.CRQD"><b>CRQD</b></a></td>
|
||
|
|
<td valign="top">Change request description</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: Change request description</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>*CURLIB</u></b></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CRTCRQD.USRPRF"><b>USRPRF</b></a></td>
|
||
|
|
<td valign="top">User profile</td>
|
||
|
|
<td valign="top"><b><u>*SBM</u></b>, *OWNER</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTCRQD.PRBID"><b>PRBID</b></a></td>
|
||
|
|
<td valign="top">Problem identifier</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CRTCRQD.PRBORG"><b>PRBORG</b></a></td>
|
||
|
|
<td valign="top">Problem origin</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Network identifier</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, <b><u>*NETATR</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Control point name</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Communications name</i>, <b><u>*NETATR</u></b></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTCRQD.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CRTCRQD.AUT"><b>AUT</b></a></td>
|
||
|
|
<td valign="top">Authority</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*EXCLUDE</u></b>, *LIBCRTAUT, *CHANGE, *ALL, *USE</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CRTCRQD.CRQD"></a>
|
||
|
|
<h3>Change request description (CRQD)</h3>
|
||
|
|
<p>Specifies the name and the library of the change request description being created.
|
||
|
|
</p>
|
||
|
|
<p>The name of the change request description can be qualified by one of the following library values:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
||
|
|
<dd>The change request description is created in the current library for the job. If no library is specified as the current library for the job, the QGPL library is used.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>library-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the library where the change request description is created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>change-request-description-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the change request description being created.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCRQD.USRPRF"></a>
|
||
|
|
<h3>User profile (USRPRF)</h3>
|
||
|
|
<p>Specifies whether the authority checking (done while this change request is running) is based on the user who submitted the change request description or on the owner of the change request description. The user profile is used to run the change request and control which objects can be used by the change request.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SBM</u></b></dt>
|
||
|
|
<dd>The user profile of the submitter is used when the change request is run.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*OWNER</b></dt>
|
||
|
|
<dd>The user profile of the change request description owner is used when the change request is run.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>This is not like a program that runs under its owner's profile, for which both the program owner and the program user profiles are used. Only the owner's profile is used if this value is specified.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCRQD.PRBID"></a>
|
||
|
|
<h3>Problem identifier (PRBID)</h3>
|
||
|
|
<p>Specifies the ID of the problem to be associated with this change request description. Problems with different origin systems might have the same identifier.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NONE</u></b></dt>
|
||
|
|
<dd>A problem ID is not specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>problem-identifier</i></b></dt>
|
||
|
|
<dd>Specify the ID of the problem to be associated with the change request description. If a problem ID is not found, a diagnostic message is issued.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCRQD.PRBORG"></a>
|
||
|
|
<h3>Problem Origin (PRBORG)</h3>
|
||
|
|
<p>Specifies the origin system of the problem ID.
|
||
|
|
</p>
|
||
|
|
<p>The possible network identifier values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NETATR</u></b></dt>
|
||
|
|
<dd>The network ID is the same as the one defined in the network attributes for this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>network-identifier</i></b></dt>
|
||
|
|
<dd>Specify a network ID.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p>The possible control point name values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NETATR</u></b></dt>
|
||
|
|
<dd>The control point name is the same as the local control point name defined in the network attributes for this system.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>control-point-name</i></b></dt>
|
||
|
|
<dd>Specify a control point name.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCRQD.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies text that briefly describes the object. More information on this parameter is in the CL Reference book, Appendix A.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*BLANK</u></b></dt>
|
||
|
|
<dd>Text is not specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'description'</i></b></dt>
|
||
|
|
<dd>Specify a maximum of 50 characters, enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CRTCRQD.AUT"></a>
|
||
|
|
<h3>Authority (AUT)</h3>
|
||
|
|
<p>Specifies the authority given to users who do not have specific authority to the object, who are not on an authorization list, and whose user group has no specific authority to the object.
|
||
|
|
</p>
|
||
|
|
<p>The possible values are:
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*EXCLUDE</u></b></dt>
|
||
|
|
<dd>The user cannot access the object.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*LIBCRTAUT</b></dt>
|
||
|
|
<dd>The public authority for the object is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the object). The public authority is determined when the object is created. If the CRTAUT value for the library changes after the object is created, the new value does not affect any existing objects.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*CHANGE</b></dt>
|
||
|
|
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>The user with *CHANGE authority cannot change the user profile value (USRPRF). To change the user profile value, the user must be the owner or must have *ALLOBJ and *SECADM authority.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user can also change ownership of the object.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*USE</b></dt>
|
||
|
|
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>authorization-list-name</i></b></dt>
|
||
|
|
<dd>Specify the name of the authorization list whose authority is used.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTCRQD.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Creating a Change Request Description in Your Own Library</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTCRQD CRQD(MYLIB/CHG001)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a change request description in MYLIB with the name CHG001 and a text description.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Creating a Change Request Description That Runs Under Another Person's Profile</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTCRQD CRQD(CHG222) USRPRF(*SBM)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a change request description called CHG222 that runs under the user profile that submits it.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Creating a Change Request Description and Associating a Problem With It</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CRTCRQD CRQD(CHG999) PRBID(1234567890) PRBORG(*NETATR STORE101)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command creates a change request description in *CURLIB called CHG999 that is associated with problem ID 1234567890. The problem origin network ID is the same as the local system. The control point name is STORE101.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CRTCRQD.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF969A</b></dt>
|
||
|
|
<dd>Change request description created, but warnings exist.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CRTCRQD.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|