MSO Load Balancing Configuration Parameters

MSO Load Balancing provides the capability of grouping multiple MSO regions into a logical entity. Dividing the MSO Load Balancing group into subgroups is also possible. This mapping of a MSO Load Balancing group of MVS regions and routing of users into one or more regions within this group is done through the specification of three parameters.

APPLGROUP = MSO_group_name

where:

MSO_group_name

This specification activates the Load Balancing function. It appears once in the global section of the MSO Configuration File. All MSO regions that have an identical MSO_group_name are grouped together and become selection candidates for MSO users. A user enters an MSO group by establishing an initial connection to a MSO region that has APPLGROUP specified. This results in the IBI Subsystem scanning the current MSO group population of MSO regions to properly place the Logon request of the user unless the SERVICE(...) parameter was specified at Logon.

SERVICE=name

where:

name

Specifies a service block name in a Logon request. It is mutually exclusive with specifying APPLNAME.

This specification is not new with MSO Load Balancing. The functional characteristics of using the Logon parameter SERVICE(...) change when Load Balancing is active for the MSO region. The SERVICE(...) Logon request will not be able to locate the service block of the same name unless APPLNAME=NONE has been specified in that service block.

The specified service block name will only be used if it has PROGRAM=FOCUS specified.

When APPLNAME is not specified for the service block, the service name becomes the default application name for that service block.

APPLNAME=name1
APPLNAME=name2
.......
APPLNAME=name8  /* max of 8 appl names per service block */    
APPLNAME=NONE

This is a Load Balancing keyword. It is specified within a service block in the MSO Configuration File. It identifies the service block as being a valid Load Balancing Logon destination for those Logon requests that specify an APPLNAME. Specifying APPLNAME is mutually exclusive with "service" in the Logon request.

When an application name is specified in the Logon request, a subset of MSO regions within the Load Balancing group is determined on the basis of which ones have a service block with the name specified as an applname.

The application name of NONE is reserved. If this is specified, the service block is not eligible for Load Balancing and is ignored for routing purposes. This is also the only way to be able to connect to a service block in a Load Balancing region by SERVICE(...) in the Logon request.

Note: If APPLNAME is not specified for a service block that is in an MSO Load Balancing region, a default application name is assumed for the service block using the service block name.