| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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:
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:
Restrictions:
QCENTURY QDATE QDATETIME QDAY QHOUR QMINUTE QMONTH QSECOND QTIME QTIMZON QYEAR
QACGLVL QIPLTYPE QPWDMINLEN QSPLFACN QALWJOBITP QKBDBUF QPWDPOSDIF QSTGLOWACN QALWOBJRST QLIBLCKLVL QPWDRQDDGT QSTGLOWLMT QALWUSRDMN QLMTDEVSSN QPWDRQDDIF QSVRAUTITV QATNPGM QLMTSECOFR QPWDVLDPGM QSYSLIBL QAUTORMT QMAXJOB QPWRRSTIPL QTHDRSCADJ QAUTOSPRPT QMAXSGNACN QQRYDEGREE QTHDRSCAFN QAUTOVRT QMAXSIGN QQRYTIMLMT QUSEADPAUT QCRTAUT QMLTTHDACN QRETSVRSEC QVFYOBJRST QDEVNAMING QPRCMLTTSK QRMTIPL QDSPSGNINF QPRTDEV QRMTSIGN QDYNPTYADJ QPWDEXTPITV QRMTSRVATR QDYNPTYSCD QPWDLMTAJC QSCANFS QFRCCVNRST QPWDLMTCHR QSCANFSCTL QINACTITV QPWDLMTREP QSECURITY QINACTMSGQ QPWDLVL QSHRMEMCTL QIPLDATTIM QPWDMAXLEN QSPCENV
QAUDCTL QAUDENDACN QAUDFRCLVL QAUDLVL QAUDLVL2 QCRTOBJAUD
QCFGMSGQ
QCMNARB QLOGOUTPUT QPASTHRSVR
QALWJOBITP QDEVRCYACN QPWDLVL QSHRMEMCTL QALWOBJRST QDSCJOBITV QPWDMAXLEN QUSEADPAUT QALWUSRDMN QDSPSGNINF QPWDMINLEN QVFYOBJRST QAUDCTL QFRCCVNRST QPWDPOSDIF QAUDENACN QINACTMSGQ QPWDRQDDGT QAUDFRCLVL QLMTDEVSSN QPWDRQDDIF QAUDLVL QLMTSECOFR QPWDVLDPGM QAUDLVL2 QMAXSGNACN QRETSVRSEC QAUTOCFG QMAXSIGN QRMTSIGN QAUTORMT QPWDEXPITV QRMTSRVATR QAUTOVRT QPWDLMTAJC QSCANFS QCRTAUT QPWDLMTCHR QSCANFSCTL QCRTOBJAUD QPWDLMTREP QSECURITY
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SYSVAL | System value | QACGLVL, QACTJOB, QADLACTJ, QADLSPLA, QADLTOTJ, QALWJOBITP, QALWOBJRST, QALWUSRDMN, QASTLVL, QATNPGM, QAUDCTL, QAUDENDACN, QAUDFRCLVL, QAUDLVL, QAUDLVL2, QAUTOCFG, QAUTORMT, QAUTOSPRPT, QAUTOVRT, QBASACTLVL, QBASPOOL, QBOOKPATH, QCCSID, QCENTURY, QCFGMSGQ, QCHRID, QCHRIDCTL, QCMNARB, QCMNRCYLMT, QCNTRYID, QCRTAUT, QCRTOBJAUD, QCTLSBSD, QCURSYM, QDATE, QDATETIME, QDATFMT, QDATSEP, QDAY, QDBFSTCCOL, QDBRCVYWT, QDECFMT, QDEVNAMING, QDEVRCYACN, QDSCJOBITV, QDSPSGNINF, QDYNPTYADJ, QDYNPTYSCD, QENDJOBLMT, QFRCCVNRST, QHOUR, QHSTLOGSIZ, QIGCCDEFNT, QIGCFNTSIZ, QINACTITV, QINACTMSGQ, QIPLDATTIM, QIPLTYPE, QJOBMSGQFL, QJOBMSGQMX, QJOBMSGQSZ, QJOBMSGQTL, QJOBSPLA, QKBDBUF, QKBDTYPE, QLANGID, QLEAPADJ, QLIBLCKLVL, QLMTDEVSSN, QLMTSECOFR, QLOCALE, QLOGOUTPUT, QMAXACTLVL, QMAXJOB, QMAXSGNACN, QMAXSIGN, QMAXSPLF, QMCHPOOL, QMINUTE, QMLTTHDACN, QMONTH, QPASTHRSVR, QPFRADJ, QPRBFTR, QPRBHLDITV, QPRCMLTTSK, QPRTDEV, QPRTKEYFMT, QPRTTXT, QPWDEXPITV, QPWDLMTAJC, QPWDLMTCHR, QPWDLMTREP, QPWDLVL, QPWDMAXLEN, QPWDMINLEN, QPWDPOSDIF, QPWDRQDDGT, QPWDRQDDIF, QPWDVLDPGM, QPWRDWNLMT, QPWRRSTIPL, QQRYDEGREE, QQRYTIMLMT, QRCLSPLSTG, QRETSVRSEC, QRMTIPL, QRMTSIGN, QRMTSRVATR, QSAVACCPTH, QSCANFS, QSCANFSCTL, QSCPFCONS, QSECOND, QSECURITY, QSETJOBATR, QSFWERRLOG, QSHRMEMCTL, QSPCENV, QSPLFACN, QSRTSEQ, QSRVDMP, QSTGLOWACN, QSTGLOWLMT, QSTRUPPGM, QSTSMSG, QSVRAUTITV, QSYSLIBL, QTHDRSCADJ, QTHDRSCAFN, QTIMADJ, QTIME, QTIMSEP, QTIMZON, QTOTJOB, QTSEPOOL, QUPSDLYTIM, QUPSMSGQ, QUSEADPAUT, QUSRLIBL, QUTCOFFSET, QVFYOBJRST, QYEAR | Required, Positional 1 |
| VALUE | New value | Not restricted | Required, Positional 2 |
| Top |
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.
This is a required parameter.
The system values are:
If a command does not have an *ADVANCED level interface, *INTERMED is used.
Changes made to this system value take effect immediately.
Note:
Note: *NETCMN is composed of several values to allow you to better customize your auditing. If you specify all of the values, you will get the same auditing as if you specified *NETCMN. The following values make up *NETCMN.
Note: *SECURITY is composed of several values to allow you to better customize your auditing. If you specify all of the values, you will get the same auditing as if you specified *SECURITY. The following values make up *SECURITY.
Note: *NETCMN is composed of several values to allow you to better customize your auditing. If you specify all of the values, you will get the same auditing as if you specified *NETCMN. The following values make up *NETCMN.
Note: *SECURITY is composed of several values to allow you to better customize your auditing. If you specify all of the values, you will get the same auditing as if you specified *SECURITY. The following values make up *SECURITY.
Note: If this system value is set to zero (0), the work in these jobs is done in QSYSARB and QLUS system jobs as opposed to the communication arbiters.
When a job being ended has a signal handling procedure for the asynchronous signal SIGTERM, the SIGTERM signal is generated for that job. When the signal handling procedure for the SIGTERM signal is given control, the procedure can take the appropriate actions to avoid undesirable results such as application data that has been partially updated. If the SIGTERM signal handler has not completed in the specified time, the system ends the job.
When the job is ended in a controlled manner, the maximum time for the SIGTERM signal handler is specified on the command. When the job is ended in an immediate manner, the maximum time for the SIGTERM signal handler is specified by this system value. This time limit is used when ending one job, when ending all the jobs in a subsystem, or when ending all jobs in all subsystems. After two minutes, the system operator can use the End Job (ENDJOB) command with OPTION(*IMMED) to override the QENDJOBLMT value and end individual jobs immediately.
A change to this value takes effect immediately. Jobs that are already ending are not affected.
When an object is converted, its digital signature is discarded. The state of the converted object is set to user state. After conversion, objects will have a good validation value and are not suspected of having been tampered with.
Local jobs that are currently signed on to a remote system are excluded. For example, a work station is directly attached to system A, and system A has QINACTIV set on. If Display Station Pass-through or TELNET is used to sign on to system B, this work station is not affected by the QINACTITV value set on system A. Changes made to this system value take effect immediately.
QIPLDATTIM is a single system value with two parts:
*NONE, which indicates that no timed automatic IPL is scheduled, can be specified instead of a specific date and time.
The following example shows how to change the IPL date and time to September 10, 1993 (QDATFMT is MDY) at 9:00 a.m.
CHGSYSVAL SYSVAL(QIPLDATTIM) VALUE('091093 090000')
Note: You should only use this for problem analysis because it prevents other devices on the work station controller from being used.
A change to this system value takes effect immediately. The shipped value may be different for different countries.
Changes made to this system value take effect immediately for jobs entering the system after the change is made.
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.
If you create journal QPFRADJ in library QSYS, the dynamic tuning program keeps a record of the changes made to storage pool sizes, activity levels, and the performance level of the system when the changes were made (faulting rates per pool, pool sizes, and activity levels).
On some partitioned systems, this system value can only be changed from the primary partition.
For more information on partitions, see the Logical Partitions topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Note: This system value is ignored if the system is operating at QPWDLVL 2 or 3.
Changing this system value requires careful consideration. If your system connects to other systems in a network then all systems must be able to run with the password rules that will be in effect.
See the iSeries Security Reference publication for additional considerations prior to changing this system value.
Changes to this system value will take effect on the next IPL.
If the system is operating at QPWDLVL 0 or 1, the valid range is 1-10. If the system is operating at QPWDLVL 2 or 3, the valid range is 1-128.
If the system is operating at QPWDLVL 0 or 1, the valid range is 1-10. If the system is operating at QPWDLVL 2 or 3, the valid range is 1-128.
Changes to this value take effect when a PWRDWNSYS command is entered.
On partitioned AS/400 7xx and iSeries 8xx servers, this system value can only be changed from the primary partition. Whether or not a secondary partition is IPLed at the same time as the primary partition depends on the secondary partition's configuration value for IPL action.
On partitioned eServer i5 servers, this system value must be changed from the service processor's Advanced System Management (ASM) interface.
For more information on partitions, see the Logical Partitions topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Note: Using this value can have adverse effects on system performance. More information is in the Files and file systems topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
Note: Any telephone call will cause the system to IPL.
On partitioned AS/400 7xx and iSeries 8xx servers, this system value can only be changed from the primary partition. Whether or not a secondary partition is IPLed at the same time as the primary partition depends on the secondary partition's configuration value for IPL action.
On partitioned eServer i5 servers, this system value must be changed from the service processor's Advanced System Management (ASM) interface.
For more information on partitions, see the Logical Partitions topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
If the error is to be logged unconditionally, a PARable message is sent to QSYSOPR and an entry is created in the problem log. If the reporting component provides error data, a spooled file is created to contain the data. The spooled file name is stored in the error log and problem log entries.
If the error is to be conditionally logged, the decision to log the error will be made by the policy based Service Monitor. If the decision is to log the problem, an entry is created in the problem log. The problem data will be stored in a problem data library and the problem record entry will be updated with the name of the library.
The thread resources affinity level can be set to the following values:
Time adjustment software should check QTIMADJ prior to starting. If QTIMADJ has an identifier for other time adjustment software, then the software being started should notify the user of this potential conflict and confirm that this time adjustment software should be started. When QTIMADJ is *NONE the software should update QTIMADJ to identify that it is now responsible for adjusting the system clock. Time adjustment software should check QTIMADJ again prior to ending. QTIMADJ should be set to *NONE only if the current value identifies this time adjustment software that is ending. Changes made to this system value take effect immediately. The shipped value is *NONE.
This value affects jobs for which *SYSVAL is specified as the time separator. When specifying time on commands, users must use the time separator specified for their job or no time separator. If a time separator different from the job's time separator is used to specify time on a command, the command will fail.
On some partitioned systems, this system value can only be changed from the primary partition.
For more information on partitions, see the Logical Partitions topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
This system value has no effect on the following:
The following values can be specified:
Note: This system value must be the same as the offset that is associated with the time zone description specified in the system value QTIMZON. A change to a different time zone description for QTIMZON may result in a different associated offset. The system value QUTCOFFSET will be changed as well to match this new offset. QUTCOFFSET cannot be changed to a value that is different than the offset currently associated with QTIMZON. If an attempt is made to do so, the diagnostic message CPD1687 will be issued.
| Top |
Specifies the new value of the system value. Some system values, such as QUSRLIBL and QCTLSBSD, are made up of multiple character strings. These strings must be separated by blanks; apostrophes must surround the value specified for this parameter. For those system values that accept alphabetic characters, any letters that are entered in lowercase (a through z) are translated into uppercase (A through 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 for this parameter. For numeric system values, except for QSECURITY, apostrophes cannot be used. Type the new values that meet the type, length, and range requirements for that system value.
This is a required parameter.
| Top |
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.
| Top |
*ESCAPE Messages
| Top |