Display System Value (DSPSYSVAL)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Display System Value (DSPSYSVAL) command displays the name and the value of the specified system value.

Top


 

Parameters

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
OUTPUT Output *, *PRINT Optional, Positional 2

Top

 

System value (SYSVAL)

Specifies the name of the system value that is displayed.

This is a required parameter.

The system values are:

QABNORMSW

Previous end of system indicator. This value cannot be changed.

  • '0' means previous end was normal.

  • '1' means previous end was abnormal.

QACGLVL

Accounting level. Changes made to this system value take effect for jobs started after the change is made.

  • *NONE - No accounting information is written to a journal.

  • *JOB - Job resource use is written to a journal.

  • *PRINT - Spooled and printer file resource use is written to a journal.

QACTJOB

Initial number of active jobs for which storage is allocated. Changes made to this system value take effect at the next IPL.

QADLACTJ

Additional number of active jobs for which storage is allocated. Changes made to this system value take effect immediately.

QADLSPLA

Additional storage for extending spooling control block (bytes). The operating system no longer uses this system value. Changes made to this system value have no effect.

QADLTOTJ

Additional total number of jobs for which storage is allocated. Changes made to this system value take effect immediately.

QALWJOBITP

Allow jobs to be interrupted. This system value specifies how the system responds to user initiated requests to interrupt a job to run a user-defined exit program in that job. The Call Job Interrupt Program (QWCJBITP) API in the iSeries Information Center contains information on using job interrupt exit programs. The Change Job Interrupt Status (QWCCJITP) API in the iSeries Information Center contains information on retrieving and changing the interrupt status of a job. The interrupt status of an active job can be changed at any time but will only take effect when the value of QALWJOBITP allows jobs to be interrupted. Changes made to this system value take effect immediately. The shipped value is 0.

  • 0 means the system will not allow jobs to be interrupted to run user-defined exit programs. All new jobs becoming active will default to be uninterruptible. All active jobs are uninterruptible regardless of what the job interrupt status is set to.

  • 1 means the system will allow jobs to be interrupted to run user-defined exit programs. All new jobs becoming active will default to be uninterruptible.

  • 2 means the system will allow jobs to be interrupted to run user-defined exit programs. All new jobs becoming active will default to be interruptible.

QALWOBJRST

Allow object to be restored. This system value determines whether objects with security-sensitive attributes are restored. See Restore options for additional information.

QALWUSRDMN

Allow user domain objects in libraries or directories. This system value specifies which libraries on the system can contain the user domain user objects *USRSPC (user space), *USRIDX (user index), and *USRQ (user queue). Changes made to this system value take effect immediately.

QASTLVL

Assistance level. Indicates the Operational Assistant level of system displays for user profiles where ASTLVL(*SYSVAL) is specified. Changes made to this system value take effect immediately.

  • *BASIC - The Operational Assistant user interface is used.

  • *INTERMED - The system interface is used.

  • *ADVANCED - The expert system interface is used.

If a command does not have an *ADVANCED level interface, *INTERMED is used.

QATNPGM

Attention program. If *ASSIST is specified for this system value, the Operational Assistant main menu is called when the user presses the Attention (Attn) key. This value can be changed to the name of a program, which will be called when the user presses the Attn key in a job where ATNPGM(*SYSVAL) is specified in the user profile. Changes made to this system value take effect immediately.

QAUDCTL

Audit control. This system value contains the on and off switches for object and user action auditing. This system value activates auditing on the system that is selected by the Change Object Auditing (CHGOBJAUD) and Change User Auditing (CHGUSRAUD) commands and the QAUDLVL and QAUDLVL2 system values. Changes made to this system value take effect immediately.

  • *NOTAVL - The user performing the command is not allowed to display the current auditing value. You cannot change the system value to not available (*NOTAVL).

  • *NONE - No security auditing is done on the system. This is the shipped value.

  • *AUDLVL - The actions specified in the QAUDLVL and QAUDLVL2 system values will be logged to the security journal. Also actions specified by a user profile's action auditing values will be audited. A user profile's action auditing values are set through the AUDLVL parameter on the CHGUSRAUD command.

  • *OBJAUD - Actions against objects that have an object audit value other than *NONE will be audited. An object's audit value is set through the Change Auditing Value (CHGAUD) command or the CHGOBJAUD command.

  • *NOQTEMP - No auditing of most objects in QTEMP is done. You must specify *NOQTEMP with either *OBJAUD or *AUDLVL. You can not specify *NOQTEMP by itself.

QAUDENDACN

Audit journal error action. This system value specifies the action to be taken by the system if errors occur when an audit journal entry is being sent by the operating system to the security audit journal. Changes made to this system value take effect immediately.

  • *NOTAVL - The user performing the command is not allowed to display the current auditing value. You cannot change the system value to not available (*NOTAVL).

  • *NOTIFY - Notification of failure is sent to the QSYSOPR and QSYSMSG message queues, and then the action that caused the audit attempt continues.

  • *PWRDWNSYS - The Power Down System (PWRDWNSYS) command is issued. The system will then be brought up in a restricted state on the following IPL, and then only a user with audit (*AUDIT) and all object (*ALLOBJ) special authority can sign on the system.

QAUDFRCLVL

Force audit journal. This system value specifies the number of audit journal entries that can be written to the security auditing journal before the journal entry data is forced to auxiliary storage.

  • 1 through 100.

  • *SYS - The system determines when the journal entries are to be written to auxiliary storage based on internal system processing. *SYS cannot be returned in a decimal variable, so the command returns 0 when the value *SYS is specified.

  • *NOTAVL - The user performing the command is not allowed to display the current auditing value. You cannot change the system value to not available (*NOTAVL). *NOTAVL cannot be returned in a decimal variable, so the command returns -1 in place of *NOTAVL.

Changes made to this system value take effect immediately.

QAUDLVL

