lsb_reservationinfo

Retrieve reservation information to display active advance reservations.

Use lsb_reservationinfo to retrieve reservation information from mbatchd. This function allocates memory that the caller should free.

If the lsb_reservationinfo function succeeds, it returns the reservation records pertaining to a particular reservation ID (rsvId) as an array of rsvInfoEnt structs.

If rsvId is NULL, all reservation information will be returned. If a particular rsvId is specified:

• If found, the reservation record pertaining to a particular rsvId is returned
• If not found, the number of reservation records is set to zero and the lsberrno is set appropiately

#include <lsf/lsbatch.h>

struct rsvInfoEnt *lsb_reservationinfo(char *rsvId, int *numEnts, int options)

Parameters:

	*rsvId	Reservation ID of the requested reservation.
	*numEnts	Number of reservation entries that mbatchd returns.
	options	The parameter options is currently ignored.

Data Structures:

rsvInfoEnt
hostRsvInfoEnt

Define Statements:

none

Returns:

struct rsvInfoEnt *:A pointer to reservation infomation entry.
Function was successful.

NULL
Function failed.

Errors:

On failure, lsberrno is set to indicate the error.

Equivalent line commands:

brsvs

Files:

none

See also:

lsb_addreservation

lsb_modreservation

lsb_removereservation