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

257 lines
9.2 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 WSCST (CRTWSCST)</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="CRTWSCST.Top_Of_Page"></a>
<h2>Create WSCST (CRTWSCST)</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="#CRTWSCST.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTWSCST.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTWSCST.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTWSCST"></a>
<p>The Create Work Station Customizing Object (CRTWSCST) command allows the user to create a work station customizing object in a library.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTWSCST.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="#CRTWSCST.WSCST"><b>WSCST</b></a></td>
<td valign="top">Workstation customizing object</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: Workstation customizing object</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="#CRTWSCST.SRCMBR"><b>SRCMBR</b></a></td>
<td valign="top">Source member</td>
<td valign="top"><i>Name</i>, <b><u>*WSCST</u></b></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CRTWSCST.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, *BLANK, <b><u>*SRCMBRTXT</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTWSCST.SRCFILE"><b>SRCFILE</b></a></td>
<td valign="top">Source file</td>
<td valign="top"><i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Source file</td>
<td valign="top"><i>Name</i>, <b><u>QTXTSRC</u></b></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="#CRTWSCST.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *CHANGE, *ALL, *USE, *EXCLUDE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTWSCST.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace object</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTWSCST.WSCST"></a>
<h3>Workstation customizing object (WSCST)</h3>
<p>Specifies the name of a work station customizing object to be created.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>The work station customizing object 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 work station customizing object is created.
</dd>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b><i>object-name</i></b></dt>
<dd>Specify the name of the object that is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTWSCST.SRCMBR"></a>
<h3>Source member (SRCMBR)</h3>
<p>Specifies the name of the source file member containing the table attributes.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*WSCST</u></b></dt>
<dd>Specifies that the work station customizing object name is used as the source member name.
</dd>
<dt><b><i>source-file-member-name</i></b></dt>
<dd>Specify the name of the member in the source file specified on the SRCFILE parameter that is used to create the work station customizing object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTWSCST.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the object. More information on this parameter is in "Appendix A, Expanded Parameter Descriptions" in the CL Reference.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*SRCMBRTXT</u></b></dt>
<dd>The text is taken from the source file member used to create the work station customizing object.
</dd>
<dt><b>*BLANK</b></dt>
<dd>Text is not specified.
</dd>
<dt><b><i>'description'</i></b></dt>
<dd>Specify a description of the object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTWSCST.SRCFILE"></a>
<h3>Source file (SRCFILE)</h3>
<p>Specifies the name of the source file in which a source file member containing the customizing table attributes resides. If the source file does not exist, an error message is displayed. The coded character set identifier for the source file should be *HEX.
</p>
<p>The possible library values are:
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>The current library for the job is used to locate the source file. 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 source file is located.
</dd>
</dl>
<p>The possible values are:
</p>
<dl>
<dt><b><u>QTXTSRC</u></b></dt>
<dd>The IBM-supplied source file QTXTSRC is used.
</dd>
<dt><b><i>source-file-name</i></b></dt>
<dd>Specify the name of the source file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTWSCST.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 the authorization list, and whose user group has no specific authority to the object.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*LIBCRTAUT</u></b></dt>
<dd>The public authority for the object is taken from the CRTAUT value of the target library (the library that is to contain the object). This value 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.
</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 file's existence, specify the security for the file, change the file, and perform basic functions on the file. The user can transfer ownership of the file.
</dd>
<dt><b>*USE</b></dt>
<dd>The user can perform basic operations, such as run a program or read a file. The user is prevented from changing the object. *USE authority provides object operational authority, read authority and execute authority.
</dd>
<dt><b>*EXCLUDE</b></dt>
<dd>The user is prevented from accessing the object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTWSCST.REPLACE"></a>
<h3>Replace object (REPLACE)</h3>
<p>Indicates whether an existing object is replaced.
</p>
<p>The possible values are:
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Replace the existing work station customizing object.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not replace the existing work station customizing object.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTWSCST.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CRTWSCST WSCST(MYLIB/MYWSCOBJ)
</pre>
</p>
<p>This command creates a work station customizing object named MYWSCOBJ in library MYLIB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTWSCST.ERROR.MESSAGES">Error messages</a> </h3>
<p>None
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTWSCST.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>