Security auditing level. Controls the level of action auditing on the system. Changes made to this system value take effect immediately for all jobs running on the system.

  • *NONE - No security action auditing will occur on the system. This is the shipped value.

  • *AUDLVL2 - Both QAUDLVL and QAUDLVL2 system values will be used to determine the security actions to be audited.

    • If you wish to use the QAUDLVL2 system value exclusively, set the QAUDLVL system value to *AUDLVL2 and add your auditing values to the QAUDLVL2 system value.

    • If you wish to use both system values you can set your values in the QAUDLVL system value along with the *AUDLVL2 value, then add any additional values to the QAUDLVL2 system value.

  • *ATNEVT - Attention events are audited. Attention events are conditions that require further evaluation to determine the condition's security significance. For example, intrusion monitor events need to be examined to determine whether the condition is an intrusion or a false positive.

  • *AUTFAIL - Authorization failures are audited.

  • *CREATE - All object creations are audited. Objects created into library QTEMP are not audited.

  • *DELETE - All deletions of external objects on the system are audited. Objects deleted from library QTEMP are not audited.

  • *JOBDTA - Actions that affect a job are audited.

  • *NETBAS - Network base functions are audited.

  • *NETCLU - Cluster and cluster resource group operations are audited.

  • *NETCMN - Networking and communications functions are audited.

    *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.

    • *NETBAS

    • *NETCLU

    • *NETFAIL

    • *NETSCK

  • *NETFAIL - Network failures are audited.

  • *NETSCK - Socket tasks are audited.

  • *NOTAVL - The user performing the command is not allowed to display the current auditing value. You cannot change the system value to not available (*NOTAVL).

  • *OBJMGT - Generic object tasks are audited.

  • *OFCSRV - OfficeVision tasks are audited.

  • *OPTICAL - All optical functions are audited.

  • *PGMADP - Adopting authority from a program owner is audited.

  • *PGMFAIL - Program failures are audited.

  • *PRTDTA - Printing functions are audited.

  • *SAVRST - Save and restore information is audited.

  • *SECCFG - Security configuration is audited.

  • *SECDIRSRV- Changes or updates when doing directory service functions are audited.

  • *SECIPC - Changes to interprocess communications are audited.

  • *SECNAS - Network authentication service actions are audited.

  • *SECRUN - Security run time functions are audited.

  • *SECSCKD - Socket descriptors are audited.

  • *SECURITY - All security-related functions are audited.

    *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.

    • *SECCFG

    • *SECDIRSRV

    • *SECIPC

    • *SECNAS

    • *SECRUN

    • *SECSCKD

    • *SECVFY

    • *SECVLDL

  • *SECVFY - Use of verification functions are audited.

  • *SECVLDL - Changes to validation list objects are audited.

  • *SERVICE - For a list of all the service commands and API calls that are audited, see the iSeries Security Reference publication

  • *SPLFDTA - Spooled file functions are audited.

  • *SYSMGT - System management tasks are audited.

QAUDLVL2

Security auditing level extension. This system value is required when more than sixteen auditing values are needed. Specifying *AUDLVL2 as one of the values in the QAUDLVL system value will cause the system to also look for auditing values in the QAUDLVL2 system value. Changes made to this system value take effect immediately for all jobs running on the system.

  • *NONE - No auditing values are contained in this system value. This is the shipped value.

  • *ATNEVT - Attention events are audited. Attention events are conditions that require further evaluation to determine the condition's security significance. For example, intrusion monitor events need to be examined to determine whether the condition is an intrusion or a false positive.

  • *AUTFAIL - Authorization failures are audited.

  • *CREATE - All object creations are audited. Objects created into library QTEMP are not audited.

  • *DELETE - All deletions of external objects on the system are audited. Objects deleted from library QTEMP are not audited.

  • *JOBDTA - Actions that affect a job are audited.

  • *NETBAS - Network base functions are audited.

  • *NETCLU - Cluster and cluster resource group operations are audited.

  • *NETCMN - Networking and communications functions are audited.

    *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.

    • *NETBAS

    • *NETCLU

    • *NETFAIL

    • *NETSCK

  • *NETFAIL - Network failures are audited.

  • *NETSCK - Socket tasks are audited.

  • *NOTAVL - The user performing the command is not allowed to display the current auditing value. You cannot change the system value to not available (*NOTAVL).

  • *OBJMGT - Generic object tasks are audited.

  • *OFCSRV - OfficeVision tasks are audited.

  • *OPTICAL - All optical functions are audited.

  • *PGMADP - Adopting authority from a program owner is audited.

  • *PGMFAIL - Program failures are audited.

  • *PRTDTA - Printing functions are audited.

  • *SAVRST - Save and restore information is audited.

  • *SECCFG - Security configuration is audited.

  • *SECDIRSRV- Changes or updates when doing directory service functions are audited.

  • *SECIPC - Changes to interprocess communications are audited.

  • *SECNAS - Network authentication service actions are audited.

  • *SECRUN - Security run time functions are audited.

  • *SECSCKD - Socket descriptors are audited.

  • *SECURITY - All security-related functions are audited.

    *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.

    • *SECCFG

    • *SECDIRSRV

    • *SECIPC

    • *SECNAS

    • *SECRUN

    • *SECSCKD

    • *SECVFY

    • *SECVLDL

  • *SECVFY - Use of verification functions are audited.

  • *SECVLDL - Changes to validation list objects are audited.

  • *SERVICE - For a list of all the service commands and API calls that are audited, see the iSeries Security Reference publication

  • *SPLFDTA - Spooled file functions are audited.

  • *SYSMGT - System management tasks are audited.

QAUTOCFG

Automatic device configuration indicator. Changes made to this system value take effect immediately.

  • 0 means auto-configuration is off.

  • 1 means auto-configuration is on.

QAUTOSPRPT

Automatic system disabled reporting. The operating system no longer uses this system value. Changes made to this system value have no effect.

QAUTORMT

Automatic configuration for remote controllers. The QAUTORMT system value controls the automatic configuration of remote controllers.

  • 0 means auto-configuration is off.

  • 1 means auto-configuration is on.

QAUTOVRT

Automatic virtual device configuration indicator. The user must have *ALLOBJ authority to change this system value. Changes made to this system value take effect immediately. See Autoconfigure virtual devices for additional information.

QBASACTLVL

Activity level of base storage pool. Changes made to this system value take effect immediately.

QBASPOOL

Minimum size of base storage pool (in Kilobytes). Changes made to this system value take effect immediately.

QBOOKPATH

Book and bookshelf search path. The operating system no longer uses this system value. Changes made to this system value have no effect.

QCCSID

Coded character set identifier. Changes made to this system value take effect for jobs started after the change is made.

QCENTURY

Century value for the system date.

  • 0 indicated years 19XX.

  • 1 indicates years 20XX.

QCFGMSGQ

Configuration message queue used to specify the message queue to receive communication messages. Both an object name and library name can be specified. A change to this system value takes effect when a line, controller, or device description that supports the MSGQ parameter is varied on.

QCHRID

Default graphic character set and code page used for displaying or printing data. Changes made to this system value take effect for display files, display device descriptions, and printer files that are created, changed, or overridden after the change.

