| Where allowed to run: Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX) Threadsafe: Yes |
Parameters Examples Error messages |
The Retrieve System Value (RTVSYSVAL) command is used in a CL program to retrieve the value from the specified system value so that it can be used in the program. The value is returned (copied) to the specified CL variable in the program.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SYSVAL | System value | QABNORMSW, 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, QCONSOLE, QCRTAUT, QCRTOBJAUD, QCTLSBSD, QCURSYM, QDATE, QDATETIME, QDATFMT, QDATSEP, QDAY, QDAYOFWEEK, QDBFSTCCOL, QDBRCVYWT, QDECFMT, QDEVNAMING, QDEVRCYACN, QDSCJOBITV, QDSPSGNINF, QDYNPTYADJ, QDYNPTYSCD, QENDJOBLMT, QFRCCVNRST, QHOUR, QHSTLOGSIZ, QIGC, QIGCCDEFNT, QIGCFNTSIZ, QINACTMSGQ, QINACTITV, QIPLDATTIM, QIPLSTS, QIPLTYPE, QJOBMSGQFL, QJOBMSGQMX, QJOBMSGQSZ, QJOBMSGQTL, QJOBSPLA, QKBDBUF, QKBDTYPE, QLANGID, QLEAPADJ, QLIBLCKLVL, QLMTDEVSSN, QLMTSECOFR, QLOCALE, QLOGOUTPUT, QMAXACTLVL, QMAXJOB, QMAXSGNACN, QMAXSIGN, QMAXSPLF, QMCHPOOL, QMINUTE, QMLTTHDACN, QMODEL, QMONTH, QPASTHRSVR, QPFRADJ, QPRBFTR, QPRBHLDITV, QPRCFEAT, 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, QSRLNBR, QSRTSEQ, QSRVDMP, QSTGLOWACN, QSTGLOWLMT, QSTRPRTWTR, QSTRUPPGM, QSTSMSG, QSVRAUTITV, QSYSLIBL, QTHDRSCADJ, QTHDRSCAFN, QTIMADJ, QTIME, QTIMSEP, QTIMZON, QTOTJOB, QTSEPOOL, QUPSDLYTIM, QUPSMSGQ, QUSEADPAUT, QUSRLIBL, QUTCOFFSET, QVFYOBJRST, QYEAR | Required, Positional 1 |
| RTNVAR | CL variable for returned value | Not restricted | Required, Positional 2 |
| Top |
Specifies the name of the system value whose value is retrieved and returned for use in the program. The names and descriptions of the system values that can be specified are in the Work Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
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 name of the CL program variable that receives the value of the system value being returned. The type and length for the CL variable when it was declared must be compatible with that of the system value being received. The attributes of individual system values are described in the Work Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
In general, the return variable type must match the system value type. For character system values that are 1 character long, the CL variable can be a character or logical variable. For character and logical system values, the length of the CL variable must equal the length of the system value. For decimal system values, the CL variable length must be greater than or equal to the length of the system value.
The following table lists the type and length of each system value.
SYSTEM VALUE TYPE LENGTH --------------------------------------------- QABNORMSW Character 1 QACGLVL Character 80 QACTJOB Decimal (5 0) QADLACTJ Decimal (5 0) QADLSPLA Decimal (5 0) QADLTOTJ Decimal (5 0) QALWJOBITP Character 1 QALWOBJRST Character 150 QALWUSRDMN Character 500 QASTLVL Character 10 QATNPGM Character 20 QAUDCTL Character 50 QAUDENDACN Character 10 QAUDFRCLVL Decimal (5 0) QAUDLVL Character 160 QAUDLVL2 Character 990 QAUTOCFG Character 1 QAUTORMT Character 1 QAUTOSPRPT Character 1 QAUTOVRT Decimal (5 0)
QBASACTLVL Decimal (5 0) QBASPOOL Decimal (10 0) QBOOKPATH Character (315)
QCCSID Decimal (5 0) QCENTURY Character 1 QCFGMSGQ Character 20 QCHRID Character 20 QCHRIDCTL Character 10 QCMNARB Character 10 QCMNRCYLMT Character 20 QCNTRYID Character 2 QCONSOLE Character 10 QCRTAUT Character 10 QCRTOBJAUD Character 10 QCTLSBSD Character 20 QCURSYM Character 1
QDATE Character 5 (for Julian dates) or 6 QDATETIME Character 20 QDATFMT Character 3 QDATSEP Character 1 QDAY Character 2 or 3 (for Julian dates) QDAYOFWEEK Character 4 QDBFSTCCOL Character 10 QDBRCVYWT Character 1 QDECFMT Character 1 QDEVNAMING Character 10 QDEVRCYACN Character 20 QDSCJOBITV Character 10 QDSPSGNINF Character 1 QDYNPTYADJ Character 1 QDYNPTYSCD Character 1
QENDJOBLMT Decimal (5 0)
QFRCCVNRST Character 1
QHOUR Character 2 QHSTLOGSIZ Decimal (8 0)
QIGC Character 1 QIGCCDEFNT Character 20 QIGCFNTSIZ Decimal (4 1) QINACTITV Character 10 QINACTMSGQ Character 20 QIPLDATTIM Character 20 QIPLSTS Character 1 QIPLTYPE Character 1
QJOBMSGQFL Character 10 QJOBMSGQMX Decimal (5 0) QJOBMSGQSZ Decimal (5 0) QJOBMSGQTL Decimal (5 0) QJOBSPLA Decimal (5 0)
QKBDBUF Character 10 QKBDTYPE Character 3
QLANGID Character 3 QLEAPADJ Decimal (5 0) QLIBLCKLVL Character 1 QLMTDEVSSN Character 1 QLMTSECOFR Character 1 QLOCALE Character 1024 QLOGOUTPUT Character 10
QMAXACTLVL Decimal (5 0) QMAXJOB Decimal (10 0) QMAXSGNACN Character 1 QMAXSIGN Character 6 QMAXSPLF Decimal (10 0) QMCHPOOL Decimal (10 0) QMINUTE Character 2 QMLTTHDACN Character 1 QMODEL Character 4 QMONTH Character 2
QPASTHRSVR Character 10 QPFRADJ Character 1 QPRBFTR Character 20 QPRBHLDITV Decimal (5 0) QPRCFEAT Character 4 QPRCMLTTSK Character 1 QPRTDEV Character 10 QPRTKEYFMT Character 10 QPRTTXT Character 30 QPWDEXPITV Character 6 QPWDLMTAJC Character 1 QPWDLMTCHR Character 10 QPWDLMTREP Character 1 QPWDLVL Decimal (5 0) QPWDMAXLEN Decimal (5 0) QPWDMINLEN Decimal (5 0) QPWDPOSDIF Character 1 QPWDRQDDGT Character 1 QPWDRQDDIF Character 1 QPWDVLDPGM Character 20 QPWRDWNLMT Decimal (5 0) QPWRRSTIPL Character 1
QQRYDEGREE Character 10 QQRYTIMLMT Character 10
QRCLSPLSTG Character 10 QRETSVRSEC Character 1 QRMTIPL Character 1 QRMTSRVATR Character 1 QRMTSIGN Character 20
QSAVACCPTH Character 1 QSCANFS Character 200 QSCANFSCTL Character 200 QSCPFCONS Character 1 QSECOND Character 2 QSECURITY Character 2 QSETJOBATR Character 160 QSFWERRLOG Character 10 QSHRMEMCTL Character 1 QSPCENV Character 10 QSPLFACN Character 10 QSRLNBR Character 8 QSRTSEQ Character 20 QSRVDMP Character 10 QSTGLOWACN Character 10 QSTGLOWLMT Decimal (7 4) QSTRPRTWTR Character 1 QSTRUPPGM Character 20 QSTSMSG Character 10 QSVRAUTITV Decimal (6 0) QSYSLIBL Character 150
QTHDRSCADJ Character 1
QTHDRSCAFN Character 20
QTIMADJ Character 30
QTIME Character 6, 7, 8, or 9 (for seconds,
tenths, hundredths, or
thousandths of a second)
QTIMSEP Character 1
QTIMZON Character 10
QTOTJOB Decimal (5 0)
QTSEPOOL Character 10
QUPSDLYTIM Character 20 QUPSMSGQ Character 20 QUSEADPAUT Character 10 QUSRLIBL Character 250 QUTCOFFSET Character 5
QVFYOBJRST Character 1
QYEAR Character 2
This is a required parameter.
| Top |
RTVSYSVAL SYSVAL(QDATE) RTNVAR(&DATE)
This command retrieves the date value from the system value QDATE and copies it into the CL variable &DATE. The CL variable must be declared as a 6-character variable to match the attributes of the QDATE system value.
| Top |
*ESCAPE Messages
| Top |