Process control

You are provided with many keywords to modify the presentation of the calendar, by setting them either within the ARGS symbolic parameter or SYSIN.

The EQQWXHTM program operates in one of the following modes:

SINGLE: A single calendar is created with dates set by the PROCESS keyword.
MULTI: An IEBUPDATE stream is created to create multiple calendars, one for each application found in the INAD file.

All keywords have default values, therefore none of them is required.

CALENDAR(<calendar-name>,[DEFAULT|FORCE])

The CALENDAR keyword enables you to specify the calendar to be used to set specific free days.

The second keyword determines how the specified calendar is used when MODE(MULTI) is set:

DEFAULT: The calendar is used only if a calendar is not specified in the application.
FORCE: The calendar is used even if a calendar is specified against the application.

If CALENDAR is not specified, calendars are not used in the output; only regular FREEDAYS are shown.

DAYS(<column-headers>)

The column headers for each day of the week. If you enter less than seven words, the remaining column headers are blank. If you enter more than seven words, the extra words are ignored. The default is DAYS(MON TUE WED THU FRI SAT SUN).

OUTHTNL(<DD-Name>)

The DD name of the output file to be specified. The default is OUTHTML(OUTHTML).

FREEDAYS(<day-list>)

The days of the week that are always free days. The days are specified by number, starting from 1=Monday to 7=Sunday. Any non numeric value is ignored. It is also possible to set a separate color code for Free days by appending html color codes to the list following ==.

For example, FREEDAYS(6 7==gray-yellow) sets Saturday and Sunday as Free days, and sets the background color to gray with the text color yellow.

The default is FREEDAYS(6 7).

Note: In MODE(MULTI) day of the week free days are set by this keyword and not extracted from the calendar; only specific date free days are extracted from the calendar.

HEAD(<BG-html-colour>[-<TEXT-html-colour>])

Sets the background color, and optionally the text color, for the header that contains the names of the days. If only one color is specified, it is considered the background color. If two colors are specified, separated by a minus sign (-), the first is the background color and the second is the text color.

The default is HEAD(blue-white).

HILITE(<BG-html-colour>[-<TEXT-html-colour>])

Sets the background color, and optionally the text color, for any highlighted cells whose color is not specified by other means. If only one color is specified, it is considered the background color. If two colors are specified, separated by a minus sign (-), the first is the background color and the second is the text color.

The default is HILITE(gray-yellow).

INAD(<DD-Name>)<only with MODE(MULTI)>

The DD name of the input file that instructs EQQWXHTM about the applications for which to generate calendars. The default value is INAD.

The format of the file is for each application to process: application name,calendar or blank,description,

Any data after the final comma is ignored.

INCL(<DD-Name>)

The DD name of the input file that holds specific free dates from calendars. The default value is INCL.

The format of the file is for each specified date in each calendar: calendar name,date in format YYMMDD,date description,

Any data after the final comma is ignored. The INCL file is read only if CALENDAR is specified.

INLTP(<DD-Name>)<only with MODE(MULTI)>

The DD name of the input file that holds run information for applications. The default value is INTLP.

The format of the file is for each specified date in each calendar: IA date in format YYMMDD,AD name,

Any data after the final comma is ignored.

MODE(SINGLE|MULTI)

Determines whether to create a single HTML calendar or produce one calendar for each application listed in the INAD file.

MONTHS(<month-list>)

The block headers for each month. If you enter less than 12 words, the remaining block headers are blank. If you enter more than 12 words, the extra words are ignored.

The default is MONTHS(JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC).

OUTFTP(<DD-Name>) <only with MODE(MULTI)>

The DD name of the FTP output file. This file contains FTP get statements to allow the PDS members to be translated into html files named after the application. If OUTFTP is not specified, no FTP statements are generated.

The default value is OUTFTP(OUTFTP).

OUTHTML(<DD-Name>)

The DD name of the HTML output file. This file contains the HTML calendar definitions.

The default value is OUTHTML(OUTHTML).

PROCESS(<file-list>)

Specifies a list of files to be processed to add specific list of dates to the calendar. The files must be fixed block text files with the first word being a date in the format YYMMDD, optionally followed by a comma and the text for the tooltip of this date. You can also specify the color properties for the dates, by appending a html color codes to the list following ==.

For example, the keyword PROCESS(HOLS,RUNDATES==green-yellow) first processes a file named HOLS setting the colors to be the values specified by HILITE, then it processes a file named RUNDATES setting the foreground color to green and the background color to yellow for the dates in the list. If the same date is referred to in multiple lists, the tooltip contains the text from each list in the order they were processed, the color coding is set to the last reference to that date.

Individual dates within a file can be given their own color coding by appending html color codes to the record in the file following ==.

The following example shows how to code the 25th and 26th of December with specific colors:

//HOLS     DD * 
120406,Goede Vrijdag 
120409,2E Passdag 
120430,Koninginnedag 
120517,Hemelvaart 
120728,2E Pinksterdag 
121225,1E Kerstdag==green-red 
121226,2E Kerstdag==green-red

The default is blank, meaning that no files are processed.

ROW1(<BG-html-colour>) ROW2(<BG-html-colour>)

The ROW1 and ROW2 keywords set the background for each alternate row of each month, to make the calendar easier to read.

The default is ROW1(#FFFFCC) ROW2(#99CCCC).

RUN(<BG-html-colour>[-<TEXT-html-colour>]) <only with MODE(MULTI)>

Sets the background and optionally the text color for the run dates of applications in MODE(MULTI). If only one color is specified, it is considered the background color. If two colors are specified, separated by a minus sign (-), the first is the background color and the second is the text color.

The default is RUN(green-white).

TEXT(<TEXT-html-colour>)

Sets the default text color for dates within the calendar. This value can be overridden for highlighted dates with the HILITE keyword, and for individual processed files and dates using the == tagging method.

The default is TEXT(black).

TITLE(<calendar-title>) <only with MODE(SINGLE) >

The title of the calendar. It is displayed at the head of the page, and in the browser title bar. The default is the value set by the YEAR keyword.

When in LTP mode, the TITLE is the name of the application.

TRANSFER(get|put)

Determines the direction to which the FTP statements transfer the members:

get: Pulls the members from the mainframe to a remote server. The FTP job is run on the remote server.
put: Pushes the members from the mainframe to a remote server. The FTP job is run on the mainframe.

YEAR(<year>)

The year for which to produce the report. The value must be specified in the form YYYY.

The default is the current year.

Note:

Many of these keywords enable you to specify html colors. You can use both color names (such as gray, blue, red) and RGB color codes (such as #99CCCC). Because the different browsers support a vast range of colors, the contents of the color keywords are not validated. Ensure the you set colors supported by the browser that you will be using to view the calendar. Any colors not supported by the browser are ignored when the calendar is browsed. Many browsers are case sensitive, therefore the SYSIN for EQQWXHTM must be in mixed case.
In most keywords, you can separate lists with a space or comma.