QCHRIDCTL

Character identifier control for the job. This attribute controls the type of CCSID conversion that occurs for display files, printer files, and panel groups. The *CHRIDCTL special value must be specified for the CHRID parameter on the create, change, or override commands for display files, printer files, and panel groups before this attribute is used.

  • 0 means the *DEVD special value is used.

  • 1 means the *JOBCCSID special value is used.

QCMNARB

Communication arbiters. The number of communication arbiter jobs that are available to process work for controllers and devices. A change to this value takes effect on the next IPL. The shipped value is *CALC.

  • *CALC: The operating system calculates the number of communication arbiter jobs.

  • 0 - 99: Specifies the number of communication arbiter jobs that are available to process work for controllers and devices.

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.

QCMNRCYLMT

Provides recovery limits for system communications recovery. Specifies the number of recovery attempts to make and when an inquiry message is sent to the device message queue or to the system operator when the specified number of recovery attempts have been reached. Changes made to this system value do not affect a currently varied on device, but is in effect when a device is varied on after the change.

QCNTRYID

Default country or region identifier. Changes to this system value take effect for jobs started after the change is made.

QCONSOLE

System console. This value is not changeable.

QCRTAUT

Public authority for created objects. You must have *ALLOBJ and *SECADM special authorities to change this system value. Changes made to this system value take effect immediately.

  • *CHANGE means the user can change the object and perform basic functions on the object. Change authority allows the user to perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. Change authority provides object operational authority and all data authority.

  • *ALL means the user can control the object's existence, specify the security for the object, change the object, change the owner for the object, and perform basic functions on the object. All authority allows the user to perform all operations on the object except those limited to the owner or controlled by authorization list management rights. If the object is an authorization list, the user cannot add, change, or remove users, or transfer ownership of the authorization list.

  • *USE means the user can perform basic operations on the object, such as run a program or read a file. The user is prevented from changing the object. Use authority provides object operational authority and read authority.

  • *EXCLUDE authority prevents the user from accessing the object.

QCRTOBJAUD

Create object auditing. This system value specifies the default object auditing value for an object created into a library or directory. The object auditing value determines whether an audit journal entry is sent to the system auditing journal when an object is used or changed. Changes made to this system value take effect immediately.

  • *NOTAVL - The user performing the command is not allowed to display the current auditing value. You cannot change the system value to not available (*NOTAVL).

  • *NONE - No auditing entries are sent for the object.

  • *USRPRF - Auditing entries are sent if the user is currently being audited.

  • *CHANGE - Auditing entries are sent if the object is changed.

  • *ALL - Auditing entries are sent if the object is used or changed.

QCTLSBSD

Controlling subsystem description name. Both an object name and library name can be specified. Changes made to this system value take effect at the next IPL.

QCURSYM

Currency symbol. Changes made to this system value take effect immediately.

QDATE

System date. Changes made to this system value take effect immediately.

QDATETIME

System date and time. This is the date and time for the local system time as a single value. Retrieving or changing this value is similar to retrieving or changing QDATE and QTIME in a single operation. The format of the field is YYYYMMDDHHNNSSXXXXXX where YYYY is the year, MM is the month, DD is the day, HH is the hours, NN is the minutes, SS is the seconds, and XXXXXX is the microseconds. Changes made to this system value take effect immediately.

QDATFMT

Date format. Changes made to this system value take effect for jobs started after the change is made.

QDATSEP

Date separator. Changes made to this system value take effect for jobs started after the change is made.

QDAY

Day of the month (day of the year if the system date format is Julian). Changes made to this system value take effect immediately.

QDAYOFWEEK

The day of the week.

  • *SUN - Sunday

  • *MON - Monday

  • *TUE - Tuesday

  • *WED - Wednesday

  • *THU - Thursday

  • *FRI - Friday

  • *SAT - Saturday

QDBFSTCCOL

Database file statistics collection. Specifies the type of statistics collection requests that are allowed to be processed in the background by system job, QDBFSTCCOL. Changes made to this system value take effect immediately.

  • *ALL means all user requested database file statistics collection requests and statistics collections automatically requested by the database manager are allowed to be processed by the database statistics system job.

  • *SYSTEM means only automatically requested database statistics collection requests by the database manager are allowed to be processed by the database statistics system job.

  • *USER means only user requested database file statistics collection requests are allowed to be processed by the database statistics system job.

  • *NONE means no database file statistics collection requests are allowed to be processed by the database statistics system job.

QDBRCVYWT

Database recovery wait indicator. Changes to this system value take effect at the next IPL in unattended mode.

  • 0 means do not wait.

  • 1 means wait.

QDECFMT

Decimal format. Changes made to this system value take effect immediately.

QDEVNAMING

Indicates the device naming convention. Changes made to this system value take effect the next time a device is automatically configured. Existing configured device names are not changed.

  • *NORMAL means follow iSeries standards.

  • *S36 means follow S/36 standards.

  • *DEVADR means device names are derived from resource names.

QDEVRCYACN

Specifies the action taken when an I/O error occurs for the job's requesting program device. Changes made to this system value take effect for jobs started after the change is made.

  • *DSCMSG disconnects the job. On reconnection, an error message will be sent to the user's application program.

  • *DSCENDRQS disconnects the job. On reconnection, a cancel request function should be performed to return control of the job back to the last request level.

  • *ENDJOB ends the job. A job log will be produced for the job. A message will be sent to the job log and to the QHST log indicating that the job was ended because of device error.

  • *ENDJOBNOLIST ends the job. A job log will not be produced for the job. A message will be sent to the QHST log indicating that the job was ended because of device error.

  • *MSG signals the I/O error message to the application program. The application program performs error recovery itself.

QDSCJOBITV

Time interval that a job can be disconnected before it is ended. Changes made to this system value take effect immediately. An interactive job can be disconnected with the Disconnect Job (DSCJOB) command when it has been inactive for an interval of time (the system values QINACTIV and QINACTMSGQ), or when an Input/Output error occurs at the interactive job's work station (the system value QDEVRCYACN).

  • 5-1440 is the time out interval in minutes.

  • *NONE means no time out interval.

QDSPSGNINF

Controls the display of sign-on information. Changes made to this system value take effect immediately.

  • 0 means the sign-on information is not displayed.

  • 1 means the sign-on information is displayed.

QDYNPTYADJ

