Change IPL Attributes (CHGIPLA)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change IPL Attributes (CHGIPLA) command allows you to change the settings of attributes that are used during the initial program load (IPL).
Restrictions:
- To run this command, the user must have security administrator (*SECADM) and all object (*ALLOBJ) special authorities.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| RESTART | Restart type | *SAME, *SYS, *FULL | Optional |
| KEYLCKPOS | Keylock position | *SAME, *NORMAL, *AUTO, *SECURE | Optional |
| HDWDIAG | Hardware diagnostics | *SAME, *MIN, *ALL | Optional |
| CPRJOBTBL | Compress job tables | *SAME, *NONE, *NEXT, *NORMAL, *ABNORMAL, *ALL | Optional |
| CHKJOBTBL | Check job tables | *SAME, *ABNORMAL, *ALL, *SYNC | Optional |
| RBDPRDDIR | Rebuild product directory | *SAME, *NONE, *NORMAL, *ABNORMAL, *ALL | Optional |
| MSFRCY | Mail Server Framework recovery | *SAME, *NONE, *ABNORMAL | Optional |
| DSPSTS | Display status | *SAME, *SYS, *NONE, *ATTEND, *ABNORMAL, *ALL | Optional |
| STRTCP | Start TCP/IP | *SAME, *YES, *NO | Optional |
| SPLFRCY | Spooled file recovery | *SAME, *DETACH, *REMOVE | Optional |
| CLRJOBQ | Clear job queues | *SAME, *YES, *NO | Optional |
| CLROUTQ | Clear output queues | *SAME, *YES, *NO | Optional |
| CLRINCJOB | Clear incomplete joblogs | *SAME, *YES, *NO | Optional |
| STRPRTWTR | Start print writers |  *SAME, *YES, *NO, *NONE |
Optional |
| STRRSTD | Start to restricted state | *SAME, *YES, *NO | Optional |
| Top |
Restart type (RESTART)
Specifies the point from which the initial program load (IPL) restarts when RESTART(*YES) or RESTART((*YES *IPLA)) are specified on the Power Down System (PWRDWNSYS) command. Specifying *SYS rather than *FULL can reduce the time required to restart the system. The initial (shipped) value for this parameter is *SYS.
- *SAME
- The value does not change.
- *SYS
- The operating system is restarted. The hardware is restarted only if a PTF that requires a hardware restart is to be applied.
- *FULL
- All portions of the system, including the hardware, are restarted.
| Top |
Keylock position (KEYLCKPOS)
Specifies the keylock position. A change to this attribute takes effect immediately. The following restrictions apply when the keylock position is being changed:
- The keylock position cannot be set to MANUAL for security reasons.
- If the keylock position is currently SECURE, the keylock position cannot be changed.
- If the system has a keylock and the key is not inserted, the keylock position cannot be changed.
- *SAME
- The value does not change.
- *NORMAL
- The keylock position is changed to NORMAL.
- *AUTO
- The keylock position is changed to AUTO.
- *SECURE
- The keylock position is changed to SECURE.
| Top |
Hardware diagnostics (HDWDIAG)
Specifies whether certain hardware diagnostics should be performed during the IPL. The list of diagnostics is pre-determined by the system and cannot be modified by the user. On a partitioned system, this IPL attribute must be changed from the service processor's Advanced System Management Interface (ASMI).
For more information on partitions, see the Logical Partitions topic in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/. The initial (shipped) value for this attribute is *MIN.
- *SAME
- The value does not change.
- *MIN
- The minimum set of hardware diagnostics is run.
- *ALL
- All hardware diagnostics are run.
| Top |
Compress job tables (CPRJOBTBL)
Specifies when the job tables should be compressed to remove excess unused entries. The Display Job Tables (DSPJOBTBL) command can be used to determine the number of unused entries in the job tables. Excessive unused entries can indicate that job tables need to be compressed. However, compression can take a significant amount of time during IPL. The initial (shipped) value for this attribute is *NONE.
- *SAME
- The value does not change.
- *NONE
- The job tables are not compressed during any IPL.
- *NEXT
- The job tables are compressed during the following IPL. This value will be reset to *NONE after job table compression is started.
- *NORMAL
- The job tables are compressed during normal IPLs only.
- *ABNORMAL
- The job tables are compressed during abnormal IPLs only.
- *ALL
- The job tables are compressed during all IPLs.
| Top |
Check job tables (CHKJOBTBL)
Specifies when particular damage checks on the job tables should be performed. The initial (shipped) value for this attribute is *ABNORMAL.
- *SAME
- The value does not change.
- *ABNORMAL
- The job table checks are performed during an abnormal IPL only.
- *ALL
- The job table checks are performed during all IPLs.
- *SYNC
- The job table checks are performed synchronously during all IPLs.
| Top |
Rebuild product directory (RBDPRDDIR)
Specifies when the product directory information should be fully rebuilt. A full rebuild is required during the IPL following the install of the operating system. This attribute is overridden during that IPL. The initial (shipped) value for this attribute is *NONE.
- *SAME
- The value does not change.
- *NONE
- The product directory information is not fully rebuilt.
- *NORMAL
- The product directory information is fully rebuilt during a normal IPL only.
- *ABNORMAL
- The product directory information is fully rebuilt during an abnormal IPL only.
- *ALL
- The product directory information is fully rebuilt during all IPLs.
| Top |
Mail Server Framework recovery (MSFRCY)
Specifies whether Mail Server Framework recovery is done during abnormal IPLs. The initial (shipped) value for this attribute is *NONE.
- *SAME
- The value does not change.
- *NONE
- Mail Server Framework recovery is not done during IPL. Recovery is done when Mail Server Framework starts.
- *ABNORMAL
- Mail Server Framework recovery is done during an abnormal IPL.
| Top |
Display status (DSPSTS)
Specifies whether the status of operating system IPL steps is displayed at the console during IPL. Status is not displayed during install IPLs or when the console is not powered on. The initial (shipped) value for this attribute is *ALL.
- *SAME
- The value does not change.
- *SYS
- The status of operating system IPL steps is displayed during attended IPLs and abnormal IPLs.
- *NONE
- The status of operating system IPL steps is not displayed during IPL.
- *ATTEND
- The status of operating system IPL steps is displayed during attended IPLs.
- *ABNORMAL
- The status of operating system IPL steps is displayed during abnormal IPLs.
- *ALL
- The status of operating system IPL steps is displayed during all IPLs, except as noted above.
| Top |
Start TCP/IP (STRTCP)
Specifies whether the Start TCP/IP (STRTCP) command is automatically submitted at the completion of IPL and when the controlling subsystem is restarted to bring the system out of the restricted state. The STRTCP command is not submitted during install IPLs or when the system is starting to the restricted state. See the STRTCP command help for more information. The initial (shipped) value for this attribute is *YES.
- *SAME
- The value does not change.
- *YES
- STRTCP command is automatically submitted.
- *NO
- STRTCP command is not automatically submitted.
| Top |
Spooled file recovery (SPLFRCY)
Specifies what should be done with all spooled files during IPL when a job table is detected as damaged, or if *YES is set for these three IPL attributes: Clear job queues (CLRJOBQ), Clear output queues (CLROUTQ), and Clear incomplete joblogs (CLRINCJOB). The initial (shipped) value for this attribute is *DETACH.
- *SAME
- The value does not change.
- *DETACH
- Spooled files are detached from the job and remain on the system.
- *REMOVE
- Spooled files are removed from the system.
| Top |
Clear job queues (CLRJOBQ)
Specifies whether or not to clear the jobs from all job queues. The initial (shipped) value for this attribute is *NO. This attribute is reset to its initial value after each IPL.
- *SAME
- The value does not change.
- *YES
- The job queues are cleared during the IPL. This attribute is then reset to *NO.
- *NO
- The job queues are not cleared.
| Top |
Clear output queues (CLROUTQ)
Specifies whether or not to clear all output queues in libraries that are in the system auxiliary storage pool (ASP number 1) or basic user auxiliary storage pools (ASP numbers 2-32), thus removing all spooled output from those output queues. The initial (shipped) value for this attribute is *NO. This attribute is reset to its initial value after each IPL.
Note: If *YES is specified for this attribute, and *YES is also specified for both the Clear job queues (CLRJOBQ) and Clear incomplete joblogs (CLRINCJOB) IPL attributes, then spooled files will be removed only if *REMOVE is specified for the Spooled file recovery (SPLFRCY) IPL attribute.
- *SAME
- The value does not change.
- *YES
- The output queues are cleared during the IPL unless *YES is also specified for the CLRJOBQ and CLRINCJOB IPL attributes and *DETACH is specified for the SPLFRCY IPL attribute. In that case, the spooled files will be detached from the jobs, but will not be removed from the output queues. This attribute is then reset to *NO.
- *NO
- The output queues are not cleared.
| Top |
Clear incomplete joblogs (CLRINCJOB)
Specifies whether or not to delete the job logs that have not yet been written. This deletes all pending job logs. This affects jobs that were active at the time of the last system power down, jobs whose job log have not yet been written by a job log server, and jobs that specify a value of *PND for the job log output (LOGOUTPUT) job attribute.
To clear incomplete job logs without performing an IPL, use the Remove pending job log (QWTRMVJL) API.
The initial (shipped) value for this attribute is *NO. This attribute is reset to its initial value after each IPL.
- *SAME
- The value does not change.
- *YES
- The joblogs are deleted during the IPL. This attribute is then reset to *NO.
- *NO
- The joblogs are not deleted.
| Top |
Start print writers (STRPRTWTR)
Specifies whether or not print writers should be started at IPL time. The initial (shipped) value for this attribute is *YES.
- *SAME
- The value does not change.
- *YES
- Print writers are started at IPL time.
- *NO
- Print writers are not started at IPL time. This attribute is then reset to *YES.
- *NONE
- Print writers are not started at IPL time.
| Top |
Start to restricted state (STRRSTD)
Specifies whether or not the system should be started to the restricted state, which means that only the system console will be active. The initial (shipped) value for this attribute is *NO. This attribute is reset to its initial value after each IPL.
- *SAME
- The value does not change.
- *YES
- The system is started to the restricted state. This attribute is then reset to *NO.
- *NO
- The system is not started to the restricted state.
| Top |
Examples
CHGIPLA DSPSTS(*ATTEND)
This command causes the status of the operating system IPL steps to be displayed during attended IPLs.
| Top |
Error messages
*ESCAPE Messages
- CPF1886
- User not authorized to change IPL attributes.
- CPF1887
- Error occurred changing IPL attributes.
| Top |