Process Install Disk Configuration Option (QINPIDCO) API


 Required Parameter:

1 Keep install disk configuration option Input Char(10)

  Optional Parameter Group:

2 Current setting Output Char(10)
3 Error code I/O Char(*)

 Default Public Authority: *EXCLUDE

 Threadsafe: Yes

The Process Install Disk Configuration Option (QINPIDCO) API is used to specify whether to keep the current disk configuration during the next automatic installation. This API also returns the current keep install disk configuration option setting.


Authorities and Locks

Authority
The caller of the API must be running under a user profile that has all object (*ALLOBJ) and input/output (I/O) system configuration (*IOSYSCFG) special authority.

Required Parameter Group

Keep install disk configuration option
INPUT; CHAR(10)

The disk configuration option to be used for the next automatic install. After a successful automatic install, this option will be set back to the default value of *NO.

The possible values follow:

*NO The current disk configuration will not be kept. All non-configured disk units will be added to the system auxiliary storage pool (ASP) during the next automatic installation.
*YES The current disk configuration will be kept. All non-configured disks units will not be added to the system auxiliary storage pool (ASP) during the next automatic installation.
*SAME The current setting for disk configuration should not change. This option can be used to retrieve the current keep install disk configuration setting.

Optional Parameter Group

Current setting
OUTPUT; CHAR(10)

The variable that is to receive the current install disk option setting. This variable will contain the value of the disk configuration option prior to setting its new value.

The possible values follow:

*NO The current disk configuration will not be kept. All non-configured disk units will be added to the system auxiliary storage pool (ASP) during the next automatic installation.
*YES The current disk configuration will be kept during the next automatic installation. Non-configured disks units will not be added to the system auxiliary storage pool (ASP).
Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPF24B4 E Severe error while addressing parameter list.
CPF3CF1 E Error code parameter not valid.
CPF3DD1 E Incorrect parameter value.
CPF222E E &1 special authority is required.


API introduced: V6R1

[ Back to top | Configuration APIs | APIs by category ]