Dynamic priority adjustment. The QDYNPTYADJ system value controls whether the priority of interactive jobs is dynamically adjusted to maintain high performance of batch job processing. This adjustment capability is only effective on systems that are rated for both interactive and non-interactive throughput and have Dynamic Priority Scheduling enabled. A change to this value takes effect at the next IPL.

  • 0 means the dynamic priority adjustment support is turned off.

  • 1 means the dynamic priority adjustment support is turned on.

QDYNPTYSCD

Dynamic priority scheduler. The QDYNPTYSCD system value controls the dynamic priority scheduler algorithm. The value allows the use of dynamic priority scheduling.

  • 0 means the dynamic priority scheduler is off.

  • 1 means the dynamic priority scheduler is on.

QENDJOBLMT

Maximum time (in seconds) for application clean up during immediate ending of a job.

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.

QFRCCVNRST

Force conversion on restore. This system value allows you to specify whether or not to convert programs, service programs, SQL packages, and module objects during the restore. It can also prevent some objects from being restored. The default value on the restore commands use the value of this system value. Changes to this system value will take effect immediately.

0

Do not convert anything. Do not prevent anything from being restored.

1

Objects with validation errors will be converted.

2

Objects requiring conversion to be used on the current version of the operating system and objects with validation errors will be converted.

3

Objects suspected of having been tampered with, objects containing validation errors, and objects requiring conversion to be used by the current version of the operating system will be converted.

4

Objects that contain sufficient creation data to be converted and do not have valid digital signatures will be converted. An object that does not contain sufficient creation data will be restored without conversion. NOTE: Objects (signed and unsigned) that have validation errors, are suspected of having been tampered with, or require conversion to be used by the current version of the operating system, but cannot be converted will not be restored.

5

Objects that contain sufficient creation data will be converted. An object that does not contain sufficient creation data will be restored. NOTE: Objects that have validation errors, are suspected of having been tampered with, or require conversion to be used on the current version of the operating system, but cannot be converted will not be restored.

6

All objects that do not have a valid digital signature will be converted. NOTE: An object with a valid digital signature that also has a validation error, is suspected of having been tampered with, or requires conversion to be used on the current version of the operating system, but cannot be converted will not be restored.

7

Every object will be converted.

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.

QHOUR

Hour of the day. Changes made to this system value take effect immediately.

QHSTLOGSIZ

Maximum number of records for each version of the history log. Valid values range from 1 to 10,000,000 or the special value *DAILY which means that a new version of the history log is created each time the date in the history log messages changes, or when the current log version reaches the maximum size of 10,000,000 records. *DAILY cannot be returned in a decimal variable, so the Retrieve System Value (RTVSYSVAL) command returns a value of -1 when the system value is set to *DAILY. Specifying a value of -1 on the Change System Value (CHGSYSVAL) command has the same effect as specifying *DAILY. Changes made to this system value take effect when the next version of the history log is created.

QIGC

Indicates whether the double-byte character set (DBCS) version of the system is installed. This value cannot be changed.

  • 0 means the DBCS version is not installed.

  • 1 means the DBCS version is installed.

QIGCCDEFNT

Double byte character set (DBCS) coded font name. Used when transforming an SNA character string (SCS) into an Advanced Function Printing data stream (AFPDS) and when creating an AFPDS spooled file with shift in/shift out (SI/SO) characters in the data. Changes made to this system value take effect immediately.

QIGCFNTSIZ

Double byte coded font point size. Used along with the system value, QIGCCDEFNT, double byte coded font. They will be used when transforming SNA character string (SCS) into an Advanced Function Printing Data Stream (AFPDS) and when creating an AFPDS spooled file with shift in/ shift out (SI/SO) characters present in the data.

  • *NONE means that no point size is identified to the system. The point size is selected by the system based on the type of printer used.

  • 000.1 - 999.9 means the point size for the double byte coded font.

QINACTITV

Inactive interactive job time out interval in minutes. When the time interval is changed to a value other than *NONE a new inactivity interval is established and the analysis of job inactivity is started again. The system value QINACTMSGQ determines the action the system takes. For information on enforcement for target pass-through and TELNET sessions, see the Work Management information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter

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.

  • *NONE means that the system does not check for inactivity.

  • 5 - 300 means the number of minutes a job can be inactive before action is taken.

QINACTMSGQ

The qualified name of a message queue to which job inactive messages will be sent if QINACTMSGQ is not *NONE. The message queue must exist before the system value can be changed to a message queue name. Both an object name and library name can be specified. Changes made to this system value take effect immediately.

  • *ENDJOB means that interactive jobs, secondary jobs, and group jobs will be ended.

  • *DSCJOB means that interactive jobs, secondary jobs, and group jobs will be disconnected.

  • Message queue name is the name of a message queue that receives a message when a job has been inactive.

QIPLDATTIM

Date and time for automatic IPL. This system value can be set independently in each partition. If the primary partition is powered down at the time an automatic IPL should occur in a secondary partition, the IPL will not occur. When the primary partition does IPL, the secondary partition will be IPLed if its IPL date and time is past due. The secondary partition will not IPL if it was configured with an IPL action of hold. Changes made to this system value take effect immediately.

QIPLDATTIM is a single system value with two parts:

  • Date: The date an IPL automatically occurs on the system. The date is specified in QDATFMT format with no date separators.

  • Time: The time an IPL automatically occurs on the system. The time is specified with no time separators.

*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')

QIPLSTS

Initial program load (IPL) status indicator.

  • 0 means operator panel IPL.

  • 1 means auto-IPL after power restored.

  • 2 means restart IPL.

  • 3 means time of day IPL.

  • 4 means remote IPL.

QIPLTYPE

Indicates the type of IPL to perform. Changes made to this system value take effect at the next manual IPL.

  • 0 means unattended IPL.

  • 1 means attended IPL with dedicated service tools.

  • 2 means attended IPL with console in debug mode.

    You should only use this for problem analysis because it prevents other devices on the work station controller from being used.

QJOBMSGQFL

Job message queue full action. This system value specifies how to handle the job message queue when it is considered full. Changes made to this system value take effect for jobs started after the change is made.

  • *NOWRAP - The job message queue is not wrapped.

  • *WRAP - The job message queue is wrapped.

  • *PRTWRAP - The job message queue is wrapped and the messages that are being overlaid are printed.

QJOBMSGQMX

Job message queue maximum size. This system value specifies how large (in megabytes) a message queue can be before it is considered full. Changes made to this system value take effect for jobs started after the change is made.

QJOBMSGQSZ

Initial size of job message queue in kilobytes (KB). The operating system no longer uses this system value. Changes made to this system value have no effect.

