250 lines
9.7 KiB
HTML
250 lines
9.7 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 Graphics Symbol Set (CRTGSS)</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="CRTGSS.Top_Of_Page"></a>
|
|
<h2>Create Graphics Symbol Set (CRTGSS)</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="#CRTGSS.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTGSS.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTGSS.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTGSS"></a>
|
|
<p>The Create Graphics Symbol Set (CRTGSS) command creates a graphics symbol set object from a physical file that contains symbol set data. Depending upon the contents of the file, the CRTGSS command creates either a vector symbol set (mode 3 graphics characters) or an image symbol set (mode 2 graphics characters).
|
|
</p>
|
|
<p>The symbol set object can be used in a graphical data display manager (GDDM*) or presentation graphics routines (PGR) graphics application program or in a Business Graphics Utility chart as an alternative to an IBM-supplied graphics symbol set. More information on the Business Graphics Utility is in the BGU User's Guide and Reference, SC09-1408 book.
|
|
</p>
|
|
<p><b>Restriction:</b> A physical file used with this command must contain records with no less than 80 bytes and no more than 400 bytes, and a source file must contain no less than 92 bytes and no more than 412 bytes. The contents of the file must be in symbol set format.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTGSS.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="#CRTGSS.GSS"><b>GSS</b></a></td>
|
|
<td valign="top">Graphics symbol set</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: Graphics symbol set</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" rowspan="3"><a href="#CRTGSS.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 2</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="#CRTGSS.MBR"><b>MBR</b></a></td>
|
|
<td valign="top">Member</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*GSS</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTGSS.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*MBRTXT</u></b>, *BLANK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTGSS.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>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTGSS.GSS"></a>
|
|
<h3>Graphics symbol set (GSS)</h3>
|
|
<p>Specifies the name and library of the graphics symbol set being created. If no library name is given, the symbol set is stored in library *CURLIB. Graphics symbol set names can be up to 8 characters in length.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTGSS.FILE"></a>
|
|
<h3>File (FILE)</h3>
|
|
<p>Specifies the name and library of the source data file being used to create the symbol set.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</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 store the graphics symbol set. If no library specified as the current library for the job, QGPL is used.
|
|
</dd>
|
|
<dt><b><i>library-name</i></b></dt>
|
|
<dd>Specify the library where the graphics symbol set is to be stored.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTGSS.MBR"></a>
|
|
<h3>Member (MBR)</h3>
|
|
<p>Specifies the name of the file member being used to create the symbol set.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*GSS</u></b></dt>
|
|
<dd>The name of the file member that contains the input data is the same as the symbol set being created.
|
|
</dd>
|
|
<dt><b><i>member-name</i></b></dt>
|
|
<dd>Specify the file member that contains the symbol set input data.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTGSS.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies the text that briefly describes the object.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*MBRTXT</u></b></dt>
|
|
<dd>The text is taken from the file member being used to create the symbol set.
|
|
</dd>
|
|
<dt><b>*BLANK</b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>'description'</i></b></dt>
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTGSS.AUT"></a>
|
|
<h3>Authority (AUT)</h3>
|
|
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
|
|
</p>
|
|
<p>The possible values are:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBCRTAUT</u></b></dt>
|
|
<dd>The system determines the authority for the object by using the value specified on the <b>Create authority</b> prompt (CRTAUT parameter) on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified on the <b>Create authority</b> prompt (CRTAUT parameter) is changed, the new value will not affect any existing objects.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<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 (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) 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 also can change ownership of the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
</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>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*EXCLUDE</b></dt>
|
|
<dd>The user cannot access the object.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b><i>authorization-list-name</i></b></dt>
|
|
<dd>Specify the name of an authorization list. Users included on the authorization list are granted authority to the object as specified by the list. The authorization list must exist when the object is created.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTGSS.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Creating Set With Same Name as Source File</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTGSS GSS(GSSLIB/ADMVARP) FILE(GSSLIB/ADMVARP)
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a symbol set of the same name and in the same library as the source file.
|
|
</p>
|
|
<p><b>Example 2: Creating Set From Different Library</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CRTGSS GSS(*CURLIB/VECTOR1) FILE(GSSLIB/QDATASRC)
|
|
MBR(SCHEM) AUT(*ALL) TEXT('Schematic vector symbols')
|
|
</pre>
|
|
</p>
|
|
<p>This command creates a symbol set named VECTOR1 in the QGPL library from member SCHEM in file QDATASRC in library GSSLIB. The public has complete authority over the symbol set. Despite the fact that the symbol set data is stored in source physical file QDATASRC, it cannot be edited or shown by the source entry utility (SEU) because some of the contents of the symbol set data cannot be shown.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTGSS.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF8660</b></dt>
|
|
<dd>Symbol set &1 not created in library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTGSS.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|