vtk_reservation

Usage:         
vtk_reservation_create type what quantity start end [Options]

Description   
Creates a reservation for tasker, resourcemap or emulator. A reservation with type tasker is the same with a reservation created using vtk_tasker_reserve. A reservation with type resouremap is the same with a 
reservation created using as vtk_resourcemap_reserve. type is one of tasker, resourcemap, and emulator. 
              
For tasker reservations, what is the name of tasker. If the reservation is for multiple taskers, 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
-usergroup groupname          Reserve for specified user 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
-resources "SLOTS/x RAM/x CORES/x SWAP/x  Reserve given number of resources of specified tasker 
-update                       Update an existing reservation if all other parameters are the same except start time and end time. 
              
Example:
vtk_reservation_create tasker 'host1,host2' 4 1484612764 1484623650 -user brian
vtk_reservation_create type         what        quantity start       end        -user user1,user2
vtk_reservation_create tasker       localhost   1        1484612764  1484623650 -user john
vtk_reservation_create tasker       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.

Usage:         
vtk_reservation_delete id

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

Returns:       
ok if found, or errors

Usage:         
vtk_reservation_delete_orphans 

Description:   
Deletes all orphan reservations.

Returns:       
ok if no error, or errors

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

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