ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/setcstdta.htm

182 lines
6.4 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>Set Customization Data (SETCSTDTA)</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="SETCSTDTA.Top_Of_Page"></a>
<h2>Set Customization Data (SETCSTDTA)</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="#SETCSTDTA.PARAMETERS.TABLE">Parameters</a><br>
<a href="#SETCSTDTA.COMMAND.EXAMPLES">Examples</a><br>
<a href="#SETCSTDTA.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="SETCSTDTA"></a>
<p>The Set Customization Data (SETCSTDTA) command can be used to copy and delete information in order to customize data, such as work area content and mouse double-click action values, for Graphical Operations support.
</p>
<p>Using this command, administrators can set up users by getting information from a named user profile and copying it to other user profiles. Administrators can also remove the customized values for a named user, and choose to replace those customized values with data from a named user profile.
</p>
<p>
<b>Note: </b>Do not precede an entry with an asterisk unless that entry is a "special value" that is shown (on the display itself or in the help information) with an asterisk.
</p>
<h3>Error messages for SETCSTDTA</h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2204</b></dt>
<dd>User profile &amp;1 not found.
</dd>
<dt><b>CPF2217</b></dt>
<dd>Not authorized to user profile &amp;1.
</dd>
<dt><b>GUI0085</b></dt>
<dd>&amp;1 does not have customization data.
</dd>
<dt><b>GUI0087</b></dt>
<dd>Some user profiles did not have customization data copied successfully.
</dd>
<dt><b>GUI0091</b></dt>
<dd>Some user profiles did not have customization data deleted successfully.
</dd>
<dt><b>GUI0117</b></dt>
<dd>&amp;1 is not valid for subset key.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETCSTDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETCSTDTA.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"><a href="#SETCSTDTA.USRPRF"><b>USRPRF</b></a></td>
<td valign="top">User profile</td>
<td valign="top">Values (up to 300 repetitions): <i>Simple name</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#SETCSTDTA.VALUE"><b>VALUE</b></a></td>
<td valign="top">Customization data to use</td>
<td valign="top"><i>Simple name</i>, *NONE</td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#SETCSTDTA.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace customization data</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional, Positional 3</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#SETCSTDTA.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="SETCSTDTA.USRPRF"></a>
<h3>User profile (USRPRF)</h3>
<p>Specifies the names of the user profiles for which customized values are to be set or removed with the option to set them again. A maximum of 300 user profiles can be named.
</p>
<p>You can enter multiple values for this parameter. If you are on an entry display and you need additional entry fields to enter these multiple values, type a plus sign (+) in the entry field opposite the phrase "+ for more", and press the Enter key.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETCSTDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETCSTDTA.VALUE"></a>
<h3>Customization data to use (VALUE)</h3>
<p>Specifies the customization data value to which the user profile named on the <b>User profile</b> prompt (USRPRF parameter) is to be set.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b>*NONE</b></dt>
<dd>The customization data is to be removed from the user profile and no customization value is to be set.
</dd>
<dt><b><i>user-profile</i></b></dt>
<dd>Specify the name of the user profile from which the customization value data is to be copied and set.
</dd>
</dl>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETCSTDTA.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="SETCSTDTA.REPLACE"></a>
<h3>Replace customization data (REPLACE)</h3>
<p>Specifies whether to replace existing customization data if the user profile named on the <b>User profile</b> prompt (USRPRF parameter) has customization data.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The existing customization data is not replaced. An exception message is issued.
</dd>
<dt><b>*YES</b></dt>
<dd>The existing customization data is replaced with the customization data from the user profile specified on the <b>Customization data to use</b> prompt (VALUE parameter).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETCSTDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="SETCSTDTA.COMMAND.EXAMPLES">Examples</a></h3>None
</div>
<table width="100%">
<tr><td align="right"><a href="#SETCSTDTA.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="SETCSTDTA.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF2204</b></dt>
<dd>User profile &amp;1 not found.
</dd>
<dt><b>CPF2217</b></dt>
<dd>Not authorized to user profile &amp;1.
</dd>
<dt><b>GUI0085</b></dt>
<dd>&amp;1 does not have customization data.
</dd>
<dt><b>GUI0087</b></dt>
<dd>Some user profiles did not have customization data copied successfully.
</dd>
<dt><b>GUI0091</b></dt>
<dd>Some user profiles did not have customization data deleted successfully.
</dd>
<dt><b>GUI0117</b></dt>
<dd>&amp;1 is not valid for subset key.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#SETCSTDTA.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>