QJOBMSGQTL

Maximum size of job message queue (in KB). The operating system no longer uses this system value. Changes made to this system value have no effect.

QJOBSPLA

Initial size of spooling control block for a job (in bytes). Changes made to this system value take effect when a cold start is requested during the installation of the operating system licensed program.

QKBDBUF

Keyboard buffer. Changes made to this system value take effect the next time someone logs on.

  • *NO means turn off the type-ahead feature and the attention key buffering option.

  • *TYPEAHEAD means turn on the type-ahead feature but turn off the attention key buffering option.

  • *YES means turn on the type-ahead feature and the attention key buffering option.

QKBDTYPE

Keyboard language character set. Changes made to this system value take effect immediately.

QLANGID

Default language identifier. Changes to this system value take effect for jobs started after the change is made.

QLEAPADJ

Leap year adjustment. Changes made to this system value take effect immediately.

QLIBLCKLVL

Library locking level. Specifies whether libraries in a job's library search list are locked by that job. A change to this system value takes effect for all jobs that become active after the change.

  • 0 means the libraries in a user job's library search list are not locked.

  • 1 means the libraries in a user job's library search list are locked by that job.

QLMTDEVSSN

Limits concurrent device sessions. Changes made to this system value take effect immediately.

  • 0 means you can sign on at multiple devices.

  • 1 means you cannot sign on at more than one device.

QLMTSECOFR

Limit security officer device access. Changes made to this system value take effect immediately.

  • 0 means users with *ALLOBJ or *SERVICE special authority can sign on any work station.

  • 1 means users with *ALLOBJ or *SERVICE special authority must have explicit authority to a work station.

QLOCALE

Locale path name. This system value is used to set the locale for the system. The locale path name must be a path name that specifies a locale. A locale is made up of the language, territory, and code set combination used to identify a set of language conventions. The maximum path length allowed for the locale path name on the Change System Value (CHGSYSVAL) command is 1,024 bytes.

A change to this system value takes effect immediately. The shipped value may be different for different countries.

  • *NONE means there is no locale path name for the QLOCALE system value.

  • *C means the C locale is to be used.

  • *POSIX means the POSIX locale is to be used.

QLOGOUTPUT

Job log output. This system value specifies how the job log will be produced when a job completes. This does not affect job logs produced when the message queue is full and the job message queue full action specifies *PRTWRAP. Messages in the job message queue are written to a spooled file, from which the job log can be printed, unless the Control Job Log Output (QMHCTLJL) API was used in the job to specify that the messages in the job log are to be written to a database file.

Changes made to this system value take effect immediately for jobs entering the system after the change is made.

  • *JOBEND means the job log will be produced by the job itself. If the job cannot produce its own job log, the job log will be produced by a job log server.

  • *JOBLOGSVR means the job log will be produced by a job log server.

  • *PND means the job log will not be produced. The job log remains pending until removed.

QMAXACTLVL

Maximum activity level of the system. Changes made to this system value take effect immediately.

QMAXJOB

Maximum number of jobs that are allowed on the system. Changes made to this system value take effect immediately.

QMAXSGNACN

The system's response when the limit imposed by QMAXSIGN system value is reached. Changes made to this system value take effect the next time someone attempts to sign on the system.

  • 1 means the device will be disabled.

  • 2 means the user profile will be disabled.

  • 3 means the device and the user profile will be disabled.

QMAXSIGN

Maximum number of not valid sign-on attempts allowed. Changes made to this system value take effect the next time someone attempts to sign on the system.

QMAXSPLF

Maximum number of spooled files that can be created per job. Changes made to this system value take effect immediately. Spooled files will not be deleted when this value is changed to a lower number. See the Printer Device Programming book for information on how this system value affects spooling for a job.

QMCHPOOL

Machine storage pool size (in KB). Changes made to this system value take effect immediately.

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.

QMINUTE

Minute of the hour. Changes made to this system value take effect immediately.

QMLTTHDACN

Multithreaded job action. This value controls the action to be taken when a function that may not be threadsafe is called in a multithreaded job. Changes made to this system value take effect immediately. The shipped value is 2.

  • 1 means perform the function that is not threadsafe without sending a message.

  • 2 means perform the function that is not threadsafe and send an informational message.

  • 3 means do not perform the function that is not threadsafe.

QMODEL

System model number. The number or letters used to identify the model of the system. You cannot change QMODEL, but the 4-character value can be displayed or retrieved in user-written programs. The system model number system value is the same in each partition on a system.

QMONTH

Month of the year (not used for Julian dates). Changes made to this system value take effect immediately.

QPASTHRSVR

Pass-through servers. The number of target display station pass-through server jobs that are available to process display station pass-through, iSeries Access for Windows workstation function (WSF), and other 5250 emulation programs on programmable workstations. Changes made to this system value take effect immediately. The shipped value is *CALC.

QPFRADJ

Initial program load (IPL) performance adjustment and dynamic performance tuning. Dynamic performance tuning automatically changes storage pool sizes and activity levels for shared storage pools. Private storage pools are not changed. Changes made to this system value take effect immediately.

  • 0 means no performance adjustment. Dynamic performance tuning is not started.

  • 1 means performance adjustment at IPL. Dynamic performance tuning is not started.

  • 2 means performance adjustment at IPL. Dynamic performance tuning is started. If QPFRADJ is changed from 2 to 0 or 1, dynamic performance tuning is stopped.

  • 3 means dynamic performance tuning is started. If QPFRADJ is changed from 3 to 0 or 1, dynamic performance tuning is stopped.

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).

QPRBFTR

Problem filter name. Specifies the name of the filter object used by the service activity manager when processing problems. Changes to this system value take effect immediately.

QPRBHLDITV

Problem log entry hold interval. Changes made to this system value take effect immediately.

QPRCFEAT

Processor feature. The is the processor feature code level of the system. You cannot change QPRCFEAT, but the 4-character value can be displayed or retrieved in user-written programs. The processor feature system value is the same in each partition on a system.

QPRCMLTTSK

Processor multitasking. If the hardware on your system supports processor multitasking, this system value allows you to set the multitasking capability to be on, off, or System-controlled. If enabled, more than one set of task data will be resident in each CPU. Some workloads may experience increased performance due to caching implications.

The operating system will set the system value to 0 on the next IPL if it detects that the hardware does not support multitasking. Setting the value to system controlled will allow the system to manage the multitasking. Changes made to this system value take effect at the next IPL.

  • 0 means that processor multitasking is turned off.

  • 1 means that processor multitasking is turned on.

  • 2 means that processor multitasking is under system control.

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.

