CHGSYSVAL (Change System Value)
CHGSYSVAL Command syntax diagram
Purpose
The Change System Value (CHGSYSVAL) command changes the current value of the
specified system value. System values are provided as part of the system. They
are used by the system to control certain operations in the operating system
and to communicate the status of certain conditions to the user. Changes to
some system values take effect immediately, some do not take effect until new
jobs are started, and others do not take effect until the next IPL. Note that
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. More information about system values is in the Work Management 
book.
Restrictions
- This command is shipped with public *EXCLUDE authority and the QPGMR,
QSYSOPR, and QSRV user profiles have private authorities to use the command.
- You must have *ALLOBJ and *SECADM special authorities to change security related system values.
Required Parameters
- SYSVAL
- Specifies the name of the system value whose value is being changed. Most
of the system values can be specified; however, some cannot have their values
changed by this command. More information on which values can be specified is
in the Work Management
book.
- VALUE
- Specifies the new value of the system value. Some system values, such as
QUSRLIBL and QCTLSBSD, may be made up of multiple character strings. These
strings must be separated by blanks; apostrophes must surround the entire
contents of the VALUE parameter. For system values that accept alphabetic
characters, with the exception of QPRTTXT, letters that are entered in
lowercase (a-z) are translated into uppercase (A-Z) even if they are enclosed
in apostrophes. Some system values, such as QDATE and QDBRCVYWT, are
zoned-decimal values (character in nature) and must also be enclosed in
apostrophes when specified in this parameter. For numeric system values,
apostrophes cannot be used. Descriptions of all system values are in the Work Management book. Enter the new values that meet the type,
length, and range requirements for that system value.
Examples for CHGSYSVAL
Example 1: Changing the System Value of a Character Variable
CHGSYSVAL SYSVAL(QHOUR) VALUE('12')
This command changes the value of the system value QHOUR (which is a subvalue of the QTIME system value) to 12. Because QHOUR is a character variable, 2 characters long, the system value is set to the character representation of 12, which is hex F1F2 and, therefore, must be enclosed in apostrophes. Also, the QTIME system value is updated with this value because QHOUR is a subvalue of QTIME.
Example 2: Changing a System Value to Contain Multiple Character Strings
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.
Error messages for CHGSYSVAL
*ESCAPE Messages
- CPF1001
- Wait time expired for system response.
- CPF1028
- &1 not valid for parameter SYSVAL.
- CPF1030
- System value &1 cannot be changed.
- CPF1058
- VALUE parameter not correct for system value &1.
- CPF1059
- Length of value not correct for &1.
- CPF1074
- SYSVAL(QMONTH) not valid for Julian date format.
- CPF1076
- Specified value not allowed for system value &1.
- CPF1078
- System value &1 not changed.
- CPF1079
- Too many or too few values listed for &1.
- CPF1127
- Device specified for QPRTDEV not printer device.
- CPF1132
- Name specified for system value &1 not valid.
- CPF1203
- Keyboard identifier &1 not correct.
- CPF18A4
- User not authorized to change system value &1.
- CPF1830
- Specified values not valid for system value &1.
- CPF1831
- User not authorized to change system value &1.
- CPF1832
- Cannot change system value &1 during IPL.
- CPF1842
- Cannot access system value &1.
- CPF1852
- System value &1 not changed.
- CPF1856
- Filter type &4 not correct for system value &1.
- CPF1857
- Specified value for &1 not a code font.
- CPF1864
- User not authorized to change system value &1.
- CPF210C
- Library &1 not changed.
- CPF268D
- Unable to access system value &1.