Parameters

The parameters are explained as follows:

ReturnCode

Returned parameter

Type: Integer (non-REXX), character representation of an integer (REXX)
Length: 4 bytes (non-REXX)

ReturnCode contains the return code from the service.

ConnectToken

Supplied parameter

Type: Character string
Length: 16 bytes

ConnectToken represents a logical connection between the application and a CPC, image, or activation profile. The ConnectToken is an output parameter on the HWICONN service call.

Start of change In most cases, the ConnectToken specified must have originated from a HWICONN service call that was issued from the same address space as this service call. For BCPii REXX execs running under the TSO/E or ISV-provided REXX environments, the ConnectToken specified must have originated from a HWICONN service call that was issued from the same task. End of change

SetType

Supplied parameter

Type: Integer (non-REXX), character representation of an integer (REXX)
Length: 4 bytes (non-REXX)

SetType specifies the type of set request.

The following table is the list of valid set types. See the following documentation for more information:

System z Application Programming Interfaces (SB10-7030-13)
System z10 and eServer zSeries Application Programming Interfaces (SB10-7030-09)
System z9 and eServer zSeries Application Programming Interfaces (SB10-7030-08)
Publication appropriate to the level of hardware that the HWISET is targeted.

Constant in: Hexadecimal (Decimal) Equate Symbol	Description
6 (6) HWI_ACCSTAT	Requests to change or set the acceptable CPC status values. Note: The input connection token represents a CPC connection or an image connection.
7 (7) HWI_APROF	Requests to change or set the next activation reset profile name. Note: The input connection token represents a CPC connection or an image connection.
27 (39) HWI_PRUNTYPE	Requests to change or set the processor running time type. Note: The input connection token represents a CPC connection or a reset activation profile connection.
28 (40) HWI_PRUNTIME	Requests to change or set the processor running time type. Note: The input connection token must only represent a CPC connection or a reset activation profile connection.
29 (41) HWI_PRUNTSEW	Requests to change or set the processor running time slice end wait processing. Note: The input connection token must only represent a CPC connection or a reset activation profile connection.
70 (112) HWI_DEFCAP	Requests to change or set the current defined capacity. Note: The input connection token must only represent an image connection or an image activation profile connection.
71 (113) HWI_SGPIPW	Requests to change or set the shared general processor initial processing weight (SGPIPW). Note: The input connection token must only represent an image connection or an image activation profile connection.
72 (114) HWI_SGPIPWCAP	Requests to change or set the SGPIPW to be capped or not capped. Note: The input connection token must only represent an image connection or an image activation profile connection.
73 (115) HWI_SGPPWMIN	Requests to change or set the minimum SGPPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
74 (116) HWI_SGPPWMAX	Requests to change or set the maximum SGPPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
77 (119) HWI_WLM	Requests to change or set whether WLM is allowed to change SGPPW values. Note: The input connection token must only represent an image connection or an image activation profile connection.
78 (120) HWI_IFAIPW	Requests to change or set the integrated facility for applications initial processing weight (IFAIPW). Note: The input connection token must only represent an image connection or an image activation profile connection.
79 (121) HWI_IFAIPWCAP	Requests to change or set the IFAIPW to be capped or not capped. Note: The input connection token must only represent an image connection or an image activation profile connection.
7A (122) HWI_IFAPWMIN	Requests to change or set the minimum IFAPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
7B (123) HWI_IFAPWMAX	Requests to change or set the maximum IFAPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
7E (126) HWI_IFLIPW	Requests to change or set the integrated facility for Linux initial processing weight (IFLIPW). Note: The input connection token must only represent an image connection or an image activation profile connection.
7F (127) HWI_IFLIPWCAP	Requests to change or set the IFLIPW to be capped or not capped. Note: The input connection token must only represent an image connection or an image activation profile connection.
80 (128) HWI_IFLPWMIN	Requests to change or set the minimum IFLPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
81 (129) HWI_IFLPWMAX	Requests to change or set the maximum IFLPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
84 (132) HWI_ICFIPW	Requests to change or set the internal coupling facility initial processing weight (ICFIPW). Note: The input connection token must only represent an image connection or an image activation profile connection.
85 (133) HWI_ICFIPWCAP	Requests to change or set the ICFIPW be capped or not capped. Note: The input connection token must only represent an image connection or an image activation profile connection.
86 (134) HWI_ICFPWMIN	Requests to change or set the minimum ICFPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
87 (135) HWI_ICFPWMAX	Requests to change or set the maximum ICFPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
8A (138) HWI_IIPIPW	Requests to change or set the integrated information processors initial processing weight (IIPIPW). Note: The input connection token must only represent an image connection or an image activation profile connection.
8B (139) HWI_IIPIPWCAP	Requests to change or set the IIPIPW be capped or not capped. Note: The input connection token must only represent an image connection or an image activation profile connection.
8C (140) HWI_IIPPWMIN	Requests to change or set the minimum IIPPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
8D (141) HWI_IIPPWMAX	Requests to change or set the maximum IIPPW value. Note: The input connection token must only represent an image connection or an image activation profile connection.
92 (146) HWI_GROUP_PROFILE_CAPACITY	Requests to change or set the workload unit capacity for the group profile associated with an image. Note: The input connection token must only represent an image connection. This attribute requires the target image be: On a z196 (zEnterprise) or higher CPC. A member of a LPAR (defined capacity) group. If both the above requirements are not met, the HWISET fails with RC=X'101' (HWI_COMMUNICATON_ERROR), with the DiagCommErr value set to X'15' (21) (HWMCA_DE_SNMP_ERROR).
C9 (201) HWI_IOCDS	Requests to change or set the IOCDS. Note: The input connection token must represent a reset activation profile.
CA (202) HWI_IPL_ADDRESS	Requests to change or set the IPL address. Note: The input connection token must represent an image activation profile or a load activation profile.
CB (203) HWI_IPL_PARM	Requests to change or set the IPL parameter. Note: The input connection token must represent an image activation profile or a load activation profile.
CC (204) HWI_IPL_TYPE	Requests to change or set the IPL type for the activation profile. Note: The input connection token must represent an image activation profile or a load activation profile.
CD (205) HWI_WW_PORTNAME	Requests to change or set the worldwide port name for the activation profile. Note: The input connection token must represent an image activation profile or a load activation profile.
CE (206) HWI_BOOT_PGM_SELECTOR	Requests to change or set the boot program selector for the activation profile. Note: The input connection token must represent an image activation profile or a load activation profile.
CF (207) HWI_LU_NUM	Requests to change or set the logical unit number value for the activation profile. Note: The input connection token must represent an image activation profile or a load activation profile.
D0 (208) HWI_BOOTREC_BLK_ADDR	Requests to change or set the boot record logical block address for the activation profile. Note: The input connection token must represent an image activation profile or a load activation profile.
D1 (209) HWI_OPSYS_LOADPARM	Requests to change or set the operating system specific load parameter. Note: The input connection token must represent an image activation profile or a load activation profile.
D2 (210) HWI_GROUP_PROF_NAME	Requests to change or set the name of the group capacity profile that is to be used for the CPC image or image object activated with this profile. Note: The input connection token must represent an image activation profile.
D3 (211) HWI_LOAD_AT_ACTIVATION	Requests to change or set the indicator if the CPC image object activated with this profile should be loaded (IPLed) at the end of the activation. Note: The input connection token must represent an image activation profile.
D4 (212) HWI_CENTRAL_STOR	Requests to change or set the initial amount of central storage (in megabytes) to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
D5 (213) HWI_RES_CENTRAL_STOR	Requests to change or set the reserved amount of central storage (in megabytes) to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
D6 (214) HWI_EXPANDED_STOR	Requests to change or set the initial amount of expanded storage (in megabytes) to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
D7 (215) HWI_RES_EXPANDED_STOR	Requests to change or set the reserved amount of expanded storage (in megabytes) to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
D8 (216) HWI_NUM_GPP	Requests to change or set the number of dedicated general purpose processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
D9 (217) HWI_NUM_RESGPP	Requests to change or set the number of reserved dedicated general purpose processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
DA (218) HWI_NUM_IFA	Requests to change or set the number of dedicated integrated facility for applications (IFA) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
DB (219) HWI_NUM_RESIFA	Requests to change or set the number of reserved dedicated integrated facility for applications (IFA) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
DC (220) HWI_NUM_IFL	Requests to change or set the number of dedicated integrated facility for Linux (IFL) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
DD (221) HWI_NUM_RESIFL	Requests to change or set the number of reserved dedicated integrated facility for Linux (IFL) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
DE (222) HWI_NUM_ICF	Requests to change or set the number of dedicated internal coupling facility (ICF) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
DF (223) HWI_NUM_RESICF	Requests to change or set the number of reserved dedicated internal coupling facility (ICF) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E0 (224) HWI_NUM_ZIIP	Requests to change or set the number of dedicated System z Integrated Information Processors (zIIPs) to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E1 (225) HWI_NUM_RESZIIP	Requests to change or set the number of reserved dedicated System z Integrated Information Processors (zIIPs) to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E2 (226) HWI_NUM_SHARED_GPP	Requests to change or set the number of shared general purpose processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E3 (227) HWI_NUM_RES_SHARED _GPP	Requests to change or set the number of reserved shared general purpose processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E4 (228) HWI_NUM_SHARED_IFA	Requests to change or set the number of shared integrated facility for applications (IFA) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E5 (229) HWI_NUM_RES_SHARED_IFA	Requests to change or set the number of reserved shared integrated facility for applications (IFA) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E6 (230) HWI_NUM_SHARED_IFL	Requests to change or set the number of shared integrated facility for Linux (IFL) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E7 (231) HWI_NUM_RES_SHARED_IFL	Requests to change or set the number of reserved shared integrated facility for Linux (IFL) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E8 (232) HWI_NUM_SHARED_ICF	Requests to change or set the number of shared internal coupling facility (ICF) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
E9 (233) HWI_NUM_RES_SHARED _ICF	Requests to change or set the number of reserved shared internal coupling facility (ICF) processors to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
EA (234) HWI_NUM_SHARED_ZIIP	Requests to change or set the number of shared System z Integrated Information Processors (zIIPs) to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
EB (235) HWI_NUM_RES_SHARED _ZIIP	Requests to change or set the number of reserved shared System z Integrated Information Processors (zIIPs) to be used for the CPC image object activated with this profile. Note: The input connection token must represent an image activation profile.
EC (236) HWI_BASIC_CPU_AUTH _COUNT_CNTL	Requests to change or set the enablement value of the basic CPU counter facility for the CPC image object activated with this profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
ED (237) HWI_PROBSTATE_CPU _AUTH_COUNT_CNTL	Requests to change or set the enablement value of the Problem state CPU counter facility for the CPC image object activated with this profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
EE (238) HWI_CRYPTOACTIVITY_CPU _AUTH_COUNT_CNTL	Requests to change of set the enablement value of the crypto activity CPU counter facility for the CPC image object activated with this profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
EF (239) HWI_EXTENDED_CPU _AUTH_COUNT_CNTL	Requests to change or set the enablement value of the extended CPU counter facility for the CPC image object activated with this profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
F0 (240) HWI_COPROCESSOR_CPU _AUTH_COUNT_CNTL	Requests to change or set the enablement value of the coprocessor group CPU counter facility for the CPC image object activated with this profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
F1 (241) HWI_BASIC_CPU_SAMPLING _AUTH_CNTL	Requests to change or set the enablement value of the basic CP CPU sampling facility for the CPC image object activated with this profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
F2 (242) HWI_APROF_STORE_STATUS	Requests to change or set the store status function value. This value is only valid if HWI_APROF_LOADTYPE is set to normal. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent a load activation profile.
F3 (243) HWI_APROF_LOADTYPE	Requests to change or set the type of load being requested. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent a load activation profile.
F4 (244) HWI_PROFILE_DESCRIPTION	Requests to change or set the activation profile description. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
F5 (245) HWI_PROFILE_PARTITION_ID	Requests to change or set the partition identifier for the activation profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
F6 (246) HWI_OPERATING_MODE	Requests to change or set the operating mode value for the activation profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
F7 (247) HWI_CLOCK_TYPE	Requests to change or set the clock type assignment (time source setting) for the activation profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
F8 (248) HWI_TIME_OFFSET_DAYS	Requests to change or set the time offset days (the number of days currently set as the offset from the external time source's time of day) for the activation profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
F9 (249) HWI_TIME_OFFSET_HOURS	Requests to change or set the time offset hours (the number of hours currently set as the offset from the external time source's time of day) for the activation profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
FA (250) HWI_TIME_OFFSET_MINUTES	Requests to change or set the time offset minutes (the number of minutes currently set as the offset from the external time source's time of day) for the activation profile. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
FB (251) HWI_TIME_OFFSET_INCREASE	Requests to change or set the time offset increase or decrease value for the activation profile. The time offset, as specified in days, hours, and minutes, is increased or decreased from GMT. TRUE means that the time offset is east of GMT. FALSE means that the time offset is west of GMT. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
FC (252) HWI_LICCC_VALIDATION _ENABLED	Requests to change or set whether the activation profile must conform to the current Licensed Internal Code Configuration Control (LICCC) configuration. This attribute is only available when targeting a zEnterprise or higher CPC. Note: The input connection token must represent an image activation profile.
FD (253) HWI_GLOBAL_PERFORMANCE _DATA_CONTROL	Requests to change or set whether the logical partition can be used to view the processing unit activity data for all other LPARs activated on the same CPC. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
FE (254) HWI_IO_CONFIGURATION _CONTROL	Requests to change or set whether the logical partition can be used to read and write any Input/Output Configuration Data Set (IOCDS) in the configuration. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
100 (256) HWI_LOGICAL_PARTITION _ISOLATION	Requests to change or set whether reconfigurable channel paths assigned to the logical partition are reserved for its exclusive use. This attribute is only available when targeting a z10 or higher CPC. Note: The input connection token must represent an image activation profile.
101-109 (257–264) RESERVED	Reserved for activation profile attributes.

SetTypeValue_Ptr (non-REXX)

SetTypeValue (REXX)

Supplied parameter

Type: Pointer (non-REXX), character or character representation of an integer (REXX)
Length: 4 bytes (non-REXX)

Non-REXX:: SetTypeValue_Ptr specifies address of the value to be set or changed.
REXX:: SetTypeValue specifies the value to be set or changed.

The particular SetType determines what data value must be specified. See the chart below as well as the following documentation for more information:

System z Application Programming Interfaces (SB10-7030-13)
System z10 and eServer zSeries Application Programming Interfaces (SB10-7030-09)
System z9 and eServer zSeries Application Programming Interfaces (SB10-7030-08)

SetTypes

Values to be specified

(6)

HWI_ACCSTAT

A 4-byte integer type value.

For CPC connections, bit values can be set to:

HWMCA_STATUS_OPERATING
HWMCA_STATUS_NOT_OPERATING
HWMCA_STATUS_NO_POWER
HWMCA_STATUS_EXCEPTIONS
HWMCA_STATUS_STATUS_CHECK
HWMCA_STATUS_SERVICE
HWMCA_STATUS_LINKNOTACTIVE
HWMCA_STATUS_POWERSAVE
HWMCA_STATUS_SERVICE_REQ
HWMCA_STATUS_DEGRADED

For image connections, bit values can be set to:

HWMCA_STATUS_OPERATING
HWMCA_STATUS_NOT_OPERATING
HWMCA_STATUS_NOT_ACTIVATED
HWMCA_STATUS_EXCEPTIONS
HWMCA_STATUS_STATUS_CHECK
HWMCA_STATUS POWERSAVE

(7)

HWI_APROF

A 16-character activation profile name padded with trailing blanks.

(39)

HWI_PRUNTYPE

A 4-byte integer type value.

HWMCA_DETERMINED_SYSTEM: The processor running is dynamically determined by the system.
HWMCA_DETERMINED_USER: The processor running time is set to a constant value.

(40)

HWI_PRUNTIME

A 4-byte integer type value.

A value between 1 to 100 for the user defined processor running time.

Note: This value can only be set if the processor running time type (HWI_PRUNTYPE) is set to HWMCA_DETERMINED_USER.

(41)

HWI_PRUNTSEW

A 4-byte integer type value.

HWMCA_TRUE: Indicates that an image should lose its share of running time when it enters a wait state.
HWMCA_FALSE: Indicates that an image should not lose its share of running time when it enters a wait state.

Note: This value can only be set if the processor running time type (HWI_PRUNTYPE) is set to HWMCA_DETERMINED_USER.

(112)

HWI_DEFCAP

A 4-byte integer type value.

A value represents the amount of defined capacity specified for the logical partition. A value of 0 indicates that no defined capacity is specified for the logical partition.

(113)

HWI_SGPIPW

A 4-byte integer type value.

A value from 1 - 999 defines the relative amount of shared general purpose processor resources allocated to the CPC image object.

A value of 0 indicates that CPC image does not represent a logical partition or the CPC image does not represent a logical partition with at least one not dedicated general purpose processor.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated general purpose processor.

(114)

HWI_SGPIPWCAP

A 4-byte integer type value. This indicates that the initial general purpose processor processing weight for the CPC image object is capped or not capped.

HWMCA_TRUE: Capped
HWMCA_FALSE: Not capped

(115)

HWI_SGPPWMIN

A 4-byte integer type value.

A value from 1 - 999 and less than or equal to the initial processing weight defines the minimum relative amount of shared general purpose processor resources allocated to the CPC image object.

A value of 0 indicates that CPC image does not represent a logical partition or the CPC image does not represent a logical partition with at least one not dedicated general purpose processor.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated general purpose processor.

(116)

HWI_SGPPWMAX

A 4-byte integer type value.

A value from 1 - 999 and greater than or equal to the initial processing weight defines the maximum relative amount of shared general purpose processor resources allocated to the CPC image object.

A value of 0 indicates that CPC image does not represent a logical partition or the CPC image does not represent a logical partition with at least one not dedicated general purpose processor.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated general purpose processor.

(119)

HWI_WLM

A 4-byte integer type value.

This indicates whether the Workload Manager is allowed to change processor weight-related attributes.

HWMCA_TRUE
HWMCA_FALSE

HWI_WLM must be set to HWMCA_TRUE before any of the settings for the specialized IFA, IFL, ICF, or IIP engines can be modified.

(120)

HWI_IFAIPW

A 4-byte integer type value.

A value from 1 - 999 defines the relative amount of shared integrated facility for applications (IFA) processor resources allocated to the CPC image object.

A value of 0 indicates that CPC image does not represent a logical partition or the CPC image does not represent a logical partition with at least one not dedicated integrated facility for applications (IFA) processor.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated facility for applications (IFA) processor.

(121)

HWI_IFAIPWCAP

A 4-byte integer type value. This indicates whether the initial processing weight for integrated facility for applications (IFA) processors is a limit or a target.

HWMCA_TRUE: Capped
HWMCA_FALSE: Not capped

(122)

HWI_IFAPWMIN

A 4-byte integer type value.

A value from 1 - 999 defines the minimum relative amount of shared integrated facility for applications (IFA) processor resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated facility for applications (IFA) processor.

(123)

HWI_IFAPWMAX

A 4-byte integer type value.

A value from 1 - 999 defines the maximum relative amount of shared integrated facility for applications (IFA) processor resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated facility for applications (IFA) processor.

(126)

HWI_IFLIPW

A 4-byte integer type value.

A value from 1 - 999 defines the relative amount of shared integrated facility for Linux (IFL) processor resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated facility for Linux (IFL) processor.

(127)

HWI_IFLIPWCAP

A 4-byte integer type value. This indicates whether the initial processing weight for integrated facility for Linux (IFL) processors is a limit or a target.

HWMCA_TRUE: Capped
HWMCA_FALSE: Not capped

(128)

HWI_IFLPWMIN

A 4-byte integer type value.

A value from 1 - 999 defines the minimum relative amount of shared integrated facility for Linux (IFL) processor resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated facility for Linux (IFL) processor.

(129)

HWI_IFLPWMAX

A 4-byte integer type value.

A value from 1 - 999 defines the maximum relative amount of shared integrated facility for Linux (IFL) processor resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated facility for Linux (IFL) processor.

(132)

HWI_ICFIPW

A 4-byte integer type value.

A value from 1 - 999 defines the relative amount of shared internal coupling facility (ICF) processor resources allocated to the CPC image object.

A value of 0 indicates that CPC image does not represent a logical partition or the CPC image does not represent a logical partition with at least one not dedicated internal coupling facility (ICF) processor.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated internal coupling facility (ICF) processor.

(133)

HWI_ICFIPWCAP

A 4-byte integer type value. This indicates whether the initial processing weight for internal coupling facility (ICF) processors is a limit or a target.

HWMCA_TRUE: Capped
HWMCA_FALSE: Not capped

(134)

HWI_ICFPWMIN

A 4-byte integer type value.

A value from 1 - 999 defines the minimum relative amount of shared internal coupling facility (ICF) processor resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated internal coupling facility (ICF) processor.

(135)

HWI_ICFPWMAX

A 4-byte integer type value.

A value from 1 - 999 defines the maximum relative amount of shared internal coupling facility (ICF) processor resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated internal coupling facility (ICF) processor.

(138)

HWI_IIPIPW

A 4-byte integer type value.

A value from 1 - 999 defines the relative amount of shared integrated information processors (IIP) resources allocated to the CPC image object.

A value of 0 indicates that CPC image does not represent a logical partition or the CPC image does not represent a logical partition with at least one not dedicated integrated information processor (IIP).

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated information processor (IIP).

(139)

HWI_IIPIPWCAP

A 4-byte integer type value. This indicates whether the initial processing weight for integrated information processors (IIP) is a limit or a target.

HWMCA_TRUE: Capped
HWMCA_FALSE: Not capped

(140)

HWI_IIPPWMIN

A 4-byte integer type value.

A value from 1 - 999 defines the minimum relative amount of shared integrated information processors (IIP) resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated information processor (IIP).

(141)

HWI_IIPPWMAX

A 4-byte integer type value.

A value from 1 - 999 defines the maximum relative amount of shared integrated information processors (IIP) resources allocated to the CPC image object.

Note: The setting of this attribute is only valid for CPC image objects that represent a logical partition with at least one not dedicated integrated information processor (IIP).

(146)

HWI_GROUP_PROFILE_CAPACITY

A 4-byte integer value to represent the workload unit capacity for the group profile associated with an image.

(201)

HWI_IOCDS

A character string representing the IOCDS.

A value of an empty string indicates that the reset activation profile will use the currently active IOCDS.

(202)

HWI_IPL_ADDRESS

A character string representing the IPL address.

Note: A value of an empty string indicates that the image activation profile uses the next IPL address set by HCD.

(203)

HWI_IPL_PARM

A character string representing the IPL parameter.

Note: A value of an empty string indicates that the image activation profile uses the next IPL parameter set by HCD.

(204)

HWI_IPL_TYPE

A 4-byte integer type value.

HWMCA_IPLTYPE_STANDARD: Indicates that the image activation profile is used to perform a standard load.
HWMCA_IPLTYPE_SCSI: Indicates that the image activation profile is used to perform a SCSI load.
HWMCA_IPLTYPE_SCSIDUMP: Indicates that the image activation profile is used to perform a SCSI dump.

(205)

HWI_WW_PORTNAME

A character string representing the worldwide port name.

(206)

HWI_BOOT_PGM_SELECTOR

A 4-byte integer type value representing the boot program selector value.

(207)

HWI_LU_NUM

A character string representing the logical unit number.

(208)

HWI_BOOTREC_BLK_ADDR

A character string representing the boot record logical block address.

(209)

HWI_OPSYS_LOADPARM

A character string representing the operating system specific load parameters.

(210)

HWI_GROUP_PROF_NAME

A character string that represents the name of a group capacity profile.

(211)

HWI_LOAD_AT_ACTIVATION

A 4-byte integer type value.

This indicates whether a load should be done at the end of activation.

HWMCA_TRUE
HWMCA_FALSE

(212)

HWI_CENTRAL_STOR

A 4-byte integer type value to represent the initial amount of central storage (in megabytes) to be used for the CPC image.

(213)

HWI_RES_CENTRAL_STOR

A 4-byte integer type value to represent the reserved amount of central storage (in megabytes) to be used for the CPC image.

(214)

HWI_EXPANDED_STOR

A 4-byte integer type value to represent the initial amount of expanded storage (in megabytes) to be used for the CPC image.

(215)

HWI_RES_EXPANDED_STOR

A 4-byte integer type value to represent the reserved amount of expanded storage (in megabytes) to be used for the CPC image.

(216)

HWI_NUM_GPP

A 4-byte integer type value to represent the number of dedicated general purpose processors to be used for the CPC image.

(217)

HWI_NUM_RESGPP

A 4-byte integer type value to represent the number of reserved dedicated general purpose processors to be used for the CPC image.

(218)

HWI_NUM_IFA

A 4-byte integer value to represent the number of dedicated integrated facility for applications (IFA) processors to be used for the CPC image.

(219)

HWI_NUM_RESIFA

A 4-byte integer value to represent the number of reserved dedicated integrated facility for applications (IFA) processors to be used for the CPC image.

(220)

HWI_NUM_IFL

A 4-byte integer value to represent the number of dedicated integrated facility for Linux (IFL) processors to be used for the CPC image.

(221)

HWI_NUM_RESIFL

A 4-byte integer value to represent the number of reserved dedicated integrated facility for Linux (IFL) processors to be used for the CPC image.

(222)

HWI_NUM_ICF

A 4-byte integer value to represent the number of dedicated internal coupling facility (ICF) processors to be used for the CPC image.

(223)

HWI_NUM_RESICF

A 4-byte integer value to represent the number of reserved dedicated internal coupling facility (ICF) processors to be used for the CPC image.

(224)

HWI_NUM_ZIIP

A 4-byte integer value to represent the number of dedicated System z Integrated Information Processors (zIIPs) to be used for the CPC image.

(225)

HWI_NUM_RESZIIP

A 4-byte integer value to represent the number of reserved dedicated System z Integrated Information Processors (zIIPs) to be used for the CPC image.

(226)

HWI_NUM_SHARED_GPP

A 4-byte integer type value to represent the number of shared general purpose processors to be used for the CPC image.

(227)

HWI_NUM_RES_SHARED_GPP

A 4-byte integer type value to represent the number of reserved shared general purpose processors to be used for the CPC image.

(228)

HWI_NUM_SHARED_IFA

A 4-byte integer value to represent the number of shared integrated facility for applications (IFA) processors to be used for the CPC image.

(229)

HWI_NUM_RES_SHARED_IFA

A 4-byte integer value to represent the number of reserved shared integrated facility for applications (IFA) processors to be used for the CPC image.

(230)

HWI_NUM_SHARED_IFL

A 4-byte integer value to represent the number of shared integrated facility for Linux (IFL) processors to be used for the CPC image.

(231)

HWI_NUM_RES_SHARED_IFL

A 4-byte integer value to represent the number of reserved shared integrated facility for Linux (IFL) processors to be used for the CPC image.

(232)

HWI_NUM_SHARED_ICF

A 4-byte integer value to represent the number of shared internal coupling facility (ICF) processors to be used for the CPC image.

(233)

HWI_NUM_RES_SHARED_ICF

A 4-byte integer value to represent the number of reserved shared internal coupling facility (ICF) processors to be used for the CPC image.

(234)

HWI_NUM_SHARED_ZIIP

A 4-byte integer value to represent the number of shared System z Integrated Information Processors (zIIPs) to be used for the CPC image.

(235)

HWI_NUM_RES_SHARED_ZIIP

A 4-byte integer value to represent the number of reserved shared System z Integrated Information Processors (zIIPs) to be used for the CPC image.

(236)

HWI_BASIC_CPU_AUTH_COUNT_CNTL

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: The authorization control is enabled.
HWMCA_FALSE: The authorization control is disabled.

(237)

HWI_PROBSTATE_CPU_AUTH_COUNT

_CNTL

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: The authorization control is enabled.
HWMCA_FALSE: The authorization control is disabled.

(238)

HWI_CRYPTOACTIVITY_CPU_AUTH

_COUNT_CNTL

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: The authorization control is enabled.
HWMCA_FALSE: The authorization control is disabled.

(239)

HWI_EXTENDED_CPU_AUTH_COUNT

_CNTL

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: The authorization control is enabled.
HWMCA_FALSE: The authorization control is disabled.

(240)

HWI_COPROCESSOR_CPU_AUTH

_COUNT_CNTL

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: The authorization control is enabled.
HWMCA_FALSE: The authorization control is disabled.

(241)

HWI_BASIC_CPU_SAMPLING_AUTH

_CNTL

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: The authorization control is enabled.
HWMCA_FALSE: The authorization control is disabled.

(242)

HWI_APROF_STORE_STATUS

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: Store status is selected. Only allowed if HWI_APROF_LOADTYPE is set to HWMCA_LOADTYPE_NORMAL.
HWMCA_FALSE: Store status is not selected.

(243)

HWI_APROF_LOADTYPE

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_LOADTYPE_NORMAL: The Loadtype is set to normal.
HWMCA_LOADTYPE_CLEAR: The Loadtype is set to clear.

(244)

HWI_PROFILE_DESCRIPTION

A 50-character activation profile description. This attribute is only available when targeting a z10 or higher CPC.

(245)

HWI_PROFILE_PARTITION_ID

A 4-byte integer type decimal value ranging from 0 to 63. This attribute is only available when targeting a z10 or higher CPC.

(246)

HWI_OPERATING_MODE

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_ESA390_OPERATING_MODE
HWMCA_ESA390TPF_OPERATING_MODE
HWMCA_CF_OPERATING_MODE
HWMCA_LINUX_OPERATING_MODE
HWMCA_FMEX_OPERATING_MODE
HWMCA_HMEX_OPERATING_MODE
HWMCA_HMAS_OPERATING_MODE
HWMCA_ZVM_OPERATING_MODE

(247)

HWI_CLOCK_TYPE

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_CLOCK_TYPE_STANDARD
HWMCA_CLOCK_TYPE_LPAR

(248)

HWI_TIME_OFFSET_DAYS

A 4-byte integer type decimal value ranging from 0 - 999. This attribute is only available when targeting a z10 or higher CPC.

(249)

HWI_TIME_OFFSET_HOURS

A 4-byte integer type decimal value ranging from 0 - 23. This attribute is only available when targeting a z10 or higher CPC.

(250)

HWI_TIME_OFFSET_MINUTES

A 4-byte integer type decimal value. Possible values are 0, 15, 30 or 45. This attribute is only available when targeting a z10 or higher CPC.

(251)

HWI_TIME_OFFSET_INCREASE

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: The local time zone is east of GMT.
HWMCA_FALSE: The local time zone is west of GMT.

(252)

HWI_LICCC_VALIDATION_ENABLED

A 4-byte integer type value. This attribute is only available when targeting a zEnterprise or higher CPC.

HWMCA_TRUE: Activation profile must conform to the current LICCC configuration.
HWMCA_FALSE: Activation profile is not required to conform to the current LICCC configuration.

(253)

HWI_GLOBAL_PERFORMANCE

_DATA_CONTROL

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: Global performance data control is enabled.
HWMCA_FALSE: Global performance data control is disabled.

(254)

HWI_IO_CONFIGURATION

_CONTROL

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: I/O configuration control is enabled.
HWMCA_FALSE: I/O configuration control is disabled.

100

(256)

HWI_LOGICAL_PARTITION

_ISOLATION

A 4-byte integer type value. This attribute is only available when targeting a z10 or higher CPC.

HWMCA_TRUE: Logical partition isolation control is enabled.
HWMCA_FALSE: Logical partition isolation control is disabled.

SetTypeValueLen (non-REXX)

Supplied parameter

Type: Integer
Length: 4 bytes

SetTypeValueLen specifies the length in bytes of the SetTypeValue pointed to by the SetTypeValue_Ptr parameter.

DiagArea (non-REXX)

DiagArea. (REXX)

Returned parameter

Type: Character string (non-REXX), stem variable (REXX)
Length: 32 bytes (non-REXX)

DiagArea contains diagnostic data to help determine the cause of a failure from the service. For many return codes, the DiagArea can contain further information to help determine the cause of the failure. See the descriptions of different return codes for a partial list of data returned in this area.

Note: For all environmental errors (with return code X'F00' and higher), the DiagArea might not be filled in, and the data returned in the area should be ignored.

Field Name (non-REXX) / Tail name constant of the user-defined DiagArea stem (REXX)	Field Type (non-REXX)	Description
Diag_Index	32-bit integer	The array index to the parameter field that causes the error.
Diag_Key	32-bit integer	The constant value represents the field that causes the error.
Diag_Actual	32-bit integer	The incorrect actual value specified.
Diag_Expected	32-bit integer	The expected value to be used.
Diag_CommErr	32-bit integer	The returned code that is returned from the Console Application API or the BCPii transport layer.
Diag_Text	Character (12)	Reserved.

See BCPii communication error reason codes for a partial list of the descriptive communication transport error return codes and suggested actions.