Rangeview HTML Generator

General Page Formatting

Use the following arguments in your DS2CSF macro call to define the formatting for a page. Default argument values are listed first and displayed in bold type.

Note: For SAS 9.2 or later, the DS2CSF macro is no longer supported. The documentation on this Web site is for Release 8.2 or earlier of SAS. Please migrate your applications to use the GKPI procedure with ODS and the JavaImg device driver.

The BGTYPE, BRTITLE, CENTER, CTEXT, and DOCTYPE arguments apply to the entire page for the current invocation of the macro. So if you append data, the attributes of existing results will not change. You may want to use these arguments only when you replace, rather than append, pages.

The rendering of some formatting arguments varies from browser to browser. Some browsers may not support some of these options.

bgtype=NONE | COLOR | IMAGE

specifies the type of background for your Web page. If you specify COLOR or IMAGE as the value, then you must also specify the BG argument. Valid values for BGTYPE are

NONE: specifies that no background is used on your Web page. This is the default value.
COLOR: causes the generator to use the background color that is specified in the BG argument. If you specify COLOR as the value, then you must also specify a color as the value of the BG argument.
IMAGE: indicates that you want to use a custom image as a background. If you specify IMAGE as the value, then you must also specify the BG argument to provide the name and location of the image.

bg=value

If you specified BGTYPE=IMAGE, then value identifies the fully-qualified path and filename of a background image that you want to use on your Web page. If you specified BGTYPE=COLOR, then value indicates the specific background color you want to use on your page. You can specify a color value by using the color name or the RGB value.

bdclass=value

specifies the name of the style sheet class that is to be used for the document body.

brtitle=value

specifies the value that appears as the title in the browser window's title bar. By default, no title is displayed.

center=N | Y

determines whether all of the output that is generated by the current invocation of the macro is centered. The default is no center (N).

ctext=value

indicates whether you use the default global text color that is defined by the browser or by the color that is specified here. This argument affects all of the text that is generated by the current invocation of the macro. You can override the color for an element by using the color specification arguments. For example, specifying a color for SAS TITLE lines via the TCOLOR argument overrides the value that is specified by CTEXT. You can specify color values using the color name or the RGB value.

doctype=3.2 | value

specifies the information that is provided for the DOCTYPE tag in the HTML file. The default value is 3.2, which causes the following line to be written to the top of your HTML file:

  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">

If you want something other than the default text, then you can specify the exact text that you want to add. If you specify a blank for value, then nothing is added to the top of the HTML file. If you supply a value other than 3.2, then you must include the exact text that you want added. For example, if you want to reference a different DTD, then you must provide the entire string, including the string !DOCTYPE and the opening and closing angle brackets.

encode=Y | N

specifies whether the generator replaces angle brackets with the appropriate ASCII character representation so that the brackets display in the browser. To have DS2CSF check for the characters < and > and encode them as ASCII characters, specify ENCODE=Y. This enables the actual brackets to be displayed in the browser. By default, the brackets are encoded. To not encode the brackets, specify ENCODE=N, which causes the browser to attempt to act on them as an HTML-formatting instruction.

pagepart=ALL | HEAD | BODY | FOOT

specifies which parts of the Web page to write to the HTML file. You may want to write only some parts of the page if you are appending the results to an existing file. The valid values are

ALL: writes the HTML header information, your formatted SAS data, and the HTML footer information to the specified file. This is the default behavior and is selected when you are not appending additional information to the file.
HEAD: writes the HTML header information and your formatted SAS data to the HTML file. The HTML footer information is not included. Use PAGEPART=HEAD when you want to append additional output to this file from one of the HTML Formatters or from the Graph Applet Generator.
BODY: writes only your formatted SAS data to the specified file.
FOOT: writes your formatted SAS data and the HTML footer information to the specified file.

For more information, see Using Page Formats in the HTML Formatting Tools documentation.

saspower=url

specifies the name and location of the Powered by SAS logo image. This image automatically links to the home page for the SAS Web site. The value for this argument must be a valid URL. The image is added to the bottom of the HTML page. The default is to not display the image. Omit this argument if you do not want to use this image or have not acquired the logo.

Use of this image is by permission only. See the Powered by SAS logo guidelines and agreement.

sepclass=value

specifies the name of the style sheet class that is to be used for the page separator. If the value of the SEPTYPE argument is RULE, then the value of SEPCLASS is used on the CLASS attribute of the <HR> HTML tag. For an IMAGE separator, the value of SEPCLASS is used on the CLASS attribute of the <IMG> HTML tag.

seploc=url

specifies the location of the image that you want to use as a separator between applets in the output. This argument is required if you specify SEPTYPE=IMAGE. The value for this argument must be a valid URL.

septype=RULE | NONE | IMAGE

specifies the type of separator that you want to use between the applets in your output. The generator uses a separator whenever it is invoked. Valid values are

RULE: causes the generator to separate the applets in your output by adding the <HR> HTML tag (a horizontal rule) to the HTML file following the end of the applet. This value is the default value.
NONE: overrides the default value and does not include a separator between the applets in your output.
IMAGE: indicates that you want to use a custom image as a separator. If you specify SEPTYPE=IMAGE, then you must also specify the SEPLOC argument to provide the name and location of the image that you want to use.

spclass=value

specifies the name of the style sheet class that is to be used for the Powered by SAS logo.