QPRTDEV

Default printer device description. Changes made to this system value take effect for jobs started after the change is made.

QPRTKEYFMT

Print key format. Changes made to this system value take effect for jobs started after the change is made.

  • *PRTHDR means that header information is printed when the print key is pressed.

  • *PRTBDR means that border information is printed when the print key is pressed.

  • *PRTALL means that border information and header information are printed when the print key is pressed.

  • *NONE means that border information and header information are not printed when the print key is pressed.

QPRTTXT

Up to 30 characters of text that can be printed at the bottom of listings and separator pages. Changes made to this system value take effect for jobs started after the change is made.

QPWDEXPITV

The number of days for which a password is valid. Changes made to this system value take effect immediately.

  • *NOMAX means a password can be used an unlimited number of days.

  • 1-366 means the number of days before the password ends.

QPWDLMTAJC

Limits the use of adjacent numbers in a password. Changes made to this system value take effect the next time a password is changed.

  • 0 means adjacent numbers are allowed.

  • 1 means adjacent numbers are not allowed.

QPWDLMTCHR

Limits the use of certain characters in a password. Changes made to this system value take effect the next time a password is changed.

  • *NONE means there are no restricted characters.

  • restricted-characters means up to 10 restricted characters enclosed in apostrophes can be specified. Valid characters are: A-Z, 0-9, and special characters #, $, @, or underscore (_).

This system value is ignored if the system is operating at QPWDLVL 2 or 3.

QPWDLMTREP

Limits the use of repeating characters in a password. Changes made to this system value take effect the next time a password is changed.

  • 0 means characters can be used more than once.

  • 1 means characters cannot be used more than once.

QPWDLVL

Specifies the password level.

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.

  • 0 means passwords from 1-10 characters are allowed.

  • 1 means passwords from 1-10 characters are allowed. iSeries NetServer passwords for Windows 95/98/ME clients will be removed from the system making the product unavailable for use.

  • 2 means passwords from 1-128 characters are allowed. Passwords can consist of any character and will be case sensitive.

  • 3 means passwords from 1-128 characters are allowed. Passwords can consist of any character and will be case sensitive. iSeries NetServer passwords for Windows 95/98/ME clients will be removed from the system making the product unavailable for use.

QPWDMAXLEN

The maximum number of characters in a password. Changes made to this system value take effect the next time a password is changed.

  • 1-128 means a value from 1 to 128 can be specified as the maximum number of characters in a password.

    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.

QPWDMINLEN

The minimum number of characters in a password. Changes made to this system value take effect the next time a password is changed.

  • 1-128 means a value from 1 to 128 can be specified as the minimum number of characters in a password.

    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.

QPWDPOSDIF

Controls the position of characters in a new password. Changes made to this system value take effect the next time a password is changed.

  • 0 means the same characters can be used in a position corresponding to the same position in the previous password.

  • 1 means the same character cannot be used in a position corresponding to the same position in the previous password.

QPWDRQDDGT

Require number in a new password. Changes made to this system value take effect the next time a password is changed.

  • 0 means numbers are not required.

  • 1 means one or more numbers are required.

QPWDRQDDIF

Controls whether the password must be different than the previous passwords. Changes made to this system value take effect the next time a password is changed.

  • 0 means a password can be the same as one previously used.

  • 1 means a password must be different than the previous 32 passwords.

  • 2 means a password must be different than the previous 24 passwords.

  • 3 means a password must be different than the previous 18 passwords.

  • 4 means a password must be different than the previous 12 passwords.

  • 5 means a password must be different than the previous 10 passwords.

  • 6 means a password must be different than the previous 8 passwords.

  • 7 means a password must be different than the previous 6 passwords.

  • 8 means a password must be different than the previous 4 passwords.

QPWDVLDPGM

Password validation program provides the ability for a user-written program to do additional validation on passwords. Changes made to this system value take effect the next time a password is changed. See Password validation program for additional information.

QPWRDWNLMT

Maximum amount of time (in seconds) allowed for PWRDWNSYS *IMMED. This is the time used to wait for power down to complete normally after either of the following happens:

  • A Power Down System (PWRDWNSYS) command with *IMMED specified for the How to end (OPTION) parameter is entered.

  • A PWRDWNSYS command with *CNTRLD specified for the How to end (OPTION) parameter is entered and the time specified for the Controlled end delay time (DELAY) parameter has ended.

Changes to this value take effect when a PWRDWNSYS command is entered.

QPWRRSTIPL

Automatic initial program load (IPL) after power restored allowed. Changes made to this system value take effect the next time there is a power failure.

  • 0 means no auto-IPL after power restored.

  • 1 means auto-IPL after power restored.

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.

QQRYDEGREE

Query parallel processing degree. The value specifies the parallel processing degree available to users of the system.

  • *NONE means no parallel processing is allowed for database query processing or database file keyed access path builds or rebuilds.

  • *IO means any number of tasks can be used when the database query optimizer chooses to use I/O parallel processing for queries. SMP parallel processing is not allowed, including when building or rebuilding database file keyed access paths.

  • *OPTIMIZE means the query optimizer can choose to use any number of tasks for either I/O or SMP parallel processing to process the query or database file keyed access path build or rebuild. Use of parallel processing and the number of tasks used is determined with respect to the number of processors available in the pool in which the job is run, and whether the expected elapsed time for the query or database file keyed access path build or rebuild, is limited by CPU processing or I/O resources.

  • *MAX means the query optimizer can choose to use either I/O or SMP parallel processing to process the query. The choices made by the query optimizer will be similar to those made for the value *OPTIMIZE except the optimizer will assume that all active memory in the pool can be used to process the query or database file keyed access path build or rebuild.

QQRYTIMLMT

Query processing time limit.

  • *NOMAX means the maximum query interval is used.

  • 0-2147352578 means the number of seconds allowed for query processing.

QRCLSPLSTG

Automatic deletion of empty spooled members is allowed based on the member retention interval. Changes made to this system value take effect immediately.

  • *NONE means no retention interval.

    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.

  • *NOMAX means all empty members are kept.

  • 1-366 means the number of days that empty spooled members are kept for new spooled file use.

QRETSVRSEC

Retain server security data indicator. This value determines whether the security data needed by a server to authenticate a user on a target system through client/server interfaces can be retained on this system.

  • 0 means that the server security data is not retained.

  • 1 means that the server security data is retained.

