Reference Guide › Command Line Scripting › Reservation Manager Commands › dpmrm cancel Command--Cancel a Reservation

dpmrm cancel Command--Cancel a Reservation

The cancel command cancels a reservation.

This command has the following format:

dpmrm cancel [-sc sc_url] -resid reservationid [-ws_user username -ws_password password] [-prompt yes|no] [-locale iso639value] [-pre] [-post]

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-resid reservationid

Defines the reservation identification number. Valid entry: positive integer.

-ws_user username -ws_password password

(Optional) Specifies the credentials to use for the web service security check. If you do not include credentials, you are prompted to enter them. Avoid the prompt for credentials by setting up your own session using caaipsecurity.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

-prompt yes | no

Defines whether to prompt the user for username and password.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

Example: Cancel a Reservation

In this example, the reservation 4321 is canceled after prompting the user for validation.

dpmrm cancel -resid 4321 -prompt yes

dpmrm checkreservation and updatereservation Commands

The checkreservation command examines reservation records to see if there is an ESX hostname or VC pool mismatch between the Reservation Manager DB records and the actual VMware environment. The result is output to the console.

The updatereservation command provides check and update functionality to reservation records. The check functionality is the same as the checkreservation command. When a DB record mismatch is found, the DB record is updated to have the correct ESX hostname and VC pool model path.

dpmrm checkreservation -resid reservationid | * [-ws_user username -ws_password password] [-prompt yes | no]

dpmrm updatereservation -resid reservationid | * [-ws_user username -ws_password password] [-prompt yes | no]

-resid reservationid

Indicates a specific reservation ID or '*' for all reservation IDs.

-ws_user username

(Optional) Identifies the security user name.

-ws_password password

(Optional) Identifies the security user password.

-prompt yes | no

(Optional) Indicates prompt for username and password. The default is yes.

Examples

To check reservation 18 for ESX hostname and VC pool DB record consistency:

dpmrm checkreservation -resid 18 -ws_user admin -ws_password ca_admin -prompt no

To check all reservations for ESX hostnames and VC pools DB record consistency:

dpmrm checkreservation -resid * -ws_user admin -ws_password ca_admin -prompt no

To check and update reservation 18 for ESX hostname and VC pool DB record mismatches:

dpmrm updatereservation -resid 18 -ws_user admin -ws_password ca_admin -prompt no

To check and update all reservations for ESX hostname and VC pool DB record mismatches:

dpmrm updatereservation -resid * -ws_user admin -ws_password ca_admin -prompt no