Previous Topic

Next Topic

Display calendar properties (directory/calendar or lscal)

The DIRECTORY command will display all or just selected portions of the calendar database.

Windows/OpenVMS Format:

directory/calendar calendar_name [/qualifiers]

UNIX/Linux Format:

lscal calendar_name [-qualifiers]

Qualifier Summary

/check or -check

/comment or -comment

/node = node_name

/fiscal or -fiscal

/flags or -flags

/full or -full

/noheading or -noheading

/notrailing or -notrailing

/owner or -owner

/protection or -protection

/symbol or -symbol=[prefix_string,format]

/workdays or -workdays

Examples

Windows:

Schedule> directory/calendar \vlirette\specialdays /full 
 \vlirette\specialdays 
     Comment               = 
Owner = [0,0]
Protection = S:RWEDC,O:RWEDC,G:RWEDC,W:RWEDC
Workdays =
Flags =
Fiscal = 0

OpenVMS:

Schedule> directory/calendar [vlirette]specialdays/full 
 [vlirette]specialdays 
     Comment               = 
Owner = [0,0]
Protection = S:RWEDC,O:RWEDC,G:RWEDC,W:RWEDC
Workdays =
Flags =
Fiscal = 0

UNIX/Linux:

Schedule> lscal /vlirette/specialdays -full 
 /vlirette/specialdays 
     Comment               = 
Owner = [0,0]
Protection = S:RWEDC,O:RWEDC,G:RWEDC,W:RWEDC
Workdays =
Flags =
Fiscal = 0

Qualifiers

/check or -check

Workgroup Calendars Only. The CHECK option displays the designated object's status on the nodes in the current workgroup. Any differences are displayed as:

<node_name>: different

Adding the -log qualifier displays the specific differences between the object(s) on specific nodes.

/columns or -columns=number

The COLUMNS qualifier specifies how many columns to use when listing just the item name. The default is four columns.

/comment or -comment

The COMMENT option displays any useful description that you may have added.

/hostname or -node =hostname

The qualifier specifies what node (either local or remote) you want the operation performed on.

/fiscal or -fiscal

The FISCAL option displays which month is to begin the fiscal year.

/flags or -flags

The FLAGS option displays what special features are enabled. The various flags are:

Flag

Description

NOHOLIDAY_RUNS

No jobs will run on a holiday

NOWEEKEND_RUNS

No jobs will run on a weekend

/full or -full

The FULL option requests a display of all control information available on a calendar.

/noheading or -heading

The NOHEADING removes the heading information from the directory listing.

/notrailing or -notrailing

The NOTRAILING removes the trailing information from the directory listing.

/owner or -owner

The OWNER option displays the owner UIC code for the job.

/output or -output=output_file

The OUTPUT option sends all output to a text file. Output can be printed or displayed as needed.

/protection or -protection

The PROTECTION qualifier specifies the UIC based access rights for the file.

/SYMBOL or -symbol[=prefix_string] or [=(prefix string,format)]

The SYMBOL requests that all calendar information be output to a group of environmental variables. Every field in the control record is loaded into a single environmental variable. The symbol name is constructed by prefixing the field name with the provide string. If none is provided a default value of SM is used.

The format defines the way that symbols are output. The default output specification is: "$ %s=\" %s\" "" which produces the following format style.

SM_FLAGS = "Slide_over_disallowed"

Alternate output styles may be created by changing the format field.

/template or -template=<schedule_directory>template_db.schedule

The TEMPLATE command formats the directory output as it is defined in the template file. This output can be used for a variety of reasons and can be output to a file using the OUTPUT . The supplied template file extracts all database information into a format suitable for insertion if desired.

/workdays or -workdays

The WORKDAYS option displays which days a job is to run.

See Also

CALENDAR commands

Copy a calendar (copy/calendar or cpcal)

Create a calendar (create/calendar or mkcal)

Delete a calendar (delete/calendar or rmcal)

Modify a calendar's properties (modify/calendar or chcal)

Rename a calendar (rename/calendar or mvcal)

Type a calendar's months (type/calendar or morecal)