Previous Topic: Reservation Manager Commands

Next Topic: dpmrm cancel Command--Cancel a Reservation

dpmrm createfromtemplate Command--Create Reservation

The createfromtemplate command creates a reservation using an existing template.

This command has the following format:

dpmrm createfromtemplate -template template -startdate startdate -starttime starttime -enddate enddate -endtime endtime -username username [-sc sc_url] -orgunit orgunit [-notes notes][-email_address emailaddress][-projectid projectid][[-ws_user user name -ws_password password]|[-prompt yes|no]][-locale iso639value][-pre][-post]
-template template

Defines the name of a reservation defined in the Reservation Manager. Valid entry: 1-256 alphanumeric characters.

-startdate startdate

Defines the start date for the reservation. Valid entry: mm/dd/yyyy.

-starttime starttime

Defines the start time for the reservation. Valid entries: 0-23.
Note: If you define a start time within the current hour, always select the next hour. For example, if the current time is 12:23pm Pacific time, and you enter Startday=7/13/2010 and Starttime=12, the time is viewed as already passed, and is not allowed. In this case, select Starttime=13 or above.

-enddate enddate

Defines the end date for the reservation. Valid entry: mm/dd/yyyy.

-endtime endtime

Defines the end time for the reservation. Valid entry: 0-23.

-username username

Defines the user name for web security check.

-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

-orgunit orgunit

Defines the organizational unit for the reservation. Not required if the user is a member of only one organizational unit. Valid entry: 1-256 alphanumeric characters.

-notes notes

(Optional) Defines notes for creating a reservation. Valid entry: 1-256 alphanumeric characters.

-emailaddress emailaddress

(Optional) Defines the user email address for the reservation.

-projectid projectid

(Optional) Defines the project identification for the reservation.

-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 (for example: fr_FR for French) to override the default English output. 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: Create a Reservation

In this example, the existing template, WindowsMachine is used to create a reservation.

dpmrm createfromtemplate -template WindowsMachine -startdate 02/02/2010 -starttime 1 -enddate 03/02/2010 -endtime 4 -username cartog123 -orgunit 5467