.TH DATEPAGE.CGI 1 "Version 4.3.30:  4 Sep 2019" "Xymon"
.SH NAME
datepage.cgi \- Xymon CGI script to view pre-built reports by date
.SH SYNOPSIS
.B "datepage.cgi?type={day,week,month} \-\-url=URLPREFIX [options]

.SH DESCRIPTION
\fBdatepage.cgi\fR is invoked as a CGI script via the datepage.sh CGI wrapper.

datepage.cgi is passed a QUERY_STRING environment variable with the
type of time-selection that is desired: Either "day", "week" or "month"
can be requested. It will then generate a web form with appropriate
day/week/month selection boxes, and based on the users' selection a
resulting url is built from the URLPREFIX and the time selection.
The browser is then redirected to this URL.

The URL is constructed from the URLPREFIX, the type-parameter, the 
value of the "pagepath" or "host" cookie, and the users' selection 
as follows:

.IP type=day
The final URL is \fBURLPREFIX/daily/YEAR/MONTH/DAY/PAGEPATH\fR.

.IP type=week
The final URL is \fBURLPREFIX/weekly/YEAR/WEEK/PAGEPATH\fR.

.IP type=month
The final URL is \fBURLPREFIX/monthly/YEAR/MONTH/PAGEPATH\fR.

YEAR is the full year (4 digits, including century). MONTH is the
two-digit number of the month (01..12). DAY is the number of the 
day in the month (01..31). WEEK is the ISO 8601:1988 week-number 
(01..53). PAGEPATH is the current value of the "pagepath" cookie
if set; if it is not set but the "host" cookie is set, then this
host is looked up in the hosts.cfg file and the page where this host
is found is used for PAGEPATH. These two cookies are set by the 
default web-header templates supplied with Xymon.

.SH OPTIONS
.IP "\-\-url=URLPREFIX"
This specifies the initial part of the final URL. This option is required.

.IP "\-\-hffile=FILENAME"
Specifies the template files (from $XYMONHOME/web/) to use. The default is 
"\-\-hffile=report".

.IP "\-\-color=COLOR"
Sets the background color of the generated webpage. The default is blue.

.IP "\-\-env=FILENAME"
Loads the environment defined in FILENAME before executing the CGI script.

.IP "\-\-debug"
Enables debugging output.

.IP "$XYMONHOME/web/report_form_daily"
HTML form template for the date selection form when type=daily.

.IP "$XYMONHOME/web/report_form_weekly"
HTML form template for the date selection form when type=weekly.

.IP "$XYMONHOME/web/report_form_monthly"
HTML form template for the date selection form when type=monthly.

.IP "$XYMONHOME/web/report_header"
HTML header file for the generated web page

.IP "$XYMONHOME/web/report_footer"
HTML footer file for the generated web page

.SH "ENVIRONMENT VARIABLES"
.IP XYMONHOME
Used to locate the template files for the generated web pages.

.IP QUERY_STRING
Contains the parameters for the CGI script.

.SH "SEE ALSO"
xymongen(1), hosts.cfg(5), xymonserver.cfg(5)