vtk_reservation

vtk_reservation_create

Usage:         
vtk_reservation_create type what quantity start end [Options]

Description   
Creates a reservation for slave, resourcemap or emulator. A reservation with type slave is the same with a reservation created using vtk_slave_reserve. A reservation with type resouremap is the same with a 
reservation created using as vtk_resourcemap_reserve. type is one of slave, resourcemap, and emulator. 
              
For slave reservations, what is the name of slave. If the reservation is for multiple slaves, list them comma separated. quantity is not used. 
              
For resourcemap reservations, what is type:name of the resource. quantity can be the number of tokens if the resource is a license. start is the start time of the reservation. end is the end time of the reservation. The value of end can be 
forever if the reservation should never end. 
              
Option                        Description 
-user username                Reserve for specified user or users 
-group groupname              Reserve for specified fairshare group or groups 
-osgroup groupname            Reserve for specified Unix (or OS) group or groups 
-jobclass jobclass            Reserve for specified jobclass or jobclasses 
-jobproj jobproj              Reserve for specified jobproj 
-bucketid bucketid_list       Reserve for specified bucket id or ids 
-id id_list                   Reserve for specified id or ids 
-update                       Update an existing reservation if all other parameters are the same except start time and end time. 
              
Example:
vtk_reservation_create slave 'host1,host2' 4 1484612764 1484623650 -user brian
vtk_reservation_create type        what        quantity start       end        -user user1,user2
vtk_reservation_create slave       localhost   1        1484612764  1484623650 -user john
vtk_reservation_create slave       localhost   1        1484612764  1484623650 -group g1,g2
vtk_reservation_create resourcemap License:abc 4        0           forever    -jobclass class1
vtk_reservation_create emulator    PAL1        4        1484612764  1484623650 -group g1 -jobproj chipA  -jobclass class1


Returns:
VOV id of created reservation. 'nochange' if the reservation already exists.

Note:
Two reservations are considered the same if all parameters to create the reservations are the same.

vtk_reservation_delete

Usage:         
vtk_reservation_delete id

Description:   
Deletes the reservation having VOV id 'id'.

Returns:       
ok if found, or errors

vtk_reservation_delete_orphans

Usage:         
vtk_reservation_delete_orphans 

Description:   
Deletes all orphan reservations.

Returns:       
ok if no error, or errors

vtk_reservation_get

Usage:         
vtk_reservation_get id arrayname

Description:   
Retrieves information into the array named by 'arrayname' about the reservation

Returns:       
ok if found, or errors if there is no such reservation

vtk_reservation_update

Usage:         
vtk_reservation_update id fieldname value

Description:   
Modify reservation contents. Available fieldnames can be found using vovselect fieldname from reservations.

Returns:       
ok if update is successful, or errors