| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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 Storage pools (POOLS) parameter while the subsystem is active, because a job may become suspended.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SBSD | Subsystem description | Qualified object name | Required, Positional 1 |
| Qualifier 1: Subsystem description | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| POOLS | Storage pools | Single values: *SAME Other values (up to 10 repetitions): Element list |
Optional, Positional 2 |
| Element 1: Pool identifier | 1-10 | ||
| Element 2: Storage size | Integer, *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 | ||
| Element 3: Activity level | Integer | ||
| MAXJOBS | Maximum jobs | 0-32000, *SAME, *NOMAX | Optional, Positional 3 |
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| SGNDSPF | Sign-on display file | Single values: *SAME, *QDSIGNON Other values: Qualified object name |
Optional |
| Qualifier 1: Sign-on display file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| SYSLIBLE | Subsystem library | Name, *SAME, *NONE | Optional |
| ASPGRP | ASP group | Name, *SAME, *NONE | Optional |
| Top |
Specifies the name and library of the subsystem description being changed.
This is a required parameter.
Qualifier 1: Subsystem description
Qualifier 2: Library
| Top |
Specifies the identifiers of one or more storage pool definitions and the changes that are made to them.
When an existing pool definition is removed, the subsystem must be inactive.
The size and activity level of each existing pool definition that is not specified, does not change.
Single values
Other values (up to 10 repetitions)
Element 1: Pool identifier
Element 2: Storage size
Note: 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.
Element 3: Activity level
| Top |
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.
| Top |
Specifies the text that briefly describes the object.
| Top |
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.
Note: 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.
Note: 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.
Single values
Qualifier 1: Sign-on display file
Qualifier 2: Library
| Top |
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.
Restrictions:
| Top |
Specifies the name of an auxiliary storage pool (ASP) group to be included in the library name space of the subsystem monitor job. The ASP group name is the name of the primary ASP device within the ASP group.
When the subsystem monitor job creates a user job, the job description is found using the library name space of the subsystem monitor job. Job queues, the sign-on display file, and the subsystem library are found in the library name space of the subsystem monitor job.
When the subsystem monitor job is doing work on behalf of a user job, the subsystem uses the library name space of the user job. The program and class are found in the library name space of the user job. For these objects, the ASPGRP parameter in the subsystem description has no effect.
When a subsystem monitor job uses an ASP group, the jobs in that subsystem should use the same ASP group. Use the Initial ASP group (INLASPGRP) parameter for the job description so that the ASP group is set during job creation and can be used to find other objects during job creation. Consistency between the subsystem monitor job and the user job is particularly important for prestart job entries because there are times the subsystem must find the program in order to determine which job description to use.
Restrictions:
| Top |
Example 1: Changing Storage Size and Activity Level
CHGSBSD SBSD(QGPL/PAYCTL) POOLS((2 1500 3))
SGNDSPF(QGPL/COMPANYA)
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.
Example 2: Changing Multiple Attributes
CHGSBSD SBSD(LIB6/ORDER)
POOLS((1 *BASE)(2 750 4)(3 *RMV)(4 *NOSTG))
MAXJOBS(5)
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.
Example 3: Changing the Language Library
CHGSBSD SBSD(QGPL/SPANISH) SGNDSPF(QSYS2931/QDSIGNON)
SYSLIBLE(QSYS2931)
This command changes subsystem description SPANISH to a Spanish secondary language.
| Top |
*ESCAPE Messages
| Top |