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

394 lines
16 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>Change Subsystem Description (CHGSBSD)</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="CHGSBSD.Top_Of_Page"></a>
<h2>Change Subsystem Description (CHGSBSD)</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="#CHGSBSD.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGSBSD.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGSBSD.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGSBSD"></a>
<p>The Change Subsystem Description (CHGSBSD) command changes the operational attributes of the specified subsystem description. You can change the subsystem description while the subsystem is active. However, you cannot specify the *RMV value on the <b>Storage pools (POOLS)</b> parameter while the subsystem is active, because a job may become suspended.
</p>
<p><b>Restrictions:</b>
</p>
<ol>
<li>To use this command, you must have:
<ul>
<li>object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing that subsystem description.
</li>
<li>all object (*ALLOBJ) and security administration (*SECADM) special authority to specify a system library list entry.
</li>
</ul>
</li>
<li>You cannot specify the *RMV value on the POOLS parameter while the subsystem is active, because a job may become suspended.
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGSBSD.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="#CHGSBSD.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>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top" rowspan="4"><a href="#CHGSBSD.POOLS"><b>POOLS</b></a></td>
<td valign="top">Storage pools</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 10 repetitions): <i>Element list</i></td>
<td valign="top" rowspan="4">Optional, 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, *RMV, *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="#CHGSBSD.MAXJOBS"><b>MAXJOBS</b></a></td>
<td valign="top">Maximum jobs</td>
<td valign="top">0-1000, <b><u>*SAME</u></b>, *NOMAX</td>
<td valign="top">Optional, Positional 3</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSBSD.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGSBSD.SGNDSPF"><b>SGNDSPF</b></a></td>
<td valign="top">Sign-on display file</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *QDSIGNON<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="#CHGSBSD.SYSLIBLE"><b>SYSLIBLE</b></a></td>
<td valign="top">Subsystem library</td>
<td valign="top"><i>Name</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGSBSD.SBSD"></a>
<h3>Subsystem description (SBSD)</h3>
<p>Specifies the name and library of the subsystem description being changed.
</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 changed.
</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 subsystem description is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSBSD.POOLS"></a>
<h3>Storage pools (POOLS)</h3>
<p>Specifies the identifiers of one or more storage pool definitions and the changes that are made to them.
</p>
<p>When an existing pool definition is removed, the subsystem must be inactive.
</p>
<p>The size and activity level of each existing pool definition that is not specified, does not change.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The storage pool definitions in the subsystem description do not change.
</dd>
</dl>
<p><b>Other values (up to 10 repetitions)</b>
</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 changed.
</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>*RMV</b></dt>
<dd>The specified pool definition is removed from the subsystem description.
</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.
<p>
<b>Note: </b>Changes to the size of a pool may require pages to be written to auxiliary storage. The time required for the system to complete a large change may be greater than your default wait time. If this occurs, message CPF1001 (Wait time expired for system response.) is issued, even though the change completes.
</p>
</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="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSBSD.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>*SAME</u></b></dt>
<dd>The maximum number of jobs allowed at the same time in the subsystem does not change.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>There is no maximum number of jobs allowed at the same time 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="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSBSD.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The text, if any, does not change.
</dd>
</dl>
<dl>
<dt><b>*BLANK</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="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSBSD.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>Use (*USE) is needed to complete format checks of the display file. This helps predict that the display will work correctly when the subsystem is started. If you are not authorized to the display file or its library, those format checks will not be performed.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The current sign-on display file value does not change.
</dd>
<dt><b>*QDSIGNON</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="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSBSD.SYSLIBLE"></a>
<h3>Subsystem library (SYSLIBLE)</h3>
<p>Specifies a library that is added ahead of other libraries in the system portion of the library list of jobs started in the subsystem. This parameter allows you to use a secondary language library.
</p>
<p><b>Restrictions: </b>
</p>
<ol>
<li>This parameter can be changed while the subsystem is active. Any changes you make take effect for new jobs that are started. The library list of active jobs within the subsystem is not changed.
</li>
<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>*SAME</u></b></dt>
<dd>The system library list is not changed.
</dd>
<dt><b>*NONE</b></dt>
<dd>The secondary language library is removed from the system library list.
</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="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSBSD.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Changing Storage Size and Activity Level</b>
</p>
<p>
<pre>
CHGSBSD SBSD(QGPL/PAYCTL) POOLS((2 1500 3))
SGNDSPF(QGPL/COMPANYA)
</pre>
</p>
<p>This command changes the definition of storage pool 2 that is used by subsystem PAYCTL to a storage size of 1500K and an activity level of 3. The sign-on display file is changed to display file COMPANYA and is located in the QGPL library. If the subsystem is active when this command is issued, COMPANYA is not used until the next time the subsystem is started.
</p>
<p><b>Example 2: Changing Multiple Attributes</b>
</p>
<p>
<pre>
CHGSBSD SBSD(LIB6/ORDER)
POOLS((1 *BASE)(2 750 4)(3 *RMV)(4 *NOSTG))
MAXJOBS(5)
</pre>
</p>
<p>This command changes the maximum number of jobs that subsystem ORDER can support to five. (The description of the subsystem is stored in library LIB6.) The definition of storage pool 1 is changed to the base shared system pool, the definition of pool 2 is changed to have a storage size of 750K and an activity level of 4, the definition of pool 3 is removed from the subsystem, and the definition of pool 4 is changed to have no storage and no activity level.
</p>
<p><b>Example 3: Changing the Language Library</b>
</p>
<p>
<pre>
CHGSBSD SBSD(QGPL/SPANISH) SGNDSPF(QSYS2931/QDSIGNON)
SYSLIBLE(QSYS2931)
</pre>
</p>
<p>This command changes subsystem description SPANISH to a Spanish secondary language.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSBSD.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1619</b></dt>
<dd>Subsystem description &amp;1 in library &amp;2 damaged.
</dd>
<dt><b>CPF1691</b></dt>
<dd>Active subsystem description may or may not have changed.
</dd>
<dt><b>CPF1697</b></dt>
<dd>Subsystem description &amp;1 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSBSD.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>