Change IPL Attributes (CHGIPLA)

The Change IPL Attributes (CHGIPLA) command allows you to change the settings of attributes that are used during the initial program load (IPL).

Restrictions:

  1. To run this command, the user must have security administrator (*SECADM) and all object (*ALLOBJ) special authorities.

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

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.

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:

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Examples

CHGIPLA   DSPSTS(*ATTEND)

This command causes the status of the operating system IPL steps to be displayed during attended IPLs.

Error messages

*ESCAPE Messages

CPF1886
User not authorized to change IPL attributes.
CPF1887
Error occurred changing IPL attributes.