Interface to software license and hardware inventory reservation
BMC Asset Management provides the following interface forms that enable you to manage software license and hardware inventory reservations:
- AST:Reservation_Interface
- AST:Reservation_Hardware_Interface
This topic provides information about specific functions, input, and output parameters for these forms.
Software license reservation/release request from BMC Service Request Management
This feature enables you to release or reserve licenses by using information from Software license management. The main functions are:
Get license information
The Get license information function is called when you are in the process of submitting a new software license request. This function returns the current usage information of the selected License Certificates to the requesting application (in this case BMC Service Request Management).
To call the Get license information function, BMC Service Request Management must create a service call. The input and output parameters for this call are in the following table:
Input and output parameters for the Get license information function
Input parameters | Output parameters |
|---|---|
Company | Total Number of Licenses Purchased for a certificate |
Manufacturer | Total Number of licenses deployed |
Product name | Total Number of licenses reserved |
Market version | Return code |
Prod Cat1 | Total Number of licenses available (Purchased - (deployed + Reserved)) |
Prod Cat2 | License Available Flag |
Prod Cat3 |
|
Z1d Action = "GET_SOFTWARE_LICENSE_ID" |
|
Number to be Reserved |
|
Reservation Type |
|
Reserve licenses
The Reserve licenses function reserves the requested number of licenses for you from the application request. The function also updates the selected Software License usage counts in the AST:License Certificates forms.
To call the Reserve licenses function, BMC Service Request Management must create a service call. The input and output parameters for this call are in the following table:
Input and output parameters for the Reserve licenses function
Input parameters | Output parameters |
|---|---|
Company | Total Number of Licenses Purchased for a certificate |
Manufacturer | Total Number of licenses deployed |
Product name | Total Number of licenses reserved |
Market version | Return code |
Prod Cat1 | Total Number of licenses available (Purchased - (deployed + Reserved)) |
Prod Cat2 | Number of licenses reserved in this request |
Prod Cat3 | License Certificate ID |
Z1d Action = "RESERVE_SOFTWARE_LICENSE" |
|
Request ID |
|
App Keyword |
|
Number to be reserved |
|
Reservation Type |
|
Release licenses
The Release licenses function releases the requested number of licenses from the application request or from the Manage Reservation Details dialog box. The function also updates the selected Software License usage counts in the AST:License Certificates forms.
To call the Release licenses function, BMC Service Request Management must create a service call. The input and output parameters for this call are in the following table:
Input and output parameters for the Release licenses function
Input parameters | Output parameters |
|---|---|
Action | Total Number of Licenses Purchased for a certificate |
Request ID | Total Number of licenses deployed |
App Keyword | Total Number of licenses reserved |
Number to be released | Return code |
License Certificate ID | Total Number of licenses available (Purchased - (deployed + Reserved)) |
Reservation Type |
|
Reservation By |
|
Z1d Action = "RELEASE_SOFTWARE_LICENSE" |
|
Number of licenses to be released |
|
Hardware inventory reservation/release request from BMC Service Request Management
This feature enables applications to release or reserve CIs by using information from Asset Management (AST:Base Element). The main functions are:
Get CI information
The Get CI information function is called when you are in the process of submitting a new hardware request. The function returns the selected CI types' current usage information to the requesting application (in this case BMC Service Request Management).
To call the Get CI information function, BMC Service Request Management must create a service call. The input and output parameters for this call are in the following table:
Input and output parameters for the Get CI information function
Input parameters | Output parameters |
|---|---|
Company | Total Number of CIs reserved |
CI Type | Total Number of CIs available |
Product name | CI ID |
Market version | Return code |
Prod Cat1 |
|
Prod Cat2 |
|
Prod Cat3 |
|
Action = "GET_HARDWARE_ID" |
|
BMC Class ID |
|
Reserve CI
The Reserve CI function reserves the requested number of CIs for a user from the application request.The function updates the selected CI type status in the AST:BaseElement form.
To call the Reserve CI function, BMC Service Request Management must create a service call. The input and output parameters for this call are in the following table:
Input and output parameters for the Reserve CI function
Input parameters | Output parameters |
|---|---|
Company | Total Number of CIs reserved |
CI Type | Total Number of CIs available |
Product name | CI ID |
Market version | Return code |
Prod Cat1 |
|
Prod Cat2 |
|
Prod Cat3 |
|
Action = "RESERVE_HARDWARE_LICENSE" |
|
BMC Class ID |
|
Request ID |
|
App Keyword |
|
Reserved by |
|
Number to Reserved |
|
Release CI
The Release CI function releases the requested number of CIs from the application request or from the Manage Reservation Details dialog box. This function updates the selected CI status in the AST:Base Element form.
To call the Release CI function, BMC Service Request Management must create a service call. The input and output parameters for this call are in the following table:
Input and output parameters for the Release CI function
Input parameters | Output parameters |
|---|---|
Company | Total Number of CIs reserved |
CI Type | Total Number of CIs available |
Product name | CI ID |
Market version | Return code |
Prod Cat1 |
|
Prod Cat2 |
|
Prod Cat3 |
|
Action = "RESERVE_HARDWARE_LICENSE" |
|
BMC Class ID |
|
Request ID |
|
App Keyword |
|
Reserved by |
|
Number to Reserved |
|
For more information about software license and hardware inventory reservation, see Releasing-viewing-and-reserving-licenses and Releasing-viewing-and-reserving-hardware-inventory.
Related topics