lsb_calendarop

Adds, modifies or deletes a calendar.

lsb_calendarop is used to add, modify or delete a calendar. The oper parameter is one of CALADD, CALMOD, or CALDEL. When the operation CALADD is specified, the first element of the names array is used as the name of the calendar to add. The desc and calExpr parameters should point to the description string and the time expression list, respectively. See bcaladd() for a description of time expressions.

CALMOD permits the modification of the description or time expression list associated with an existing calendar. The first name in the names array indicates the calendar to be modified. The desc and calExpr parameters can be set to the updated value or to NULL to indicate that the existing value should be maintained.

If the operation is CALDEL then the names parameter points to an array of calendar names to be deleted. numNames gives the number of names in the array. options is reserved for the future use.

#include <lsf/lsbatch.h>

int *lsb_calendarop(int oper, int numNames, char **names, char *desc, char *calExpr, int options, char **badStr)

Parameters:

	oper	One of CALADD, CALMOD, or CALDEL. Depending on which one is chosen, adds, modifies, or deletes a calendar.Defined in calendar_command.
	numNames	The number of names in the array.
	**names	Depending on oper, it defines the name of the calendar is going to be added, modified or deleted.
	*desc	The calendar's description list.
	*calExpr	A calendar expression.
	options	Currently unused.
	**badStr	Return from mbatchd indicating bad name or event time of calendar.

Data Structures:

none

Define Statements:

calendar_command

Returns:

int: 0
Function was successful.

int:-1
Function failed.

Errors:

If the function fails, lsberrno is set to indicate the error. If error is related to bad calendar name or time expression, the routine returns the name or expression in badStr.

Equivalent line commands:

none

Files:

none

See also:

lsb_calendarinfo