IWMCQRY – Querying Classification Attributes

The Query Active Classification Rules routine is given control from the IWMCQRY macro. The Query Active Classification Rules macro will complete the parameter list with caller provided data and generate a stacking, space switching, program call to the query service.

The purpose of this routine is to return a representation of the classification rules that are associated with the active policy that is in effect for the sysplex. The data returned by this service describes the installation-defined rules that determine how incoming work is assigned a service class and/or report class by MVS™.

The classification rule data returned by this service is mapped by macro IWMSVDCR. This macro is also used to map the classification rules associated with the WLM service definition. As a result, some data sections in this mapping will not be available (filled in) when it is obtained via this service. An example of some of the information that will not be available, are the timestamps indicating when a classification GROUP was last updated and by whom. For a complete list of fields that will not be available refer to the field comments in macro IWMSVDCR.

The classification rules can be used in conjunction with the active service policy to determine what performance goals will be associated with incoming work. The performance goals for a service class are contained within service policy mapping returned by the IWMPQRY service.

The information returned is not serialized upon return to the caller, and so may be out-of-date if a modified service definition was installed and a new policy activated.

The caller can optionally request that the identifier of the active policy that these classification rules are part of, be returned in an area specified by the POLICY_ID keyword. The caller can then compare the policy identification information returned with the policy data returned by the IWMPQRY macro to ensure they are in synch.

The Query Active Classification Rules macro is provided in list, execute, and standard form. The list form accepts no variable parameters and is used only to reserve space for the query parameter list. The standard form is provided for use with routines which do not require reentrant code. The execute form is provided for use with the list format for reentrant routines.

The parameter list must be in the caller's primary address space or be addressable by the dispatchable unit access list.