Work with System Value (WRKSYSVAL)

The Work with System Value (WRKSYSVAL) command allows you to work with a specified system value. The 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.

Changes to some system values take effect immediately; however, some do not take effect until new jobs are started, and others do not take effect until the next initial program load (IPL). More information about system values is in the Work management topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Note: Refer to the CL variable for returned value (RTNVAR) parameter of the Retrieve System Value (RTVSYSVAL) command for a chart that shows the type and length of each system value.

Restrictions:

  1. Refer to the Change System Value (CHGSYSVAL) command for information regarding the authority required to change certain system values.

Parameters

Keyword Description Choices Notes
SYSVAL System value Generic name, name, *ALL, *ALC, *DATTIM, *EDT, *LIBL, *MSG, *SEC, *STG, *SYSCTL, 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, QINACTITV, QINACTMSGQ, 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, QPWDCHGBLK, QPWDEXPITV, QPWDEXPWRN, QPWDLMTAJC, QPWDLMTCHR, QPWDLMTREP, QPWDLVL, QPWDMAXLEN, QPWDMINLEN, QPWDPOSDIF, QPWDRQDDGT, QPWDRQDDIF, QPWDRULES, QPWDVLDPGM, QPWRDWNLMT, QPWRRSTIPL, QQRYDEGREE, QQRYTIMLMT, QRCLSPLSTG, QRETSVRSEC, QRMTIPL, QRMTSIGN, QRMTSRVATR, QSAVACCPTH, QSCANFS, QSCANFSCTL, QSCPFCONS, QSECOND, QSECURITY, QSETJOBATR, QSFWERRLOG, QSHRMEMCTL, QSPCENV, QSPLFACN, QSRLNBR, QSRTSEQ, QSRVDMP, QSSLCSL, QSSLCSLCTL, QSSLPCL, QSTGLOWACN, QSTGLOWLMT, QSTRPRTWTR, QSTRUPPGM, QSTSMSG, QSVRAUTITV, QSYSLIBL, QTHDRSCADJ, QTHDRSCAFN, QTIMADJ, QTIME, QTIMSEP, QTIMZON, QTOTJOB, QTSEPOOL, QUPSDLYTIM, QUPSMSGQ, QUSEADPAUT, QUSRLIBL, QUTCOFFSET, QVFYOBJRST, QYEAR Optional, Positional 1
OUTPUT Output *, *PRINT Optional

System value (SYSVAL)

Specifies the name of the system value with which you wish to work. Most of the system values can be specified; however, some values cannot be changed by this command. More information on which values can be specified is in the Work management topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

*ALL
All system values.
*ALC
Allocation system values.
*DATTIM
Date and time system values.
*EDT
Editing system values.
*LIBL
Library list system values.
*MSG
Message and logging system values.
*SEC
Security system values.
*STG
Storage system values.
*SYSCTL
System control system values.
generic-name
Specify the generic name for the system values to work with. A generic name is a character string of one or more characters followed by an asterisk (*); for example, QAU*. If a generic name is specified, then all entries with names that begin with the generic name will be shown on the WRKSYSVAL panel.
name
Specify the name of the system value to work with.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*
The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
*PRINT
The output is printed with the job's spooled output.

Examples

Example 1: Displaying Date and Time System Values

WRKSYSVAL   SYSVAL(*DATTIM)

This command displays a list of all the date and time system values.

Example 2: Displaying Security System Values

WRKSYSVAL   SYSVAL(*SEC)

This command displays a list of all the security system values.

Example 3: Working with the Control Subsystem Description System Value

WRKSYSVAL   SYSVAL(QCTLSBSD)

This command allows you to work with the controlling subsystem description system value, QCTLSBSD.

Example 4: Printing System Values

WRKSYSVAL   OUTPUT(*PRINT)

This command prints a list of all system values and their current values.

Error messages

*ESCAPE Messages

CPF1001
Wait time expired for system response.
CPF1030
System value &1 cannot be changed.
CPF1059
Length of value not correct for &1.
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.
CPF1203
Keyboard identifier &1 not correct.
CPF1831
User not authorized to change 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.