CL Command Reference - CHGSYSVAL

CL Command List > CHGSYSVAL Reference

Description:

The Change System Value (CHGSYSVAL) command changes the current value of the specified system value. Changes to some system values take effect immediately, some changes do not take effect until new jobs are started, and others do not take effect until the next initial program load (IPL).

System values must be enclosed in apostrophes under three conditions:
. If the system value specified is a character string with embedded blanks
. If numeric values or special characters are specified for character type system values
. If the system value is a date or time value

Some system values, such as QACGLVL, QCHRID, QCMNRCYLMT, etc., may be lists. To separate items in the list, use blanks and enclose the entire list in apostrophes. If there is only one item in the list, you do not need apostrophes.

Some system values, such as QCTLSBSD, QSTRUPPGM, QUPSMSGQ, and QPWDVLDPGM, accept object names and library names. If the system values are qualified, use blanks to separate the object and library names, and enclose the value in apostrophes. Apostrophes are necessary only when the library name or *LIBL is specified with the object name.

Notes:

. If a change is made to a date or time system value during any operation that measures the length of time, a negative value may be set if the end time is less than the start time.

. When object names are specified for system values, the lowercase letters in the names are always changed to uppercase even when they are in apostrophes. This means you should not use lowercase letters in the names of objects or libraries that you want to specify on any of the system values.



Examples:

Example 1: Changing a System Value Which Contains a String

CHGSYSVAL SYSVAL(QLANGID) VALUE(¡¯ENP¡¯)

This command changes the value of the system value QLANGID to ENP (ENP represents a valid language identifier).



Example 2: Changing a System Value Which Contains a List

CHGSYSVAL SYSVAL(QUSRLIBL) VALUE(¡¯INVLIB STOCKLIB MYLIB¡¯)

This command changes the value of the system value QUSRLIBL, which specifies the default list of libraries in the user portion of the library list to be used for a job at the time the job is started. The user portion of the library list contains the libraries INVLIB, STOCKLIB, and MYLIB.