Construct a WLM service definition

Use this operation to construct a new service definition based on the current installed service definition.

HTTP method and URI path

PUT /zosmf/zwlm/rest/policy/inspolicy

Query parameters

None.

Description

This operation constructs a new service definition based on the current installed service definition. A description for the report class is generated based on the domain name and domain ID.

On successful completion, a response body that describes the request is returned.

For the properties that you can specify on the request body, see Request content.

For a description of the response content, see Response content.

Request content

The request content is expected to contain a JSON object. See Table 1 for a description of the fields.

Table 1. Request content for the construct a WLM service definition request
Field name	Required or Optional	Description
cloud-info	Required	Specifies attributes of the cloud: WRP-ID Identifier of the WLM resource pool.
provision-data	Required	Specifies the attributes of the WLM service definition: classification-rules Array of attributes, in the form "attribute-name":"value", for example: `“classification-rules”: [ {“service-level-agreement”:”Gold”, “qualifier-value”:”CICSL00”, “report-class”: “optional”} ]`

Authorization requirements

See Required authorizations.

HTTP status codes

For a successful request, the response body is provided, as described in Request content.

For a list of status codes, see Error handling.

Response content

On successful completion, the service returns a response body, which contains a JSON object. For a description of fields in the JSON object, see Table 2.

Table 2. Response content for a successful construct a WLM service definition request
Field name	Description
status	Status of the request.
messages	Message issued for the request.
result	Result for the request. classification-rules Array of attributes, in the form "cl-rule-id":"value", for example: `“classification-rules”: [ {“cl-rule-id”:”id”} ]`

Example HTTP interaction

The example in Figure 1 shows a request to construct a service definition based on the current installed definition.

Figure 1. Sample request to construct a service definition based on the current installed definition

PUT  https://host:port/zosmf/zwlm/rest/policy/inspolicy 

{   
    “cloud-info”:{
		   “WRP-ID”:”e5697dd6-88da-43f8-8f89-bbdf9537b296”,                                                                                             
                  }      
    “provision-data”:{ 
                                 
                       classification-rules: [
                                              {“service-level-agreement”:”Gold”, 
                                               “qualifier-value”:”CICSL00”, 
                                               “report-class”: “optional”}
                                             ] 
                      }
}

The following is the response body for the request.

Figure 2. Sample response body

{
   “state”:”success”,
    “return-code”:”0”,
    “message”:null,
    “result”:{ 
               “classification-rules”:[
                                        { “cl-rule-id”:”1090f34e-0a5a-4506-b553-91e932a46f3e”}   
                                      ]  
             }
}