Workgroup Information Item Descriptions

Purge Pending? (B) Put: No; Verify: Yes

Returns a boolean value denoting whether a purge is pending for the indicated workgroup. When a workgroup is purged, the Workload Manager will need to rescan the affected member processes.

Logon/User specification (CA256) Put: No; Verify: Yes

Returns the logon category of the specified workgroup. The logon membership criteria specifies the job/session, user and account name (LOGON = [job/sessionname,]username.accountname) of potential workgroup members. The job/session name is optional, but if specified, the logon must be enclosed in double quotes (" "). The user and account name are required. Wildcarding is supported. The @ symbol specifies zero or more alphanumeric characters. For example:

"SUSAN,MANAGER.SYS", GUEST.SYS, ACCNTING,@.SYS

The logon/user specification is left justified and terminated by a NULL character. "@,@.@" represents all logons on the system.

Program/File name (REC) Put: No; Verify: Yes

Returns the program file category of the specified workgroup. The program membership criteria specifies the program files of potential workgroup members. The filename must be a fully qualified MPE/iX file name or absolute Hierarchichal File System (HFS) name. Wildcarding is supported. The @ symbol specifies zero or more alphanumeric characters. The # symbol specifies one numeric character. For example:

EDITOR.PUB.SYS, HPEDIT#.@.@

The name must be left-justified. The length of the item passed must be specified in the length field of the pathname_type record. @.@.@ represents all files on the system.

Record Type: pathname_type. The maximum size of n which is user-defined is 512.

Queue (CA20) Put:No; Verify: Yes

Returns the queue category of the specified workgroup. The queue membership criteria specifies the queue attribute of potential workgroup members. Five values are supported, AS, BS, CS, DS, and ES. For example:

DS, ES

The queue is left justified and terminated by a NULL character.

Base priority (I32) Put: Yes; Verify: Yes

Returns or modifies the base priority of the specified workgroup. This value is the highest priority that any process which is a member of this workgroup can have. Can modify for any user-defined workgroups, or the CS_Default, DS_Default, and ES_Default workgroups; cannot modify the AS_Default or BS_Default workgroups. It can be set by the NEWWG or ALTWG commands for all workgroups except AS_Default and BS_Default workgroup. It can also be set by TUNE command for CS_Default, DS_Default or ES_Default workgroup. This priority can be mapped to MPE V by the following formula:

MPEVPri = (32767 - MPE/iXPri) DIV 128 (All formula values are decimal.)

Base priority is a required item for addition of a new workgroup.

Limit priority (I32) Put: Yes; Verify: Yes

Returns or modifies the limit priority of the specified workgroup. This value is the lowest priority that any process which is a member of this workgroup can have. Can modify for any user-defined workgroups, or the CS_Default, DS_Default, and ES_Default workgroups; cannot modify the AS_Default or BS_Default workgroups. It can be set by the NEWWG or ALTWG commands for all workgroups except AS_Default and BS_Default workgroup. It can also be set by TUNE command for CS_Default, DS_Default or ES_Default workgroup. This priority can be mapped to MPE V by the following formula:

MPEVPri = (32767 - MPE/iXPri) DIV 128 (All formula values are decimal.)

Limit priority is a required item for addition of a new workgroup.

Minimum Quantum (I32) Put: Yes; Verify: Yes

Returns or modifies the minimum number of milliseconds of CPU consumption that is used to determine priority decay for processes within the specified workgroup. Can modify for any user-defined workgroups, or the CS_Default, DS_Default, and ES_Default workgroups; does not exist for the AS_Default or BS_Default workgroups. It can also be set by the TUNE, NEWWG, or ALTWG commands.

Values for minimum quantum range from 0 to 32767 milliseconds. The default value is 1 milliseconds for CS_Default workgroup and user-defined workgroups. The default value for DS_Default and ES_Default workgroups is 2000.

Maximum Quantum (I32) Put: Yes; Verify: Yes

Returns or modifies the maximum number of milliseconds of CPU consumption that is used to determine priority decay for processes within the specified workgroup. Can modify for any user-defined workgroups, or the CS_Default, DS_Default, and ES_Default workgroups; does not exist for the AS_Default or BS_Default workgroups. It can also be set by the TUNE, NEWWG, or ALTWG commands.

Values for maximum quantum range from 0 to 32767 milliseconds. The default value is 2000 milliseconds for.

Timeslice (I32) Put: Yes; Verify: Yes

Returns or modifies the maximum amount of CPU time that can be consumed by a member of the specified workgroup before being timesliced (yielding the CPU). This value is accurate to 100-millisecond granularity and has a minimum value of 100 milliseconds. Can modify for any user-defined workgroups, or the CS_Default, DS_Default, and ES_Default workgroups; cannot modify for the AS_Default or BS_Default workgroups. It can also be set by the TUNE, NEWWG, or ALTWG commands.

Values for timeslice range from 100 to 32700 and default value is 200 milliseconds CS_Default, DS_Default, ES_Default and user-defined workgroups. The default value for AS_Default and BS_Default workgroups is 1000.

Boost Property (I32) Put: Yes; Verify: Yes

Returns or modifies the boost property of the workgroup (decay or oscillate). Can modify for any user-defined workgroups, or the CS_Default, DS_Default, and ES_Default workgroups; does not exist for the AS_Default or BS_Default workgroups. It can also be set by the TUNE, NEWWG, or ALTWG commands. Values and their meanings are as follows:

Maximum CPU Percentage (I32) Put: Yes; Verify: Yes

Returns or modifies the upper bound for the amount of CPU the processes in a workgroup can consume relative to to other workgroups. Can modify for any user-defined workgroups, or the CS_Default, DS_Default, and ES_Default workgroups; does not exist for the AS_Default or BS_Default workgroups. It can also be set by the TUNE, NEWWG, or ALTWG commands.

The value can range from 0% to 100%. The default value is 100%. The maximum CPU percentage control may result in system idling if the workgroup hits its maximum CPU percentage and there are no other users who want CPU.

Minimum CPU Percentage (I32) Put: Yes; Verify: Yes

Returns or modifies the lower bound for the amount of CPU the processes in a workgroup can consume relative to to other workgroups. Can modify for any user-defined workgroups, or the CS_Default, DS_Default, and ES_Default workgroups; does not exist for the AS_Default or BS_Default workgroups. It can also be set by the TUNE, NEWWG, or ALTWG commands.

The value can range from 0% to 100%. The default value is 0%. Note that CPU consumption of the workgroup may not precisely match the specified the minimum CPU percentage if there is insufficient demand within the workgroup.

Quantum (I32) Put: No; Verify: No

Returns the average number of milliseconds that a process in the workgroup executes before it is interrupted. It is used to decide when a process in that workgroup should have its priority decayed. It is maintained dynamically by the system and is very transient in nature.