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:

1. To use this command, you must have:
   • 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.
   • all object (*ALLOBJ) and security administration (*SECADM) special authority to specify a system library list entry.
2. You cannot specify the *RMV value on the POOLS parameter while the subsystem is active, because a job may become suspended.

Parameters

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-1000, *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

Top

Subsystem description (SBSD)

Specifies the name and library of the subsystem description being changed.

This is a required parameter.

Qualifier 1: Subsystem description

name

Specify the name of the subsystem description being changed.

Qualifier 2: Library

*LIBL

All libraries in the thread's library list are searched until a match is found.

*CURLIB

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.

name

Specify the library where the subsystem description is located.

Storage pools (POOLS)

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

*SAME

The storage pool definitions in the subsystem description do not change.

Other values (up to 10 repetitions)

Element 1: Pool identifier

1-10

Specify the pool identifier of the storage pool definition to be changed.

Element 2: Storage size

*BASE

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.

*NOSTG

No storage and no activity level are assigned to the pool at first. (It is inactive.)

*RMV

The specified pool definition is removed from the subsystem description.

*INTERACT

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.

*SPOOL

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.

*SHRPOOLnn

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.

integer-number

Specify the storage size (in kilobytes) of the specified storage pool. A value of at least 256 (meaning 256k) must be specified.

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

integer-number

Specify the maximum number of threads that can run at the same time in the pool.

Maximum jobs (MAXJOBS)

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.

*SAME

The maximum number of jobs allowed at the same time in the subsystem does not change.

*NOMAX

There is no maximum number of jobs allowed at the same time in this subsystem.

0-1000

Specify the maximum number of jobs allowed in this subsystem.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME

The text, if any, does not change.

*BLANK

No text is specified.

character-value

Specify no more than 50 characters of text, enclosed in apostrophes.

Sign-on display file (SGNDSPF)

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

*SAME

The current sign-on display file value does not change.

*QDSIGNON

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.

Qualifier 1: Sign-on display file

name

Specify the name of the sign-on display file that is used.

Qualifier 2: Library

*LIBL

All libraries in the thread's library list are searched until a match is found.

*CURLIB

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.

name

Specify the library where the sign-on display file is located.

Subsystem library (SYSLIBLE)

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:

1. 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.
2. 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.
3. You must have *ALLOBJ and *SECADM special authority to specify a a value other than *NONE for a system library list entry.

*SAME

The system library list is not changed.

*NONE

The secondary language library is removed from the system library list.

name

Specify the name of the library being added to the system library list.

Examples

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.

Error messages

*ESCAPE Messages

CPF1619

Subsystem description &1 in library &2 damaged.

CPF1691

Active subsystem description may or may not have changed.

CPF1697

Subsystem description &1 not changed.