CHGSBSD (Change Subsystem Description)

CHGSBSD Command syntax diagram

 

Purpose

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 POOLS parameter while the subsystem is active, because the job may become suspended.

 

Restrictions

  1. The user of this command must have object operational authority and object management authority for the subsystem description before it can be changed. The user must also have object operational authority for the library containing the subsystem description.

  2. You cannot specify the *RMV value on the POOLS parameter while the subsystem is active, because the job may become suspended.

 

Required Parameters

SBSD
Specifies the qualified name of the subsystem description to which changes are made.

The name of the subsystem description can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

subsystem-description-name: Specify the name of the subsystem description being changed.

The name of the IBM-supplied controlling subsystem, QCTL, must not be specified for this parameter. The CRTSBSD command, however, can be used to create a similar subsystem description, and the user can specify it as the controlling subsystem by specifying its name in the QCTLSBSD system value instead of the QCTL library.

 

Optional Parameters

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. More information about storage pools is in the Backup and recovery topic in the Information Center and the Work Management book.

*SAME: The value does not change.

Element 1: Pool Identifier

pool-identifier: Specify the pool identifier, ranging from 1 through 10, of the storage pool definition added or deleted, or whose attributes are changed. If more than one pool definition is specified, the attributes of each definition must follow its identifier.

Element 2: Pool Definition Options

*BASE: The specified pool definition is the system base 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 the present time.

*INTERACT: The shared pool used for interactive work.

*SPOOL: The shared pool used for spooled writers.

*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 Change Shared Storage Pool (CHGSHRPOOL) command.

*RMV: The specified pool definition is removed from the subsystem description.

storage-size activity-level: Specify the storage size (in kilobytes) of the specified storage pool. The storage pool identifier and size must be specified. A value of at least 256 kilobytes must be specified for the storage size. For activity level, specify the maximum number of jobs that can run in the pool at the same time. Active jobs running in a pool must finish before the pool can be deallocated by the system. When this command is used to change a pool size allocation, the existing jobs in the pool continue to process until they have finished.

If the subsystem is active, and if a save and/or restore operation is using some of the storage allocated to the specified pool, a request to reduce a pool allocation may not take effect immediately. In that case, the pool size allocation is changed when the machine cancels the storage being used. Use the Display System Status (DSPSYSSTS) command to determine the amount of storage reserved for save/restore operations.

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, but not to jobs on the job queue or jobs that have finished running.

*SAME: The value does not change.

*NOMAX: There is no maximum number of jobs that can be active at the same time.

maximum-subsystem-jobs: Specify the maximum number of active jobs allowed in this subsystem.

SGNDSPF
Specifies the qualified name 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 changed, the user must specify a library qualifier because the sign-on display file name is kept by the system. The sign-on display file must contain a record format named SIGNON. More information on display files is in the Application Display Programming

book.

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.

*SAME: The value does not change.

*QDSIGNON: The sign-on display file QDSIGNON in QSYS is used when showing sign-on displays at work stations that are allocated to the subsystem.

The name of the sign-on display file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

If the file is found, its library name is placed in the subsystem description.

display-file-name: Specify the name of the sign-on display file used.

SYSLIBLE
Specifies a library that is specified ahead of other libraries on the system library list. This parameter allows the user to change a secondary language library, causing messages and displays to appear in the user's spoken language.

Note: This parameter can be used while the subsystem is active. Any changes the user makes to this parameter take effect for new jobs that are started. The library list of active jobs within the subsystem is not changed.

*SAME: The value does not change.

*NONE: The secondary language library is removed from the system library list.

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

TEXT
Specifies the text that briefly describes the subsystem description. More information on this parameter is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

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

Examples for CHGSBSD

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 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 for CHGSBSD

*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.