(zos)

Precedence for modify command parameters, request-level RAS attributes, and server-wide properties

Three ways exist to define Reliability Availability and Serviceability (RAS) attribute values: server-wide properties, request-level RAS attributes, or modify command parameters. Modify command parameters have precedence over associated RAS attributes and server-wide properties, while the RAS attributes have precedence over the associated server-wide properties.

The following list describes the order of precedence:

The server-wide property settings continue to apply to any protocols that the request-level RAS attribute does not apply.

A RESET value is available on all modify commands that have corresponding server-wide properties that also have associated RAS attributes. The RESET value deactivates the modify command override. After a reset is invoked, the server returns to the server-wide properties and RAS attributes that were in effect before the modify override became activated.

Remember: How a RAS attribute takes effect depends on how you define the RAS attribute.

Several of the RAS attributes added to the workload classification file are associated with server-wide environment properties which are associated with modify commands. For example, the SMF_request_activity_enabled request-level RAS attribute is associated with the server_SMF_request_activity_enabled server-wide property, which in turn is associated with the SMF,REQUEST modify command.

The SMF_request_activity_enabled request-level RAS attribute specifies whether the application server collects System Management Facilities (SMF) 120 subtype 9 records for requests. The requests can be HTTP requests, IIOP requests, optimized local adapter requests, or MDB requests that have the listener in the control region. The request-level RAS attribute is coded on the HTTP classification element for HTTP requests, on the IIOP classification element for IIOP requests, on the optimized local adapter classification element for optimized local adapter requests, and on the MDB classification element for MDB requests.

The server_SMF_request_activity_enabled server-wide property specifies whether the application server collects SMF 120 subtype 9 records for all requests that the application server processes.

The SMF_request_activity_enabled request-level RAS attribute overrides the server_SMF_request_activity_enabled server-wide property for any HTTP requests, IIOP requests, optimized local adapter requests, or MDB requests that have the listener in the control region. Like the server-wide property, the SMF,REQUEST modify command specifies whether the application server collects SMF 120 subtype 9 records for all requests that the application server processes. However, the modify command dynamically overrides the settings for the request-level RAS attribute and the server-wide property without requiring a restart of the server.

The example shows the following capabilities:

Here are the particulars for each of the capabilities:


Related tasks

  • Enable request-level Reliability Availability and Serviceability (RAS) granularity

  • Modify command
  • Workload classification file