Common Commands › caladmin-Configure or Shut Down the Calendar Service

caladmin-Configure or Shut Down the Calendar Service

Applies to UNIX/Linux and Windows

Use the caladmin command to modify the Enterprise Management calendar service. Use this command to add, update, and delete calendars from the active calendar list kept in storage by the calendar service. Also, use this command to shut down the calendar service.

Performance Considerations

To minimize resource consumption, calendars that are not in use should be deleted from the active calendar list.

Calendars created or modified with the command line interface are not reflected in the calendar service unless the caladmin command is used to modify the active calendar list or the calendar service is terminated and restarted.

Use the -a, -d, and -u options to modify the active calendar list for specific calendar entries.

caladmin (Windows)

This command has the following format:

caladmin  [-r]
               [-b]
               [-s]
               [-l]
               [-dcalendar]
               [-acalendar]
               [-ucalendar]
               [-v]

Environment Variables

%CAIGLBL0000%

Identifies the path where Enterprise Management is installed.

%CAICAL0000%

Contains information for debugging and tracing the calendar service. (For CA internal use only.)

caladmin (UNIX/Linux)

Note: This command must be executed on a UNIX/Linux system.

This command has the following format:

caladmin  [-r]
          [-b]
          [-s]
          [-l]
          [-dcalendar]
          [-acalendar]
          [-ucalendar]
          [-v]

-r

Refresh the active calendar list. The calendar service releases the current active calendar list and reloads all calendars defined in the Enterprise Management database.

-b

Rebuild binary files and refresh the active calendar list. The calendar service releases the active calendar list and rebuilds the binary files for all calendars defined in the Enterprise Management database. The rebuilt calendars are loaded into the active calendar list.

Important! The following information applies to the -r and -b options.

When instructed to refresh the active calendar list, the calendar service queues all calendar validation requests until the refresh process is complete.

Note: The refresh process can be overhead intensive and can slow down system performance. Therefore, we recommend that you use the -r or-b option judiciously.

-s

Shut down the calendar service.

Important! Shutting down the calendar service causes all requests for calendar validation to be returned as an “invalid day/time” condition. This has the potential to cause all logons, workload schedules and jobs, and so forth, to be rejected. Therefore, the -s option should not be used during normal production hours. The -s option should be issued just before a reboot or system shutdown.

-l

List the name of each calendar in the active calendar list. Check the system console or Windows Event Viewer file to view the list.

-dcalendar

Delete (remove) the named calendar from the active calendar list.

Note: Any subsequent requests for the deleted calendar result in calendar validation failure returning an “invalid day/time condition."

-acalendar

Add the named calendar (defined in the Enterprise Management database) to the active calendar list.

-ucalendar

Update the named calendar in the active calendar list. The calendar service reads the binary file for the named calendar and updates the copy of the calendar in the active calendar list.

-v

Save current in-core calendars' DSB file.

Environment Variables

CAIGLBL0000

Identifies the path where Enterprise Management is installed.

Examples

caladmin -r

Refreshes the active calendar list.

caladmin -b

Rebuilds binary files and refreshes the active calendar list

caladmin -s

Shuts down the calendar service.

caladmin -l

Produces a list of all calendars in the active calendar list.

caladmin -dxyzcal

Removes the calendar xyzcal from the active calendar list.

caladmin -aabccal

Adds the calendar abccal, defined in the Enterprise Management database, to the active calendar list.

caladmin -uupdcal

Updates the copy of the calendar updcal in the active calendar list.