CHGIPLA (Change IPL Attributes)

CHGIPLA Command syntax diagram

 

Purpose

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

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

 

Optional Parameters

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.

KEYLCKPOS

Specifies the keylock position. A change to this attribute takes affect 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.

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. This attribute cannot be changed from a secondary partition. 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.

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 result in poor performance during both IPL steps that process the table and runtime functions that work with jobs. 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.

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

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.

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.

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.

DSPSTS

Specifies whether the status of OS/400 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 OS/400 IPL steps is displayed during attended IPLs and abnormal IPLs.

*NONE: The status of OS/400 IPL steps is not displayed during IPL.

*ATTEND: The status of OS/400 IPL steps is displayed during attended IPLs.

*ABNORMAL: The status of OS/400 IPL steps is displayed during abnormal IPLs.

*ALL: The status of OS/400 IPL steps is displayed during all IPLs, except as noted above.

STRTCP

Specifies whether the Start TCP/IP (STRTCP) command is automatically submitted at the completion of IPL and when the controlling subsystem is restarted from the restricted state. The STRTCP command is not submitted during install IPLs or when the system is starting to the restricted state. If you are using Operations Console, a value of *YES is recommended for this attribute. See the STRTCP command help for more information. The initial (shipped) value for this attribute is *YES.

*SAME: The value does not change.

*NO: STRTCP command is not automatically submitted. The STRTCP command must be used to start TCP/IP.

*YES: STRTCP command is automatically submitted at the completion of IPL.

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.

*NO: The job queues are not cleared.

*YES: The job queues are cleared during the IPL. This attribute is then reset to *NO.

CLROUTQ

Specifies whether or not to clear all output queues, thus removing all spooled output from the system. 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.

*NO: The output queues are not cleared.

*YES: The output queues are cleared during the IPL. This attribute is then reset to *NO.

CLRINCJOB

Specifies whether or not to delete the joblogs for jobs that were active at the time of the last system power down. 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.

*NO: The joblogs are not deleted.

*YES: The joblogs are deleted during the IPL. This attribute is then reset to *NO.

STRPRTWTR

Specifies whether or not print writers should be started at IPL time. The initial (shipped) value for this attribute is *YES. This attribute is reset to its initial value after each IPL.

*SAME: The value does not change.

*NO: Print writers are not started at IPL time. This attribute is then reset to *YES.

*YES: Print writers are started at IPL time.

STRRSTD

Specifies whether or not the system should be started in 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.

*NO: The system is not started to the restricted state.

*YES: The system is started to the restricted state. This attribute is then reset to *NO.

Example for CHGIPLA

CHGIPLA   CPRJOBTBL(*ABNORMAL)

This command causes the job tables to be compressed on abnormal IPLs.

Error messages for CHGIPLA

*ESCAPE Messages

CPF1886

User not authorized to change IPL attributes.

CPF1887

Error occurred changing IPL attributes.