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

405 lines
18 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!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 Subsystem Description (CRTSBSD)</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="CRTSBSD.Top_Of_Page"></a>
<h2>Create Subsystem Description (CRTSBSD)</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="#CRTSBSD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTSBSD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTSBSD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTSBSD"></a>
<p>The Create Subsystem Description (CRTSBSD) command creates a subsystem description that defines the operational attributes of a subsystem. After the subsystem description is created, it can be specialized by commands that add, change, and remove work entries and routing entries in the subsystem description.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>To use this command, you must have:
<ul>
<li>read (*READ) and add (*ADD) authority to the library where the subsystem description is to be created.
</li>
<li>all object (*ALLOBJ) and security administration (*SECADM) special authority to specify a value other than *NONE for a system library list entry.
</li>
</ul>
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTSBSD.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="#CRTSBSD.SBSD"><b>SBSD</b></a></td>
<td valign="top">Subsystem 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: Subsystem 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" rowspan="4"><a href="#CRTSBSD.POOLS"><b>POOLS</b></a></td>
<td valign="top">Storage pools</td>
<td valign="top">Values (up to 10 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Required, Positional 2</td>
</tr>
<tr>
<td valign="top">Element 1: Pool identifier</td>
<td valign="top">
1-10</td>
</tr>
<tr>
<td valign="top">Element 2: Storage size</td>
<td valign="top">
<i>Integer</i>, *BASE, *NOSTG, *INTERACT, *SPOOL, *SHRPOOL1, *SHRPOOL2, *SHRPOOL3, *SHRPOOL4, *SHRPOOL5, *SHRPOOL6, *SHRPOOL7, *SHRPOOL8, *SHRPOOL9, *SHRPOOL10, *SHRPOOL11, *SHRPOOL12, *SHRPOOL13, *SHRPOOL14, *SHRPOOL15, *SHRPOOL16, *SHRPOOL17, *SHRPOOL18, *SHRPOOL19, *SHRPOOL20, *SHRPOOL21, *SHRPOOL22, *SHRPOOL23, *SHRPOOL24, *SHRPOOL25, *SHRPOOL26, *SHRPOOL27, *SHRPOOL28, *SHRPOOL29, *SHRPOOL30, *SHRPOOL31, *SHRPOOL32, *SHRPOOL33, *SHRPOOL34, *SHRPOOL35, *SHRPOOL36, *SHRPOOL37, *SHRPOOL38, *SHRPOOL39, *SHRPOOL40, *SHRPOOL41, *SHRPOOL42, *SHRPOOL43, *SHRPOOL44, *SHRPOOL45, *SHRPOOL46, *SHRPOOL47, *SHRPOOL48, *SHRPOOL49, *SHRPOOL50, *SHRPOOL51, *SHRPOOL52, *SHRPOOL53, *SHRPOOL54, *SHRPOOL55, *SHRPOOL56, *SHRPOOL57, *SHRPOOL58, *SHRPOOL59, *SHRPOOL60</td>
</tr>
<tr>
<td valign="top">Element 3: Activity level</td>
<td valign="top">
<i>Integer</i></td>
</tr>
<tr>
<td valign="top"><a href="#CRTSBSD.MAXJOBS"><b>MAXJOBS</b></a></td>
<td valign="top">Maximum jobs</td>
<td valign="top">0-1000, <b><u>*NOMAX</u></b></td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSBSD.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" rowspan="3"><a href="#CRTSBSD.SGNDSPF"><b>SGNDSPF</b></a></td>
<td valign="top">Sign-on display file</td>
<td valign="top">Single values: <b><u>*QDSIGNON</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Sign-on display 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="#CRTSBSD.SYSLIBLE"><b>SYSLIBLE</b></a></td>
<td valign="top">Subsystem library</td>
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTSBSD.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="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTSBSD.SBSD"></a>
<h3>Subsystem description (SBSD)</h3>
<p>Specifies the name and library of the subsystem description being created. The subsystem description is stored in the specified library.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: Subsystem description</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the subsystem description being created.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*CURLIB</u></b></dt>
<dd>The current library of the thread is used. If no current library exists for the thread, library QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the subsystem description will be created.
</dd>
</dl>
<p>For more information on subsystem descriptions, see the Work Management Guide.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSBSD.POOLS"></a>
<h3>Storage pools (POOLS)</h3>
<p>Specifies one or more storage pool definitions that are in this subsystem description. Each definition specifies for one storage pool:
</p>
<ul>
<li>Pool definition identifier: The identifier <b>inside</b> the subsystem description, of the storage pool definition. The same identifiers (1 through 10) can be used for pool definitions in different subsystem descriptions.
</li>
<li>Size: The size of the storage pool, expressed in kilobyte (1K = 1024 bytes) multiples. This is the amount of main storage that can be used by the pool.
</li>
<li>Activity level: The maximum number of threads that can run at the same time in the pool.
</li>
</ul>
<p>A maximum of 10 storage pool definitions can be specified for the subsystem description being created. Although each subsystem description can have as many as 10, there is an operational limitation on how many active storage pools can be in the <b>system</b>. In the system, no more than 64 storage pools can be active at any time, including the base storage pool and the machine storage pool. (A storage pool for which *NOSTG has been specified is not considered active, and it is not allocated to any subsystem.)
</p>
<p>If a subsystem is started for which all of its storage pools cannot be allocated without exceeding the 64-pool system maximum, the pools that can be allocated (up to the limit) are allocated and the remainder are not. Then, for each routing step started by that subsystem that normally is routed into one of the pools that was not allocated, the base pool is used instead.
</p>
<p>This is a required parameter.
</p>
<p>You can specify 10 values for this parameter.
</p>
<p><b>Element 1: Pool identifier</b>
</p>
<dl>
<dt><b><i>1-10</i></b></dt>
<dd>Specify the pool identifier of the storage pool definition to be in this subsystem. The attributes of the pool also must be specified by one of the following values. As many as 10 sets of values can be specified here to define as many as 10 storage pools in the subsystem.
</dd>
</dl>
<p><b>Element 2: Storage size</b>
</p>
<dl>
<dt><b>*BASE</b></dt>
<dd>The specified pool definition is defined to be the base system pool, which can be shared with other subsystems. The minimum size and activity level of the base pool are specified in the system values QBASPOOL and QBASACTLVL.
</dd>
<dt><b>*NOSTG</b></dt>
<dd>No storage and no activity level are assigned to the pool at first. (It is inactive.)
</dd>
<dt><b>*INTERACT</b></dt>
<dd>The specified pool definition is defined to be the shared pool used for interactive work. The size and activity level of the shared pool are specified using the Change Shared Storage Pool (CHGSHRPOOL) command.
</dd>
<dt><b>*SPOOL</b></dt>
<dd>The specified pool definition is defined to be the shared pool used for spooled writers. The size and activity level of the shared pool are specified using the CHGSHRPOOL command.
</dd>
<dt><b>*SHRPOOLnn</b></dt>
<dd>The specified pool definition is defined to be a general-purpose shared pool. There are sixty general-purpose shared pools, identified by special values *SHRPOOL1 to *SHRPOOL60. The size and activity level of a shared pool are specified using the CHGSHRPOOL command.
</dd>
<dt><b><i>integer-number</i></b></dt>
<dd>Specify the storage size (in kilobytes) of the specified storage pool. A value of at least 256 (meaning 256k) must be specified.
</dd>
</dl>
<p><b>Element 3: Activity level</b>
</p>
<dl>
<dt><b><i>integer-number</i></b></dt>
<dd>Specify the maximum number of threads that can run at the same time in the pool.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSBSD.MAXJOBS"></a>
<h3>Maximum jobs (MAXJOBS)</h3>
<p>Specifies the maximum number of jobs that can be active at the same time in the subsystem controlled by this subsystem description. The maximum applies to all jobs that are started and are waiting or running, except for jobs on the job queue or jobs that have finished running.
</p>
<dl>
<dt><b><u>*NOMAX</u></b></dt>
<dd>There is no maximum number of jobs in this subsystem.
</dd>
<dt><b><i>0-1000</i></b></dt>
<dd>Specify the maximum number of jobs allowed in this subsystem.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSBSD.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>character-value</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="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSBSD.SGNDSPF"></a>
<h3>Sign-on display file (SGNDSPF)</h3>
<p>Specifies the name and library of the sign-on display file that is used when showing sign-on displays at work stations allocated to the subsystem. If the specified sign-on display file does not exist when the subsystem description is created or changed, you must specify a library qualifier because the qualified sign-on display file name is kept by the system. The sign-on display file must contain a record format named SIGNON.
</p>
<p>
<b>Note: </b>The sign-on display file can be changed when the subsystem is active. However, the new sign-on display file is not used until the next time the subsystem is started.
</p>
<p>
<b>Note: </b>If the user invoking this command has use (*USE) authority to the display file and execute (*EXECUTE) authority to its library, format checks of the display file can be made. This helps predict that the display will work correctly when the subsystem is started. Otherwise, those format checks will not be performed.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*QDSIGNON</u></b></dt>
<dd>The sign-on display file value QDSIGNON in QSYS is used when showing sign-on displays at work stations that are allocated to the subsystem.
</dd>
</dl>
<p><b>Qualifier 1: Sign-on display file</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the sign-on display file that is used.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the thread's library list are searched until a match is found.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the library where the sign-on display file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSBSD.SYSLIBLE"></a>
<h3>Subsystem library (SYSLIBLE)</h3>
<p>Specifies a library that is entered ahead of other libraries in the system portion of the library list. This parameter allows you to use a secondary language library.
</p>
<p><b>Restrictions: </b>
</p>
<ol>
<li>The secondary language library should not be specified in the QSYSLIBL or QUSRLIBL system values. QSYSLIBL must contain fewer than 15 libraries to allow the secondary language library to be added to the system portion of the library list.
</li>
<li>You must have *ALLOBJ and *SECADM special authority to specify a a value other than *NONE for a system library list entry.
</li>
</ol>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The system library list is not changed.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library being added to the system library list.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTSBSD.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>
<dl>
<dt><b><u>*LIBCRTAUT</u></b></dt>
<dd>The authority to the object is the same as the value specified on the <b>Create authority (CRTAUT)</b> parameter of the library in which the object is being created. If the value specified on the 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 displaying its contents. The user cannot change the object. *USE authority provides object operational authority, read authority, and execute authority.
</dd>
</dl>
<dl>
</dl>
<dl>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTSBSD.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Creating a Description With a Signon Display File</b>
</p>
<p>
<pre>
CRTSBSD SBSD(BAKER) POOLS((1 *BASE)(2 2000 4))
SGNDSPF(*LIBL/NEWSGNON)
TEXT ('Subsystem for running Baker Department jobs')
</pre>
</p>
<p>This command creates a subsystem description named BAKER and stores it in the current library. If there is no current library, then it is stored in the general purpose library (QGPL). Storage pool definition 1 specifies that pool 1 is to share the base system pool; the definition of storage pool 2 is to have 2000K of storage and an activity level of 4. There is no limit in this subsystem description on the number of jobs that can be active at the same time. The activity levels in the subsystem may, however, be controlled by MAXACT parameters specified in work station entries, job queue entries, and routing entries that are in the subsystem. The sign-on display file is NEWSGNON and is used when showing sign-on displays at work stations allocated to the BAKER subsystem. The user's library list is searched for the NEWSGNON display file.
</p>
<p><b>Example 2: Creating a Description that Contains Three Storage Pool Definitions</b>
</p>
<p>
<pre>
CRTSBSD SBSD(MEDLIB/MEDICAL)
POOLS((1 1500 2) (2 *BASE) (3 *NOSTG))
MAXJOBS(5) TEXT('Medical files inquiry and update')
</pre>
</p>
<p>This command creates a subsystem description named MEDICAL and stores it in the MEDLIB library. The subsystem description contains three storage pool definitions: storage pool 1 is defined to have 1500K of storage and an activity level of 2, pool 2 is to share the base system pool, and pool 3 is defined first to be inactive when the other pools are active--it has no storage and no activity level. Up to five jobs can be active at the same time in this subsystem. A text description briefly describes the subsystem.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTSBSD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1696</b></dt>
<dd>Subsystem description &amp;1 not created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTSBSD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>