iCap PAS started task parameters

The following table describes the started task parameters for the iCap master and agent PASs.
When you customize the product, you create JCL for the master and agent PASs that contains started task parameters for the iCap PAS.

Related topic

Starting the iCap master PAS

You can edit the started task parameters directly in the JCL, or accept the default values. In addition, you can override some of the started task parameters when you execute the START command. For more information, see Starting-the-iCap-master-PAS and Starting-the-iCap-agent-PAS.

Important

Specifying an invalid parameter or parameter value will cause the PAS to terminate with an error message. In some cases, specifying an invalid combination of parameters will cause the PAS to issue a warning but continue running as an agent.

Also, note that you must specify values for all of the parameters that have no default value.

Parameter	Default value	Can you override the default in the START command?	Description
ADJTIME=nn	1 or numberOfManagedCPCs	No	How often (in minutes) to run the assessor iCap makes changes to the IBM Hardware Management Console (HMC) via the IBM Base Control Program internal interface (BCPii) each time that iCap adjusts the defined capacity of an LPAR or GCLs. These changes are time-consuming, and access to the HMC is limited while the changes are being processed. The processing time can also increase based on the number of LPARS and groups thatiCap is managing. By using ADJTIME, you can specify the time interval for the assessor to run based on the number of LPARs and groups that iCap is managing, therefore reducing the amount of time that HMC access is limited. Important By default, the master PAS JCL does not include the ADJTIME parameter; and the default ADJTIME= 1 automatically applies. If you want to specify a different value for ADJTIME, add the parameter to the master PAS JCL. If you are running in message mode, ADJTIME is ignored. To determine the best value for your site, use the following equation: ((<numberOfManagedLparsAndGroups> x 4) + <HMCavailableTimeRequired>) ÷ 60 (seconds) numberOfManagedLparsAndGroups is the total number of LPARs and groups on all CPCs that you plan to manage with iCap. The value 4 is the approximate time that it takes per LPAR or group for the BCPii interface to access the HMC. HMCavailableTimeRequired is the required time (in seconds) needed for HMC availability. Important If the answer is a decimal number, round up to the nearest integer. Valid values are 1 through 10. In the following example, iCap is managing 30 LPARs and groups, and the required time is 60 seconds: ((30 x 4) + 60) ÷ 60 = 3 Therefore, ADJTIME is set to 3, and the assessor runs at 3-minute intervals.
CMP={Y\|N}	Y	No	Whether iCap is managing multiple CPCs in a CountryWide Multiplex (CMP) environment This value indicates whether iCap should search for LPARs over the entire CMP, or only the local CPC. Tip If you are managing LPARs on the local CPC only, specifying CMP=N reduces the start-up time by limiting the search to the local CPC.
CON=context	cpcID	No	Context for the master and agent PASs that you want iCap to manage If you want to manage multiple CPCs, do not use the default value. For more information, see Specifying-the-context-for-master-and-agent-PASs.
PASMODE={OBSERVE\|MSG\|MANAGE}	OBSERVE	Yes	Mode in which you want to run iCap Important To run the product in message mode, you can specify either MSG or MESSAGE. For more information, see iCap-modes.
POLICY=policyName	NO-POLICY	Yes	Name of the policy (up to eight characters long) If running the product in message or manage mode, you must specify a policy name; otherwise, the PAS will terminate. For observe mode, a policy is not required.
RESTORE={YES\|NO\|ZERO\|ENT}	YES	No	Whether iCap should restore DCs and GCLs when the PAS terminates Possible values are: YES restores DCs and GCLs to the values they had when the master PAS initialized. NO leaves DCs and GCLs as they were when iCap stopped managing the LPAR or group, or the PAS terminated. ZERO sets DCs to 0 and GCLs to the value they had when the PAS initialized. ENT sets the DC and GCL values based on entitlement: For LPARs, iCap sets the DC according to the LPAR's entitlement level. For groups, iCap sets the GCL according to the group's entitlement level. For group members that are being managed individually, iCap sets the GCL to the sum of the individual members' entitlements. Important The DC of each group member is set to MAXDCGCL, or to 0 if you did not specify MAXDCGCL. (BMC.AMIOPS.SPE2204) POL restores DCs and GCLs to the values defined for LPARs and groups in the policy. For more information, see the description of the Restore parameter in LPAR-level-and-group-level-parameters. For more information, see Changing-the-RESTORE-parameter and Examples-of-how-RESTORE-affects-DCs-and-GCLs.
SSID=ssid	BBCS	Yes	Subsystem ID of the coordinating address space (CAS) to which the iCap PAS should connect The maximum length is four characters. The CAS is started as a separate address space from the iCap PAS. For a PAS to connect to a CAS, the SSID values in the CAS and PAS startup procedures must be the same. Warning Ensure that DISCO=NO is not specified in the CAS. Specifying this value generates a large number of error messages in the PAS.
SRVCLASS={SYSSTC\|WLM-RULE}	SYSSTC	No	Whether the service class is set by the WLM policy or SYSSTC Important BMC recommends that the master PAS use the default value, SYSSTC.
TYPE={MASTER\|AGENT}	AGENT	Yes	Whether the LPAR or capacity group will run as a master or an agent Important You should have only one master PAS in an iCap environment. For more information, see Policy-guidelines.
XDM= {Y\|N}	N	No	Whether the master PAS should execute in extended diagnostic mode (XDM), which produces additional messages and suspends some PAS error recovery processing Warning Specify Y only if BMC Customer Support instructs you to do so. The XDM parameter disables some error-recovery mechanisms, which could severely impact your system.

iCap PAS started task parameters

On this page