QRMTSRVATR

Remote service attribute. The QRMTSRVATR system value controls the remote service problem analysis ability. The value allows the system to be analyzed remotely.

  • 0 means the remote service attribute is off.

  • 1 means the remote service attribute is on.

QRMTIPL

Remote power on and IPL indicator. Changes made to this system value take effect immediately.

  • 0 means remote power on and IPL are not allowed.

  • 1 means remote power on and IPL are allowed.

    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.

QRMTSIGN

Remote sign-on control. Changes made to this system value take effect immediately.

  • *FRCSIGNON means normal sign-on required.

  • *SAMEPRF means when the source and target user profile are the same, the sign-on can be bypassed for remote sign-on attempts.

  • *REJECT means no remote sign-on is allowed.

  • *VERIFY means after verifying that the user has access to the system, the system allows the user to bypass the sign-on.

  • program means you can specify a program to decide which remote sessions will be allowed and which user profiles can be automatically signed-on from which locations.

QSAVACCPTH

Save access paths. Changes made to this system value take effect at the start of the next save operation.

QSCANFS

Scan file systems. This system value specifies the integrated file systems in which objects will be scanned when exit programs are registered with any of the integrated file system scan-related exit points. Changes made to this system value take effect immediately. See Scan file systems for additional information.

QSCANFSCTL

Scan file systems control. This system value controls the integrated file system scanning on the system when exit programs are registered with any of the integrated file system scan-related exit points. These controls apply to integrated file system objects in the file systems covered by the QSCANFS(Scan file systems) system value. Changes made to this system value take effect immediately. See Scan file systems control for additional information.

QSCPFCONS

IPL action with console problem. Changes to this system value take effect before the next IPL.

  • 0 means end system.

  • 1 means continue the unattended IPL.

QSECOND

Second of the minute. Changes made to this system value take effect immediately.

QSECURITY

System security level. Changes made to this system value take effect at the next IPL.

  • 20 means the system requires a password to sign-on.

  • 30 means password security at sign-on and object security at each access. You must have authority to access all system resources.

  • 40 means password security at sign-on and object security at each access. Programs that try to access objects through interfaces that are not supported will fail.

  • 50 means the system requires a password to sign on and users must have authority to access objects and system resources. The security and integrity of the QTEMP library and user domain objects are enforced. Programs that try to access objects through interfaces that are not supported or that try to pass unsupported parameter values to supported interfaces will fail.

QSFWERRLOG

Software error log. Indicates whether system-detected software problems are entered in the error log. Changes made to this system value take effect immediately.

  • *LOG means that when a software error is detected by the system, the error is evaluated to determine if it should be logged unconditionally, or if the decision to log the error should be deferred to the policy based Service Monitor.

    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.

  • *NOLOG means no logging will occur if a software error is detected.

QSHRMEMCTL

Shared memory control. Specifies whether or not users can use shared memory, or use mapped memory that has write capability. Changes made to this system value take effect immediately.

  • 0 means that users cannot use shared memory, or use mapped memory that has write capability.

  • 1 means that users can use shared memory or mapped memory that has write capability.

QSPCENV

Special environment. The system environment used as the default for all users. Changes made to this system value take effect the next time a user signs on to the system.

  • *NONE means no special environment is entered when you sign on.

  • *S36 means the System/36 environment is entered when you sign on.

QSPLFACN

Spooled file action. Specifies whether spooled files are kept with a job or detached from the job. Keeping spooled files with jobs allows job commands such as the Work with Submitted Jobs (WRKSBMJOB) command to work with the spooled files even after the job has ended. Detaching spooled files from jobs reduces the use of system resources by allowing job structures to be recycled when the job ends. A change to this system value takes effect for all jobs that become active after the change. The shipped value is *KEEP.

  • *KEEP means that when the job ends, as long as at least one spooled file for the job exists in the system auxiliary storage pool (ASP number 1) or in a basic user ASP (ASP numbers 2-32), the spooled files are kept with the job and the status of the job is updated to indicate that the job has completed. If all remaining spooled files for the job are in independent ASPs (ASP numbers 33-255), the spooled files will be detached from the job and the job will be removed from the system.

  • *DETACH means the spooled files are detached from the job when the job ends.

QSRLNBR

System serial number. This value cannot be changed. If is retrieved from the data fields by the system when installing the operating system licensed program. You can display QSRLNBR, or you can retrieve this value in user-written programs. The system serial number is the same in each partition on a system.

QSRTSEQ

Sort sequence. This system value specifies the default sort sequence algorithm to be used by the system. Changes made to this system value take effect for jobs started after the change is made.

QSRVDMP

Service dumps. Indicates whether service dumps for escape messages that are not monitored are created. Changes made to this system value take effect immediately.

  • *DMPUSRJOB means that service dumps are created only for user jobs, not system jobs.

  • *DMPSYSJOB means that service dumps are created only for system jobs, not user jobs. System jobs include the operating system, subsystem monitors, LU service process, spooled readers and writers, and the SCPF job.

  • *DMPALLJOB means that service dumps are created for all jobs.

  • *NONE means no service dumps are created.

QSTGLOWACN

Auxiliary storage lower limit action. Specifies the action to take when the available storage in the system ASP goes below the auxiliary storage lower limit. A change to this system value takes effect immediately. The shipped value is *MSG.

  • *MSG: Send message CPI099C to QSYSMSG and QSYSOPR message queue. This message is also sent for the other actions.

  • *CRITMSG: Send critical message CPI099B to the user specified in the service attribute to receive critical messages.

  • *REGFAC: Submit a job to call exit programs registered for the QIBM_QWC_QSTGLOWACN exit point.

  • *ENDSYS: End the system to the restricted state.

  • *PWRDWNSYS: Power down the system immediately and restart it.

QSTGLOWLMT

Auxiliary storage lower limit. Specifies the percent of available storage remaining in the system ASP when the auxiliary storage lower limit action is taken. A change to this system value takes effect immediately. The shipped value is 5.0.

  • Lower limit: Percentage of available storage remaining in the system ASP when the action specified in QSTGLOWACN is taken. The percent of storage currently used in the system ASP can be viewed with the Work with System Status (WRKSYSSTS) command.

QSTRPRTWTR

Start print writers at initial program load (IPL). This system value is set by the system at the time of IPL or is set by the user on the IPL Options display. This system value cannot be changed using the Change System Value (CHGSYSVAL) command.

  • 0 means print writers were not started.

  • 1 means print writers were started.

