Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

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

 

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