Updating a Service Definition with Application Environment Information

When a customer installs a subsystem that makes use of the queueing manager services, the service administrator must define one or more application environments in the workload management service definition. An application environment is a group of application functions requested by a client which execute in a server address space. Workload management dynamically adjusts the number of address spaces servicing the application environment to meet the goals of the work.

If you use the queueing manager services, make sure to document the information needed by the customer's service administrator to define the application environments. For example, you should provide the following:

• A technique for grouping work into application environments.

  Each application environment should represent a named group of server functions that require access to the same application libraries. Having a named group facilitates library security, application program change control, performance management, and system operation.

  For example, a set of related payroll applications might be grouped into one application environment because of their similar run-time requirements. The customer can name the application environment for these payroll applications in the service definition. Workload management then starts and stops server address spaces to process the work in the payroll applications.

• The queueing manager subsystem type

  The queueing manager specifies the subsystem type in the SUBSYS parameter of the IWM4CON service. A service administrator defines the subsystem type when specifying the application environment in the service definition. Make sure you do not use a subsystem type already in use by another subsystem.

• Samples of JCL start procedures and start parameters for a server address space.

  You should provide your customer with sample procedures and start parameters for the server address spaces.

For more information on how to define an application environment and a list of subsystem types currently used, see z/OS MVS Planning: Workload Management.