z/OS MVS Programming: Workload Management Services
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Why Use the Queueing Manager Services

z/OS MVS Programming: Workload Management Services
SC34-2663-00

Why Use the Queueing Manager Services

A queueing manager is a subsystem or application that queues work requests to workload management for execution by one or more server address spaces.

Queueing manager services allow MVS™ to:

  • Dynamically start and stop server address spaces based on workload.
  • Control the number of server instances per server address space.
  • Manage the work queues associated with the server address spaces to meet the performance goals set by the customer.

With the dynamic management of server address spaces, an installation does not need to calculate the proper number of address spaces to process work, nor do they have to monitor workload fluctuations that change the number of address spaces needed. Customers can segregate work requests into different server address spaces if this is important for security or integrity.

Enclaves are required to be used with the queueing manager services. This means that customers can define velocity and discretionary goals for work as well as response time goals. Multiple period control is also available for work running in enclaves.

Queueing manager services may provide incentive to subsystems who run with multiple tasks in one address space to switch to multiple address spaces. The queueing manager services make it easier for installations to isolate individual work requests from each other, by running only one in each execution address space, with workload management managing the number of execution address spaces.

Table 4 shows a summary of the queueing manager services.

Table 4. Queueing manager services
ServicePurposeInformation
IWM4AEDFDefine a dynamic application environmentIWM4AEDF macro — WLM Define Dynamic Application Environments
IWM4CONWith the QUEUE_MANAGER=YES parameter, establish the caller as a queueing manager so it can begin queueing work requests to its server address spaces.IWM4CON – Connecting to Workload Management
IWM4CONWith the SERVER_MANAGER=YES parameter, establish the caller as a server address space so it can begin receiving work requests from the queueing manager.IWM4CON – Connecting to Workload Management
IWM4DISRemove the caller as a queueing manager or server manager.IWM4DIS – Disconnecting from Workload Management
IWM4ECRECreate an enclave. This can be done by the queue manager itself or by its caller. It can be a dependent or independent enclave.IWM4ECRE macro — Create Enclave
IWM4EDELDelete an enclave.IWM4EDEL – Deleting an Enclave
IWMESQRYQuery whether or not the current dispatchable unit is associated with an enclave.IWMESQRY – Querying Enclave State
IWM4QDEDelete a work request from the queue for an execution address space.IWMQDEL – Deleting a Request from the Queue for An Execution Address Space
IWM4QINInsert a work request onto workload management queues so its execution in a server address space can be managed by workload management. The enclave token obtained with the IWM4ECRE service is passed into workload management by IWM4QIN.IWM4QIN – Inserting a Request Onto the Queue for an Execution Address Space
IWMSINFObtain the number of server instances to be started by workload management.IWMSINF — WLM Server Manager Inform Service
IWM4SLIImmediately after invoking IWM4CON, optionally establish a maximum and/or minimum number of server instances that can be started for a given application environment.IWM4SLI – Application Environment Limit Service
IWM4SSLSelect a work request from workload management queues for execution in a server address space. This must be done under a task.IWM4SSL – Selecting a Request from a Caller's Work Manager Queue
IWM4SSMSelect the next secondary work request from the queue associated with the caller's server task.IWM4SSM – WLM Server Select Secondary Service
IWM4STBGJoin the invoking task to the enclave associated with the work request represented by WUTOKEN (which was obtained on a prior call to IWM4SSL) and optionally check the authorization of the request. The server address space is beginning to process the work request. This must be done under a task.IWM4STBG macro — WLM Begin Server Transaction Service
IWM4STENLeave the enclave that was joined in IWM4STBG. The server address space has completed its processing of the work request.IWM4STEN – Ending a Request from a Caller's Work Manager Queue
IWM4TAFTell workload management when a temporal affinity begins and when it ends.IWM4TAF — WLM Temporal Affinity Service

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014