This documentation supports the 20.02 version of BMC Service Level Management. To view an earlier version, select the version from the Product version menu.

Customizing published BMC Service Level Management web services


BMC Service Level Management (BMC SLM) web services require a web services client and use the SOAP protocol. The web services provide Get operations to retrieve data for reporting. You can customize these published web services to meet your business requirements.

The following web services are provided:

  • SLA compliance status
  • Service targets list based on goal
  • Service targets related to agreement
  • Contracts related to agreement

The following table provides details of BMC SLM SLM_SLAList_ComplianceStatus web service.

Name

SLM_SLAList_ComplianceStatus

Form

SLM: SLACompliance

Operation

Compliance Status (Get)

Request parameters

  • SLA Name (String)
  • Review Period (Selection)

Response parameters

  • Compliance Status
  • SLA Name
  • Impact Cost
  • Penalty/Reward
  • Met Percent
  • Performance Goal
  • Review Period

Qualification

SLAName' = XPATH(/ROOT/@SLAName) AND 'EventFrequency' = XPATH(/ROOT/@ReviewPeriod) AND 'MeasurementDone' = "No"

The following table provides details of BMC SLM SLM_SLAList_ComplianceStatus web service. 

Name

SLM_SLAList_ComplianceStatus

Form

SLM: SLACompliance

Operation

AgreementList (Get)

Request parameters

  • Compliance Status (Selection)
  • Start Time (Date Time)
  • End Time (Date Time)

Response parameters

List of Agreements with

  • SLA Name
  • Met Percent
  • Compliance Target
  • Compliance Met
  • Compliance Status

Qualification

ComplianceStatus' = XPATH(/ROOT/@ComplianceStatus) AND ( 'CalculateNowDateTime' >= XPATH(/ROOT/@StartTime) AND 'CalculateNowDateTime' <= XPATH(/ROOT/@EndTime) ) AND 'MeasurementDone' = "No"

The following table provides details of BMC SLM SLM_Relatedservice targetList web service. 

Name

SLM_Relatedservice targetList

Form

SLM:SLAComplianceHistory

Operation

Relatedservice targetList (Get)

Request parameters

  • SLA Name (String)
  • Review Period (Selection)

Response parameters

List of Service Targets with

  • service target Name
  • service targetPeriodStatus
  • GoalType
  • Met Percent
  • Performance Goal
  • Review Period
  • SLAName
  • SLA ID

Qualification

SLAName' = XPATH(/ROOT/@SLAName) AND 'EventFrequency' = XPATH(/ROOT/@ReviewPeriod) AND 'MeasurementDone' =
"No"

The following table provides details of BMC SLM SLM_service targetListbasedonGoal web service.

Name

SLM_service targetListbasedonGoal

Form

SLM: Measurement

Operation

service targetList (Get)

Request parameters

  • Goal Status (Selection)
  • Start Time (Date Time)
  • End Time (Date Time)

Response parameters

List of Measurement Records with

  • service target Name
  • service target ID
  • Status
  • Goal Type
  • Ticket ID/Asset ID

Qualification

MeasurementStatus' = XPATH(/ROOT/@MeasurementStatus) AND ('OverallStartTime' >= XPATH(/ROOT/@StartTime) AND 'OverallStartTime' <= XPATH(/ROOT/@EndTime) ) AND 'MeasurementDone' = "No" AND 'Lastservice targetMeasurement' = "Yes"

The following table provides details of BMC SLM SLM_service targetListbasedonGoal web service.

Name

SLM_service targetListbasedonGoal

Form

SLM: Measurement

Operation

service targetstatus(Get)

Request parameters

  • service target Name (String)
  • Start Time (Date Time)
  • End Time (Date Time)

Response parameters

List of Measurement Records with

  • service target Name
  • service target ID
  • Measurement Status

Qualification

'service targetTitle' = XPATH(/ROOT/@service targetName) AND ('OverallStartTime' >= XPATH(/ROOT/@StartTime) AND 'OverallStartTime' <= XPATH(/ROOT/@EndTime) ) AND 'MeasurementDone' = "No" AND 'Lastservice targetMeasurement' = "Yes"

The following table provides details of BMC SLM SLM_service targetListbasedonGoal web service.

Name

SLM_service targetListbasedonGoal

Form

SLM: Measurement

Operation

MeasurementList (Get)

Request parameters

  • service target Name (String)
  • Start Time (Date Time)
  • End Time (Date Time)

Response parameters

List of Measurement Records with

  • service target Name
  • service target ID
  • Status
  • Goal Type
  • Ticket ID/Asset ID

Qualification

'service targetTitle' = XPATH(/ROOT/@service targetName) AND ('OverallStopTime' >= XPATH(/ROOT/@StartTime) AND 'OverallStopTime' <= XPATH(/ROOT/@EndTime) ) AND 'MeasurementDone' = "No"

The following table provides details of BMC SLM SLM_ContractRelatedSLAs web service.

Name

SLM_ContractRelatedSLAs

Form

SLM:SLAComplianceConstract_Join

Operation

AgreementList (Get)

Request parameters

  • Contract Name (String)
  • Start Time (Date Time)
  • End Time (Date Time)

Response parameters

List of related Agreements with

  • Agreement Name
  • Met Percent
  • Compliance Status
  • Goal Type
  • SLA Type
  • Contract Name
  • Contract ID
  • Contract Status and other Contract Details

Qualification

'InstanceName1' = XPATH(/ROOT/ContractName) AND ( 'CalculateNowDateTime' >= XPATH(/ROOT/StartTime) AND 'CalculateNowDateTime' <= XPATH(/ROOT/EndTime) ) AND 'MeasurementDone' = "No"

The following table provides details of BMC SLM SLM_ContractRelatedSLAs web service.

Name

SLM_ContractRelatedSLAs

Form

SLM:SLAComplianceConstract_Join

Operation

ContractList (Get)

Request parameters

  • Agreement Name (String)
  • Start Time (Date Time)
  • End Time (Date Time)

Response parameters

List of related Contracts with

  • Contract Name
  • Met Percent
  • Compliance Status
  • Goal Type
  • SLA Type
  • Agreement Name
  • Contract ID
  • Contract Status and other Contract Details

Qualification

'instanceName2' = XPATH(/ROOT/SLAName) AND ( 'CalculateNowDateTime' >= XPATH(/ROOT/StartTime) AND 'CalculateNowDateTime' <= XPATH(/ROOT/EndTime) ) AND 'MeasurementDone' = "No"

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*