QSTRUPPGM

Start-up program name from autostart job in the controlling subsystem. Both an object name and library name can be specified. Changes made to this system value take effect at the next IPL.

QSTSMSG

Indicates whether status messages are shown. Changes made to this system value take effect the next time a user signs on to the system.

  • *NORMAL means status messages will be shown.

  • *NONE means status messages will not be shown.

QSVRAUTITV

Server authentication interval. The operating system no longer uses this system value. Changes made to this system value have no effect.

QSYSLIBL

System part of the library list. Changes made to this system value take effect for jobs started after the change is made.

QTHDRSCADJ

Thread resources adjustment. This system value specifies whether or not the system should dynamically make adjustments to the affinity or preference of threads currently running in the system to certain processors and memory. If some resources are being utilized more than others, the system may reassign some of the threads running on the more heavily utilized resources to have affinity to the less utilized resources. Changes made to this system value take effect immediately. The shipped value is '1.'

  • '0' means no automatic adjustment of threads is made by the system. Threads will continue to have affinity to the resources which they are currently assigned to until they end or until the system value is changed.

  • '1' means the system dynamically makes adjustments of threads' affinity to the system's resources. It does not change the grouping or level of affinity in the threads.

QTHDRSCAFN

Thread resources affinity. The affinity or preference of threads to certain processors and memory. Changes made to this system value take effect immediately for threads in jobs that are started after the change, but has no effect on threads currently running.

  • *NOGROUP - Secondary threads will not necessarily have affinity to the same group of processors and memory as their initiating thread.

  • *GROUP - Secondary threads will have affinity to the same group of processors and memory as their initiating thread.

The thread resources affinity level can be set to the following values:

  • *NORMAL - A thread will use any processor or memory if the resources it has affinity to are not readily available.

  • *HIGH - A thread will only use the resources it has affinity to, and will wait until they become available if necessary.

QTIMADJ

Time adjustment. This system value can be used to identify software that adjusts the system clock to keep it synchronized with an external time source. This value should be maintained by time adjustment software and is intended as an aid to prevent having multiple time adjustment applications conflict with each other. There are no checks performed by the system to verify this value or that software is or is not performing time adjustments. IBM time adjustment offerings will use identifiers that start with QIBM such as 'QIBM_OS400_SNTP'. Other software suppliers should follow a similar naming convention of company name and product name.

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.

  • *NONE - Indicates that time adjustment software has not been identified.

  • Identifier - Identify the software that will be used to adjust the system clock.

QTIME

Time of day. Changes made to this system value take effect immediately.

QTIMSEP

Time separator. Changes made to this system value take effect for jobs started after the change is made.

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.

QTIMZON

Time zone. This specifies the name of the time zone description used to calculate local system time. A change to a different time zone description may result in a different offset that is associated with this new time zone description. The system value QUTCOFFSET will be changed as well to match this new offset. Changes made to this system value take effect immediately.

QTOTJOB

The total number of jobs for which storage must be allocated. Changes made to this system value take effect at the next IPL.

QTSEPOOL

Indicates whether interactive jobs should be moved to another main storage pool when they reach time slice end. Changes made to this system value take effect for jobs started after the change is made.

  • *NONE means jobs are not moved when time slice end is reached.

  • *BASE means jobs are moved when time slice end is reached.

QUPSDLYTIM

Uninterruptible power supply delay time. Changes made to this system value take effect the next time there is a power failure.

  • *BASIC powers only the PRC, IOP cards, and Load Source Disk.

  • *CALC means the appropriate wait time will be calculated.

  • *NOMAX means the system will not start any action on its own.

  • 0 means the system will power down automatically when system utility power fails.

  • 1-99999 means specify the delay time in seconds before the system powers down.

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.

QUPSMSGQ

Message queue for uninterruptible power supply messages. Changes made to this system value take effect the next time there is a power failure.

QUSEADPAUT

Defines which users can create, change and update programs and service programs with the (use adopted authority) USEADPAUT(*YES) attribute. When a program or service program has a use adopted authority attribute of *YES, the program/service program can use any adopted authority that is being passed to it from a program/ service program higher in the call stack.

This system value has no effect on the following:

  • Existing programs/service programs created with the USEADPAUT(*YES) attribute. Users are responsible for deciding which existing programs/service programs should be changed to have USEADPAUT(*NO).

  • Restoring a program/service program that uses adopted authority. These program/service programs can still be restored on your system.

  • Duplicating a program/service program that uses adopted authority. The USEADPAUT attribute of the existing program/service program is copied to the new object.

The following values can be specified:

  • *NONE means there is no restriction on who can create, change or update a program/service program to use adopted authority. Any user can create, change or update a program/service program to have the USEADPTAUT(*YES) attribute.

  • Name means you can specify the name of the authorization list which will control which users can set the USEADPAUT(*YES) attribute. The user needs *USE authority to the authorization list to be able to create, change or update programs/service programs with the USEADPAUT(*YES) attribute. Authority to the authorization list cannot come from adopted authority. That is, if you are running a program that adopts authority, the adopted authority is not used when checking authority to the authorization list.

QUSRLIBL

User part of the library list. Changes made to this system value take effect for jobs started after the change is made.

QUTCOFFSET

Indicates the number of hours (in 24-hour format) and minutes that the current system time is offset from the Coordinated Universal Time (UTC).

  • +hhmm means that the current system time is hh hours and mm minutes ahead of UTC.

  • -hhmm means that the current system time is hh hours and mm minutes behind UTC.

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.

QVFYOBJRST

Verify object on restore. This system value specifies the policy to be used for object signature verification during a restore operation. This value applies to objects of types: *CMD, *PGM, *SRVPGM, *SQLPKG and *MODULE. It also applies to *STMF objects which contain Java programs. This value also specifies the policy for PTFs applied to the system including Licensed Internal Code fixes. Changes made to this system value take effect immediately. See Verify object on restore for additional information.

QYEAR

Year. Changes made to this system value take effect immediately.

Top

 

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.

Top


 

Examples

 DSPSYSVAL   SYSVAL(QHOUR)

This command displays the current value of the system value QHOUR.

Top


 

Error messages

*ESCAPE Messages

CPF1028

&1 not valid for parameter SYSVAL.

CPF1074

SYSVAL(QMONTH) not valid for Julian date format.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9847

Error occurred while closing file &1 in library &2.

CPF9850

Override of printer file &1 not allowed.

CPF9851

Overflow value for file &1 in &2 too small.

CPF9871

Error occurred while processing.

Top