Macro Arguments for the DS2CONST and DS2TREE Macros

Macro Arguments

Macro arguments specify the configuration of the HTML output file, the location of the data that is used to generate the diagram, and the configuration of the applet's interactive features.

The macros use the following syntax:

%macroname(argument1=value1, argument2=value2, ...);

Arguments for the APPLET Tag. The CODEBASE argument is required.
DS2TREE and DS2CONST Arguments for Data Definition. For DS2TREE, the arguments NDATA and NID are required. For DS2CONST the arguments NDATA, NID, LDATA, and LTO are required.
Arguments for Generating HTML and XML Files.
DS2TREE and DS2CONST Arguments for Diagram Appearance.
Arguments for Page Formatting.
Arguments for Stylesheets.
Arguments for the SAS TITLE and FOOTNOTE Tags.
Arguments for Character Transcoding.

Arguments for the APPLET Tag

The following arguments configure the APPLET tag in the HTML output file. The CODEBASE argument is required.

AHUNITS=PIXELS | PERCENT

specifies the units of the HEIGHT= argument. The default value is PIXELS. See also the AWUNITS= argument.

Used by:

DS2TREE, DS2CONST

ALIGN=position

specifies the alignment of the applet window in the browser window or frame. Values can be LEFT, RIGHT, TOP, BOTTOM, TEXTTOP, MIDDLE, ABSMIDDLE, BASELINE, or ABSBOTTOM.

Used by:

DS2TREE, DS2CONST

ALT=text

specifies the text that will be displayed on mouseover by browsers that understand the tag but cannot run Java applets. The default value is SAS Institute Inc. applet_name.

Used by:

DS2TREE, DS2CONST

ARCHIVE=filename

specifies the name of the Java archive file(s).

Note: The path to the Java archive is specified in the CODEBASE argument. [cautionend]

The following table shows what archive files to use with each of the macros. For DS2TREE and DS2CONST, you do not have to specify a value for ARCHIVE= because the values shown are generated by default.

DS2TREE	archive=%str(sas.graph.treeview.jar, sas.graph.nld.jar, sas.graph.j2d.jar)
DS2CONST	archive=%str(sas.graph.constapp.jar, sas.graph.nld.jar, sas.graph.j2d.jar)

Note: Before SAS 9.1, treeview.jar and constapp.jar also contained the classes that are now included in the auxiliary JAR files (sas.graph.nld.jar and sas.graph.j2d.jar). Although you can continue to use the older JAR files by specifying ARCHIVE=treeview.jar or ARCHIVE=constapp.jar, future versions may not support these older JAR files. [cautionend]

Used by:

DS2TREE, DS2CONST

AWUNITS=PIXELS | PERCENT

specifies the units of the WIDTH= argument. The default value is PIXELS. See also the HEIGHT= and AHUNITS= arguments.

Used by:

DS2TREE, DS2CONST

CODEBASE=path-or-URL

specifies the path of the SAS Java archives specified in the ARCHIVE= argument.

The CODEBASE argument is required. You can specify CODEBASE="." if the HTML file and Java archive files are in the same directory.

Note: You can specify the location pointed to by the SAS system option APPLETLOC=, or you can specify a different location. To display the current value of APPLETLOC, run the following code:

proc options option=appletloc;
run;

The value of the APPLETLOC system option is not used as the default value. [cautionend]

Used by:

DS2TREE, DS2CONST

HEIGHT=applet-height

specifies the height of the applet window. The unit of measure is pixels unless changed by the AHUNITS= argument. The default value is 600 for all macros.

Used by:

DS2TREE, DS2CONST

HSPACE=pixels

specifies the amount of horizontal space, in pixels, to the left and right of the graph or diagram.

Used by:

DS2TREE, DS2CONST

NAME=applet-name

specifies the name for this instance of the applet. You need to use this argument only if you have more than one instance of the APPLET tag in your HTML file, and if you have included your own scripts or DHTML that communicates with or acts on a particular instance of the applet.

Used by:

DS2TREE, DS2CONST

VSPACE=pixels

specifies the amount of vertical space, in pixels, to the top and bottom of the graph or diagram.

Used by:

DS2TREE, DS2CONST

WIDTH=applet-width

specifies the width of the applet window. The unit of measure defaults to pixels unless specified by the AWUNITS= argument.

Used by:

DS2TREE, DS2CONST

DS2TREE and DS2CONST Arguments for Data Definition

The following arguments for the DS2TREE and DS2CONST macros define how the applet will use the data set to generate the node/link diagram.

For DS2TREE the arguments NDATA and NID are required.

For DS2CONST the arguments NDATA, NID, LDATA, and LTO are required.

DATATYPE=ARCS | ASSOC | HIER

specifies the type of the XML data. Valid values are defined as follows:

ARCS: indicates that the data set is in the form of an arc list. This is the default value.
ASSOC: indicates that the data set is associative. The links can be displayed based on their weighted values, and node size and link width can represent the relative size of the node and link values.
HIER: indicates that the data set is hierarchical.

Used by:

DS2CONST

LABELS=Y | N

indicates whether or not node labels are displayed in the diagram. The default value is Y.

Used by:

DS2CONST, DS2TREE

LAYOUT=AUTO | USER

when the value is AUTO (default), specifies that the Constellation Applet lays out the diagram using stress and strain equations. Specifying the value USER indicates that the node positions are specified in the NX and NY arguments.

Used by:

DS2CONST

LCOLOR=variable-name

specifies the name of the variable that determines the color of the link lines. The values of this variable must be HTML 3.2 color names, or you must use the LCOLFMT= argument to convert those values to valid color names. The default color is provided by the CLINK= argument (see DS2TREE and DS2CONST Arguments for Diagram Appearance).

In the DS2CONST macro, the LCOLOR= argument is overridden by the LCOLVAL= argument.

Used by:

DS2CONST, DS2TREE

LCOLFMT=user-defined-format-name

specifies the name of a user-defined SAS format that converts the values in the variable named in the LCOLOR= argument to valid HTML color names. Note that the SAS format does not change any values in the data set. The formatted values are applied to the diagram only.

Used by:

DS2CONST, DS2TREE

LCOLVAL=variable-name

specifies the name of the variable that determines the color mapping of link lines. This argument is valid only when the value of the DATATYPE= argument is ASSOC, and only when the value of the COLORMAP= argument is Y. If the LCOLVAL= argument is not specified, the link colors are determined by the following arguments in the following order: LCOLOR= (see above) and CLINK= (see DS2TREE and DS2CONST Arguments for Diagram Appearance).

Used by:

DS2CONST

LDATA=data-set-name

specifies the name of the SAS data set that contains the link data that is used to generate the diagram.

This argument is required.

Used by:

DS2CONST

LFROM=variable-name

specifies the name of the variable whose values define the nodes at the start of link lines. The LFROM variable values must be coordinated with the values of the variables that are named in the NID= and LTO= arguments.

This argument is required.

Used by:

DS2CONST

LINKTYPE=LINE | ARROW

when the value is ARROW (default), indicates that link lines are to be drawn with arrowheads that indicate the direction of flow.

Used by:

DS2CONST

LPT=password

specifies the password that is needed for accessing a password-protected link data set (specified with the LDATA= argument). The LPT= argument is required if the data set has a READ or PW password. You do not need to specify this argument if the data set has a WRITE or ALTER password.

Used by:

DS2CONST

LSTIP=variable-name

specifies the name of the variable in the data set that determines the stipple mask. The stipple mask generates dashed or dotted link lines. The value of the variable must be an integer, which is then converted into a binary value. In the binary value, a "1" bit means that a pixel is to be drawn and a "0" bit means that no pixel is to be drawn. For example, if the variable has a value of 61680, the binary conversion of that value will be 1111000011110000. This stipple mask generates a dashed link line with dashes and spaces that are four pixels wide. See also the LSTIPFAC= argument.

Used by:

DS2CONST, DS2TREE

LSTIPFAC=variable-name

specifies the name of the variable in the data set whose value specifies a multiplier for the binary stipple mask (see the LSTIP= argument). The multiplier lengthens the dashes in the base mask. For example, if the multiplier is 2, a stipple mask that specifies 4-pixel dashes and 4-pixel spaces will generate link lines with 8-pixel dashes and spaces.

Used by:

DS2CONST, DS2TREE

LTIP=variable-name

specifies the name of the variable in the data set that provides the text that is displayed in the pop-up data tips windows for links.

Used by:

DS2CONST, DS2TREE

LTIPFMT=user-defined-format-name

specifies the name of a user-defined SAS format that is applied to the values in the variable specified in the LTIP= argument to configure those values for display in the pop-up data tips window. Note that the SAS format does not change any values in the data set. The formatted values are applied to the diagram only.

Used by:

DS2CONST, DS2TREE

LTO=variable-name

specifies the name of the variable whose values identify the nodes at the ends of link lines. The LTO variable values must be coordinated with the values of the variables that are named in the LFROM and NID arguments.

This argument is required.

Used by:

DS2CONST

LVALUE=variable-name

specifies the name of the variable whose values determine the weights of the link lines, which determines the color and relative thickness of link lines. The variable values must be real numbers. The link weights are used with the MINLNKWT= argument (see below) and the SCLNKWT= argument (see DS2TREE and DS2CONST Arguments for Diagram Appearance) to control the display of link lines. The LVALUE= argument is valid only when the value of the DATATYPE= argument is ASSOC.

Used by:

DS2CONST

LWHERE=subset-expression

specifies a WHERE clause that subsets the link data for display in the diagram. If the expression contains any special characters (for example, % or &), include %NRBQUOTE in the expression to process those characters correctly. The following example shows how to correctly specify INT%:

LWHERE=%NRBQUOTE(value="Int%")

See also the LWHERE= argument.

Used by:

DS2CONST, DS2TREE

NX=variable-name NY=variable-name

specify the variables that determine the locations of the centers of the nodes. These arguments are valid only when the LAYOUT= argument is set to USER. The values are expressed in pixels. Positive values are measured from the top-left corner of the screen. Negative values are measured from the bottom-right corner of the screen.

Used by:

DS2CONST

Arguments for Generating HTML and XML Files

The following arguments determine the name, storage location, and file makeup of Web presentations that run in the Constellation Applet or the Treeview Applet.

HTMLFILE=external-filename

specifies the name and storage location of the HTML output file. If the external file does not exist, then it is created for you. Either this argument, or HTMLFREF=, is required if you specify MAKEHTML=Y. Note: Do not use the HTMLFILE= argument if you use the HTMLFREF= argument.

Used by:

DS2TREE, DS2CONST

HTMLFREF=fileref

specifies the SAS fileref that identifies the name and storage location of the HTML output file. If the external file does not exist, then it is created for you. Either this argument, or HTMLFILE=filename, is required if you specify MAKEHTML=Y. Note: Do not use the HTMLFREF= argument if you use the HTMLFILE= argument, and do not use a reserved name (see Reserved Names).

Used by:

DS2TREE, DS2CONST

MAKEHTML=Y | N

specifies whether or not an HTML file is to be generated. The default value is Y, which generates the HTML output file. If you specify MAKEHTML=N and MAKEXML=Y, then only an XML file is generated.

Used by:

DS2TREE, DS2CONST

MAKEXML=Y | N

specifies whether or not an XML file is to be generated. The default value is Y, which generates the XML output file. If you specify MAKEXML=N and MAKEHTML=Y, then only an HTML file will be generated. Note that under these circumstances, you must specify a value for the XMLURL= argument.

Used by:

DS2TREE, DS2CONST

OPENMODE=REPLACE | APPEND

indicates whether the new HTML or XML output or both overwrites the information that is currently in the specified file(s), or if the new output is appended to the end of the existing file(s). The default value is REPLACE. Specify APPEND to add your new HTML-enhanced output to the end of an existing file. Note: OPENMODE=APPEND is not valid if you are writing your resulting HTML to a partitioned data set (PDS) on z/OS.

Used by:

DS2TREE, DS2CONST

RUNMODE=B | S

specifies whether you are running the DS2TREE macro in batch or server mode. Batch mode (RUNMODE=B, the default) means that you are submitting the DS2TREE macro in the SAS Program Editor or you have included it in a SAS program. Server mode (RUNMODE=S) generates the HTTP header that is required by Application Dispatcher in the SAS/INTRNET software.

Used by:

DS2TREE, DS2CONST

XMLFILE=external-filename

specifies the name and storage location of the XML output file. If the external file does not exist, then it is created for you. This argument, or XMLFREF=, is required if you specify MAKEXML=Y and XMLTYPE=EXTERNAL. Note: Do not use the XMLFILE= argument if you use the XMLFREF= argument.

Used by:

DS2TREE, DS2CONST

XMLFREF=fileref

specifies the SAS fileref that identifies the name and storage location of the XML output file. If the external file does not exist, then it is created for you. This argument, or XMLFILE=, is required if you specify MAKEXML=Y and XMLTYPE=EXTERNAL. Note: Do not use the XMLFREF= argument if you use the XMLFILE= argument, and do not use a reserved name (see Reserved Names).

Used by:

DS2TREE, DS2CONST

XMLTYPE=INLINE | EXTERNAL

specifies whether the XML output file is to be written to an external file or included inline with the HTML. The default value is INLINE. If you specify EXTERNAL you must also specify a value for either the XMLFILE= or XMLFREF= arguments. This argument is required if you specify MAKEXML=Y.

Used by:

DS2TREE, DS2CONST

XMLURL=URL

specifies the URL of the existing file that contains the XML tags that define the node/link diagram. This argument is required if specified XMLTYPE=EXTERNAL.

Used by:

DS2TREE, DS2CONST

DS2TREE and DS2CONST Arguments for Diagram Appearance

The following arguments for the DS2TREE and DS2CONST macros specify non-default behavior and appearance of the node/link diagram in the respective applet.

None of the following arguments are required.

ACTION=text

specifies the default text that is displayed in a pop-up menu when the Web user selects a node with the right mouse button. Selecting this menu option displays the URL that is associated with that node in the NURL= argument. This argument is overridden by the NACTION= argument (see DS2TREE and DS2CONST Arguments for Data Definition). The ACTION= argument is useful when you want to use a single menu text string for most of the nodes in your diagram. The default menu option text is Open URL.

Used by:

DS2CONST, DS2TREE

ANGLE=link-angle

works with the TREESPAN= argument to determine the direction of growth for the diagram. The ANGLE= argument is valid only when you do not specify the TREEDIR= argument. The TREESPAN= argument defines the angular width of the tree (narrow or wide layout). The TREESPAN angle can be visualized as a V shape, with the starting node positioned at the base of the V. The rest of the nodes are laid out between the spreading arms of the V. The ANGLE= argument specifies the angle of the V shape. By default, the value of the ANGLE= argument is zero (0) and the V shape opens to the right, as if the letter V was rotated 90 degrees clockwise, to the three-o'clock position. Values of the ANGLE= argument that are greater than zero rotate the V shape counterclockwise away from the three-o'clock position. Valid values for the ANGLE= argument range from zero (0) to 360 degrees.

Used by:

DS2TREE

BORDER=Y | N

specifies whether or not a border is drawn around the background area. The default value is N.

Used by:

DS2CONST, DS2TREE

CATEXT=default-text-color

specifies a default color for the text in the diagram, using an HTML 3.2 color name or a 6-digit hexadecimal RGB value. For DS2CONST, this argument is overridden by the FNTNAME= argument (see below) and the NTEXTCOL argument (see DS2TREE and DS2CONST Arguments for Data Definition).

Used by:

DS2CONST, DS2TREE

CBACK=color

specifies a background color for the Treeview Applet. The value must be a valid HTML 3.2 color name.

Used by:

DS2TREE

CHANDLE=color

specifies the color of the Collapse/Expand handle on the nodes. The handle is represented by a small plus sign (+) that is prefixed to the label of the node when its subtree is collapsed. The value must be a valid HTML color name.

Used by:

DS2TREE

CLINK=default-link-color

specifies a default color for the links in the diagram, using an HTML 3.2 color name or a 6-digit RGB value. For DS2CONST, this argument is overridden by the LCOLOR= and LCOLVAL= arguments (see DS2TREE and DS2CONST Arguments for Data Definition).

Used by:

DS2CONST, DS2TREE

CNODE=color

specifies the node background color. The value must be a valid HTML color name. The value specified here can be overridden by specifying a value for the NCOLOR= argument.

Used by:

DS2TREE

CNODE=default-node-color

specifies a default background color for the nodes, using an HTML 3.2 color name or a 6-digit RGB value. This argument is overridden by the NCOLOR=, NCOLVAL=, NVALUE=, or NSCBACK= arguments (see DS2TREE and DS2CONST Arguments for Data Definition).

Used by:

DS2CONST

COLORMAP=N | Y

when the value is N (default), specifies that the Constellation Applet is to use the NCOLOR= and LCOLOR= arguments (see DS2TREE and DS2CONST Arguments for Data Definition) to determine node and link colors rather than using the color map.

Used by:

DS2CONST

CSELECT=color

specifies a color for nodes that are selected by the mouse or as the result of a node search. The value must be a valid HTML 3.2 color name.

Used by:

DS2CONST, DS2TREE

CUTOFF=detail-percentage

specifies the percentage of the nodes that will be displayed with node labels. After the percentage has been reached, nodes are drawn as rectangles. The size of those rectangles decreases as the distance from the starting node increases. Valid values range from 0.0 to 1.0 (The decimal value is mapped to a percentage from 0% to 100%). The default value is 0.5. See also the DEPTH argument.

Used by:

DS2CONST, DS2TREE

DEPTH=max-path-length

specifies a whole number greater than zero that determines the maximum number of links that are to be displayed in the node/link diagram. Paths whose lengths exceed the limit are truncated. This argument affects only the initial display of the diagram. Nodes that are initially hidden can become visible as a user selects nodes and navigates around the diagram.

Note that this value is ignored if CUTOFF= 1.0. There is no default value for this argument.

Used by:

DS2TREE

DRILTARG=target-window-or-frame

specifies the HTML target or the name of the browser window or frame where drill-down URLs are displayed. The default behavior is to open a new browser window and reuse it for subsequent drill-down requests. Specifically, the default value is _BLANK, which is one of several reserved names for targets in HTML. The value can also be the name of a window or frame in the Web presentation.

Used by:

DS2CONST, DS2TREE

DUPCHECK=TRUE | FALSE

specifies whether or not the applet will check for duplicate node IDs. The default value is FALSE. When set to TRUE, this argument will cause the applet to update an ID if a duplicate ID is found, instead of creating a new node with the same ID. This enables you to collect node information from different locations in the data set.

Used by:

DS2TREE

FACTOR=fish-eye-distortion-factor

specifies the distortion factor for the fish-eye lens. The distortion factor determines the amount that the central region of the display is to be expanded (or zoomed). The value specified must be greater than or equal to 1.0. The default value is 1.0, which represents the lowest amount of distortion. This argument is valid only when the value of the FISHEYE= argument is Y. The maximum effective value (beyond which no further distortion is visible) is variable depending upon the number of nodes in the diagram.

Used by:

DS2TREE

FISHEYE=Y | N

indicates whether or not the diagram is to be displayed with the fish-eye distortion, which displays the central region of the diagram at a specified size and displays the rest of the diagram as if it were mapped onto a ball, with the nodes and links disappearing over a curved horizon. The Web user can move the diagram past the central region by scrolling or searching for nodes. The amount of distortion used in the fish-eye lens is determined by the FACTOR= argument. The default value is Y.

Used by:

DS2TREE

FNTNAME=default-node-label-font

specifies the default text font for node labels. Valid values can be SERIF, SANSSERIF, DIALOG, DIALOGINPUT, or MONOSPACED. This argument is overridden by the NFNTNAME or NSFNTNAM= arguments (see DS2TREE and DS2CONST Arguments for Data Definition).

Used by:

DS2CONST, DS2TREE

FNTSIZE=node-font-size

specifies the size of the node label text font, in points. This argument is overridden by the NFNTSIZE= argument.

Used by:

DS2CONST, DS2TREE

FNTSTYL=node-font-style

specifies the text font style for node labels. Valid values are BOLD, ITALIC, and PLAIN. PLAIN is the default value. This argument is overridden by the NFNTSTYL= argument.

Used by:

DS2CONST, DS2TREE

IBACKLOC=image-URL

specifies a URL for the image that you want to use in the background of the diagram. See also the IBACKPOS= argument.

Used by:

DS2CONST, DS2TREE

IBACKPOS=CENTER | SCALE | TILE | POSITION

specifies how to display the background image in the IBACKLOC= argument. Specify one of the following options:

CENTER: centers the image in the browser window without resizing the image.
SCALE: resizes the image to fit the browser window.
TILE: fills the browser window by replicating the image at its original size.
POSITION: positions the image without resizing at the values specified by the IBACKX= and IBACKY= arguments.

Used by:

DS2CONST, DS2TREE

IBACKURL=background-drilldown-URL

specifies the URL that is displayed when you click on the background image. This argument is valid only when the value of the IBACKPOS= argument is POSITION. If you are including the Powered by SAS logo, then you must use this argument to link the image to the SAS Web site.

Used by:

DS2CONST, DS2TREE

IBACKX=corner-coordinate IBACKY=corner-coordinate

specifies the x (horizontal) and y (vertical) pixel coordinates of the upper left-hand corner of the background image. Positive values are measured from the upper-left corner of the background area. Negative values are measured from the lower-right corner of the background area. These values are valid only if the value of the IBACKPOS= argument is POSITION. Always specify both the IBACKX= and IBACKY= arguments.

Used by:

DS2CONST, DS2TREE

NODEBDR=LINE | NONE | FILL | OUTLINE

specifies the appearance of the node border line, using one of the following values:

LINE: show solid border lines around the nodes.
NONE: show no border lines or background.
FILL: show background but no border lines.
OUTLINE: show a border line and background. This is the default value.

Used by:

DS2TREE

NODESHAP=shape

specifies the shape of the nodes. Valid values can be CIRCLE, DIAMOND, NONE, SQUARE, or TRIANGLE. The default value is SQUARE. This argument is overridden by the NSHAPE= argument (see DS2TREE and DS2CONST Arguments for Data Definition).

Used by:

DS2CONST

RBSIZING=Y | N

the default value N indicates that size information from the resource bundle is not to be used for sizing the two dialog boxes that can be invoked from the pop-up menu that appears when a user right-mouse-clicks on a diagram. The two dialog boxes are the About dialog box and the Mouse Help dialog box.

Specify Y for this argument for languages other than English.If you specify Y, then the height and the width of the dialog box frames are read in from the resource bundle. This allows translators to set appropriate heights and widths for the frames in the resource bundle, based on the length of the message strings in each language.

Used by:

DS2CONST, DS2TREE

SCLNKWT=Y | N

when the value is Y (default), specifies that the link weight values are to be scaled into the range of 0-1, which corresponds to 0-100%. When SCLNKWT=Y, the scroll bar in Constellation Applet displays a percentage of the range of the link weights. When SCLNKWT=N, the link weights are not scaled and the scroll bar reflects the actual link weight data values. These values are real numbers that are specified in the LVALUE= argument (see DS2TREE and DS2CONST Arguments for Data Definition). The SCLNKWT= argument is valid only when the value of the DATATYPE= argument is ASSOC. Note that the range of link weights (maximum minus minimum) must be greater than 2 when SCLNKWT=N. Otherwise, the scroll bar will not correctly map the link weights.

Used by:

DS2CONST

SCLWIDTH=Y | N

when the value is Y (default), indicates that the link width values are to be scaled into the range of 0-1. Specifying N indicates that the link widths are already scaled into that range. This argument is valid only when the value of the DATATYPE= argument is ASSOC.

Used by:

DS2CONST

SCNSIZE=Y | N

when the value is Y (default), indicates that the node size values are to be scaled into the range of 0-1. Specifying N indicates that the node sizes are already scaled into that range. This argument is valid only when the value of the DATATYPE= argument is ASSOC. Node sizes are specified with the NSIZE= argument (see DS2TREE and DS2CONST Arguments for Data Definition).

Used by:

DS2CONST

SHOWLINKS=Y | N

specifies whether initially to display all arc lines between nodes. Specifying N suppresses all arc lines. The default value is Y.

Note: This argument affects only the initial display. A viewer can subsequently control which arc lines are displayed by right-mouse clicking and selecting a Show links option from the pop-up menu. [cautionend]

Used by:

DS2CONST

SPREAD=angular-factor

specifies the angular spreading factor for the layout of the diagram. The value specified must be greater than or equal to 1.0. The default value is 1.25.

Used by:

DS2TREE

TIPS=Y | N

indicates whether or not pop-up data tips are displayed when the cursor is positioned over nodes or links or both. The default value is Y.

Used by:

DS2CONST, DS2TREE

TIPTYPE=TRACKING | STATIONARY

when the value is TRACKING (default), indicates that the pop-up data tips windows are to move with the cursor while the cursor moves within the area of a single node or link.

Used by:

DS2CONST

TREEDIR=C | D | L | R | U

determines the growth direction of the node/link diagram using the following values.

C | CIRCULAR: grows the tree in a circular pattern. This is the default value.
D | DOWN: grows the tree from top to bottom using center alignment.
L | LEFT: grows the tree from left to right and top to bottom.
R | RIGHT: grows the tree from right to left and top to bottom.
U | UP: grows the tree from the bottom up using center alignment.

If the value of the TREEDIR= argument is UP or DOWN, then the value of the TREESPAN= argument is used to set the angular width of the diagram. The starting node is aligned horizontally in the center of the applet. The diagram grows out of the starting node based on the angular width specified in the TREESPAN= argument. The wider the angle, the wider the layout of the diagram.

The TREEDIR= argument overrides the ANGLE= argument.

Used by:

DS2TREE

TREESPAN=angular-diagram-width

specifies the angular width of the diagram in degrees. Valid values must be greater than zero and less than 360. The default value is 60. For details, see the TREEDIR= and ANGLE= arguments.

Used by:

DS2TREE

ZOOM=starting-percentage

specifies the zoom value that is used for the initial display of the diagram. After the initial display, the Web user can change the zoom percentage dragging the mouse up and down while pressing the Ctrl + left mouse button. Selecting the Refresh button on the browser runs the applet and restores the initial zoom setting. The default value is 100 percent. The initial diagram can be scaled up with a value greater than 100 or scaled down with a value less than 100.

Used by:

DS2CONST

Arguments for Page Formatting

The following arguments format the HTML output file. The rendering of some of these arguments may vary in certain browsers. Several of the following arguments apply only to certain macros, as noted in the descriptions of the arguments.

The BGTYPE=, BRTITLE=, CENTER=, CTEXT=, and DOCTYPE= arguments apply to the entire page for the current invocation of the macro. If you append data to an existing HTML page, then the HTML formatting will not change. You may want to use these arguments only when you replace, rather than append, HTML files.

BDCLASS=body-stylesheet-name

specifies the name of the stylesheet that is to be applied to the body of the HTML output file.

Used by:

DS2TREE, DS2CONST

BG=color-or-image

specifies the background color or image, based on the value of the BGTYPE= argument. The color can be specified as an HTML 3.2 color name or as a 6-digit hexadecimal RGB value. When BGTYPE=IMAGE, this argument specifies a background image, using a path or a URL, relative or absolute.

Used by:

DS2TREE, DS2CONST

BGTYPE=NONE | COLOR | IMAGE

specifies the background type, using one of the following values:

NONE: causes the applet to display its default background color. This is the default value.
COLOR: specifies that the value of the BG= argument must be an HTML 3.2 color name or hexadecimal RGB value.
IMAGE: specifies that the value of the BG= argument must be the path or URL pointing to an image file that will be displayed in the background of the applet window.

Used by:

DS2TREE, DS2CONST

BRTITLE=browser-window-title

specifies the text that appears in the title bar of the browser window. By default, no title is displayed.

Used by:

DS2TREE, DS2CONST

CENTER= Y | N

specifies whether or not the graph or diagram is centered in the browser window. The default value is N.

Used by:

DS2TREE, DS2CONST

CTEXT=default-text-color

specifies a default text color that replaces the default text color in the browser. Other color arguments can be used to override this new default. The color can be specified as an HTML 3.2 color name or as a six-digit hexadecimal RGB value.

Used by:

DS2TREE, DS2CONST

DOCTYPE=DOCTYPE-tag

generates the following DOCTYPE tag by default, which specifies HTML version 3.2:

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

To use a different DOCTYPE tag, specify the entire contents of the tag as the value of the DOCTYPE= argument, including the angle brackets.

If you specify DOCTYPE="", then no DOCTYPE tag is generated in the HTML output file.

Used by:

DS2TREE, DS2CONST

ENCODE=Y | N

when the value is Y (default), replaces the angle bracket characters (< and >) in SAS TITLE and FOOTNOTE lines with the HTML character entities (> and <) respectively. Specifying ENCODE=N causes the browser to interpret the angle brackets as parts of HTML tags. For example, you would use ENCODE=N if you wanted to use the following TITLE statement:

title "<FONT COLOR="red">Out of Range Data</FONT>";

Used by:

DS2TREE, DS2CONST

PAGEPART=ALL | HEAD | BODY | FOOT

specifies which part or parts of the HTML page are to be written into the HTML output file. This argument is helpful when are appending HTML output to the end of an existing HTML file, or when you are using separate files for the head, body, and foot of your Web page.

ALL: writes the entire HTML file, including the XML tags for the DS2CONST and DS2TREE. This is the default value. Do not use this value if you are appending an existing HTML file.
HEAD: writes the HTML header information and or XML (for DS2CONST and DS2TREE) into the HTML file. The header information consists of the HEAD and BODY tags. HTML footer information is not included.
BODY: writes only the XML tags (for DS2CONST and DS2TREE) into the HTML output file. No head or foot information is generated in the HTML output file.
FOOT: writes metagraphics codes or XML tags and the </BODY> and </HTML> tags to conclude the HTML file.

Used by:

DS2TREE, DS2CONST

SASPOWER=logo-image-file

specifies the path or URL, relative or absolute, to the image file of the SAS Powered logo. In the HTML file, the image appears at the bottom of the page. Selecting the image displays the SAS home page. By default, the logo is omitted. To obtain the logo image file, see http://www2.sas.com/dispatcher/index.html. See also the SPCLASS= argument.

Used by:

DS2TREE, DS2CONST

SEPCLASS=page-separator-stylesheet

specifies the path or URL, relative or absolute, to the style sheet that is used for the page separator. If the value of the SEPTYPE= argument is RULE, then the value of the SEPCLASS= argument is used on the CLASS attribute of the HTML tag <HR>. If the value of the SEPTYPE= argument is IMAGE, then the value of SEPCLASS= argument is used on the CLASS attribute of the HTML tag <IMG>.

Used by:

DS2TREE, DS2CONST

SEPLOC=separator-image

specifies the path or URL, relative or absolute, to the image that you want to use as the separator between the graphs in your presentation. This argument is valid only if the value of the SEPTYPE= argument is IMAGE.

Used by:

DS2TREE, DS2CONST

SEPTYPE= IMAGE | NONE | RULE

specifies the type of separator that is used between multiple applets in your presentation. The valid values are defined as follows:

IMAGE: specifies separate graphs using the image specified in the SEPLOC= argument.
NONE: specifies not to use a separator between applets.
RULE: inserts a line between applets. This is the default.

Used by:

DS2TREE, DS2CONST

SPCLASS=logo-stylesheet-name

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

Used by:

DS2TREE, DS2CONST

Arguments for Stylesheets

DS2CONT and DS2TREE enable the following arguments for style sheet specifications in the HTML output file. See also the BDCLASS=, SEPCLASS=, and SPCLASS= arguments in Arguments for Page Formatting.

Style sheet arguments reference style information in one of two ways. Most of the arguments specify parameters in the HTML LINK tag:

<LINK HREF="1qtr98.css" TYPE="text/css" REL="stylesheet">

Use these arguments when you do not want to enter your style information directly into your HTML file when you create that file.

Other arguments embed the style information into the header of the HTML file. Use these arguments when you want to collect style information from multiple style sheets. The end result must create a complete STYLE tag in your HTML file.

You can combine LINK tag arguments with arguments that embed style information, but you cannot use the same ordinal number in two arguments. For example, you can specify the arguments SSHREF1= and SSFILE2=, but you cannot specify SSHREF1= and SSFILE1=.

The following arguments link to two different style sheets and include text comments for each stylesheet.

ssfile1=comments1.txt,     /* embeds text                 */
sshref2=/style/style1.css, /* links to stylesheet         */
sstype2=text/css,          /* parameters for style sheets */
ssrel2=stylesheet,
ssfile3=comments2.txt,     /* embeds text                 */
sshref4=/style/style2.css, /* link to stylesheets         */
sstype4=text/css,
ssrel4=stylesheet,

SSFILE1-SSFILE5=file-specification

embeds in the HTML file the entire contents of the specified file.

Used by:

DS2TREE, DS2CONST

SSFREF1-SSFREF5=fileref

embeds in the HTML file the entire contents of the file that is referenced by the SAS fileref.

Used by:

DS2TREE, DS2CONST

SSHREF1-SSHREF5=style-sheet-URL

specifies the URL of the stylesheet in the HREF= attribute of the LINK tag. If you specify a relative URL, it must be relative to the location of the HTML output file.

Used by:

DS2TREE, DS2CONST

SSMEDIA1-5=media

specifies the media for which the style sheet was designed. The value is applied to the MEDIA= attribute of the LINK tag. The default value is SCREEN. Examples of other valid MEDIA values include BRAILLE for tactile feedback devices, and HANDHELD for small-screen devices.

Used by:

DS2TREE, DS2CONST

SSREL1-5=relationship

specifies the REL= attribute of the LINK tag, which describes the relationship from the linked file to the HTML file. The value of this tag is generally STYLESHEET. The arguments SSREL1-5= can also be used with the arguments SSREV1-5 to link HTML pages in a series. For example, the SSREL1= argument can specify the next document in the series, and the SSREV2= argument can specify the reverse relationship, which would be the previous document in the series. Both arguments, SSRELn= and SSREVn=, can appear in the same LINK tag.

Used by:

DS2TREE, DS2CONST

SSREV1-5=relationship

specifies the REV= attribute of the LINK tag, which describes the relationship from the HTML file to the linked file. See the SSREL1-5= argument for details.

Used by:

DS2TREE, DS2CONST

SSTITLE1-5=title-of-linked-page

specifies the TITLE= attribute of the LINK tag. The TITLE= attribute provides a title for the referenced page. Use this argument when you are using the SSRELn= and SSREVn= arguments to specify next and previous links in a series of Web pages.

Used by:

DS2TREE, DS2CONST

SSTYPE1-5=stylesheet-type

specifies the TYPE= attribute of the LINK tag. For cascading style sheets, this value usually is TEXT/CSS. For JavaScript style sheets, this value is generally TEXT/JAVASCRIPT.

Used by:

DS2TREE, DS2CONST

Arguments for the SAS TITLE and FOOTNOTE Tags

The following arguments determine the content and appearance of the SAS TITLE and FOOTNOTE tags in the HTML output file.

FCLASS=footnote-style-sheet-name TCLASS=title-style-sheet-name

specify the name of the style sheet class that is to be used for the SAS TITLE or FOOTNOTE.

Used by:

DS2TREE, DS2CONST.

FCOLOR=footnote-text-color TCOLOR=title-text-color

specify the color of the text in the SAS TITLE or FOOTNOTE, using an HTML 3.2 color name or a six-digit hexadecimal RGB value.

Used by:

DS2TREE, DS2CONST.

FFACE=footnote-text-font TFACE=title-text-font

specify a text font for the SAS TITLE or FOOTNOTE. Valid values are browser-specific.

Used by:

DS2TREE, DS2CONST.

FSIZE=n | +n | -n TSIZE=n | +n | -n

specify the size of the text font that is to be used for the SAS TITLE or FOOTNOTE, where n is an integer. Valid values are browser-specific depending on how the browser handles the SIZE attribute on the FONT tag.

Used by:

DS2TREE, DS2CONST.

FTAG=tag-string TTAG=tag-string

specify a text string that the macro translates into one or more tags that will enclose the SAS TITLE or FOOTNOTE.

The default value is as follows:

PREFORMATTED + HEADER 3

Used by:

DS2TREE, DS2CONST.

For each possible value of the TTAG= and FTAG= arguments, the following table shows the HTML tags that are generated by the macro for the SAS TITLE and FOOTNOTE lines (the corresponding end tags are generated automatically):

TTAG or FTAG Value	HTML Tag or Tags Enclosing the SAS TITLE or SAS FOOTNOTE
NO FORMATTING	(none)
STRONG	<STRONG>
EMPHASIS	<EM>
HEADER 1	<H1>
HEADER 2	<H2>
HEADER 3	<H3>
HEADER 4	<H4>
HEADER 5	<H5>
HEADER 6	<H6>
PREFORMATTED TEXT	<PRE>
CITATION TEXT	<CITE>
COMPUTER CODE TEXT	<CODE>
KEYBOARD INPUT TEXT	<KBD>
LITERAL TEXT	<SAMP>
VARIABLE TEXT	<VAR>
BOLD	<B>
ITALICIZED TEXT	<I>
UNDERLINE TEXT	<U>
TYPEWRITER	<TT>
BIG TEXT	<BIG>
SMALL TEXT	<SMALL>
STRIKE OUT TEXT	<STRIKE>
DEFINING INSTANCE TEXT	<DFN>
PREFORMATTED + STRONG	<PRE><STRONG>
PREFORMATTED + EMPHASIS	<PRE><EM>
PREFORMATTED + HEADER 1	<PRE><H1>
PREFORMATTED + HEADER 2	<PRE><H2>
PREFORMATTED + HEADER 3	<PRE><H3>
PREFORMATTED + HEADER 4	<PRE><H4>
PREFORMATTED + HEADER 5	<PRE><H5>
PREFORMATTED + HEADER 6	<PRE><H6>
PREFORMATTED + CITATION	<PRE><CITE>
PREFORMATTED + COMPUTER CODE	<PRE><CODE>
PREFORMATTED + KEYBOARD INPUT	<PRE><KBD>
PREFORMATTED + LITERAL	<PRE><SAMP>
PREFORMATTED + VARIABLE	<PRE><VAR>
PREFORMATTED + BOLD	<PRE><B>
PREFORMATTED + ITALICIZED	<PRE><I>
PREFORMATTED + TYPEWRITER	<PRE><TT>
PREFORMATTED + UNDERLINE	<PRE><U>
PREFORMATTED + BIG	<PRE><BIG>
PREFORMATTED + SMALL	<PRE><SMALL>
PREFORMATTED + STRIKE OUT	<PRE><STRIKE>
PREFORMATTED + DEFINING INSTANCE	<PRE><DFN>
STRONG + EMPHASIS	<STRONG><EM>
STRONG + ITALICIZED	<STRONG><I>
STRONG + CITATION	<STRONG><CITE>
STRONG + COMPUTER CODE	<STRONG><CODE>
STRONG + KEYBOARD INPUT	<STRONG><KBD>
STRONG + LITERAL	<STRONG><SAMP>
STRONG + VARIABLE	<STRONG><VAR>
STRONG + TYPEWRITER	<STRONG><TT>
STRONG + BIG	<STRONG><BIG>
STRONG + SMALL	<STRONG><SMALL>
EMPHASIS + CITATION	<EM><CITE>
EMPHASIS + COMPUTER CODE	<EM><CODE>
EMPHASIS + KEYBOARD INPUT	<EM><KBD>
EMPHASIS + LITERAL	<EM><SAMP>
EMPHASIS + VARIABLE	<EM><VAR>
EMPHASIS + TYPEWRITER	<EM><TT>
EMPHASIS + BIG	<EM><BIG>
EMPHASIS + SMALL	<EM><SMALL>
BOLD + EMPHASIS	<B><EM>
BOLD + ITALICIZED	<B><I>
BOLD + CITATION	<B><CITE>
BOLD + COMPUTER CODE	<B><CODE>
BOLD + KEYBOARD INPUT	<B><KBD>
BOLD + LITERAL	<B><SAMP>
BOLD + VARIABLE	<B><VAR>
BOLD + TYPEWRITER	<B><TT>
BOLD + BIG	<B><BIG>
BOLD + SMALL	<B><SMALL>
ITALICIZED + CITATION	<I><CITE>
ITALICIZED + COMPUTER CODE	<I><CODE>
ITALICIZED + KEYBOARD INPUT	<I><KBD>
ITALICIZED + LITERAL	<I><SAMP>
ITALICIZED + VARIABLE	<I><VAR>
ITALICIZED + TYPEWRITER	<I><TT>
ITALICIZED + BIG	<I><BIG>
ITALICIZED + SMALL	<I><SMALL>
STRONG + EMPHASIS + BIG	<STRONG><EM><BIG>
STRONG + CITATION + BIG	<STRONG><CITE><BIG>
STRONG + COMPUTER CODE + BIG	<STRONG><CODE><BIG>
STRONG + KEYBOARD INPUT + BIG	<STRONG><KBD><BIG>
STRONG + LITERAL + BIG	<STRONG><SAMP><BIG>
STRONG + VARIABLE + BIG	<STRONG><VAR><BIG>
STRONG + TYPEWRITER + BIG	<STRONG><TT><BIG>
EMPHASIS + CITATION + BIG	<EM><CITE><BIG>
EMPHASIS + COMPUTER CODE + BIG	<EM><CODE><BIG>
EMPHASIS + KEYBOARD INPUT + BIG	<EM><KBD><BIG>
EMPHASIS + LITERAL + BIG	<EM><SAMP><BIG>
EMPHASIS + VARIABLE + BIG	<EM><VAR><BIG>
EMPHASIS + TYPEWRITER + BIG	<EM><TT><BIG>
BOLD + EMPHASIS + BIG	<BOLD><EM><BIG>
BOLD + ITALICIZED + BIG	<BOLD><I><BIG>
BOLD + CITATION + BIG	<BOLD><CITE><BIG>
BOLD + COMPUTER CODE + BIG	<BOLD><CODE><BIG>
BOLD + KEYBOARD INPUT + BIG	<BOLD><KBD><BIG>
BOLD + LITERAL + BIG	<BOLD><SAMP><BIG>
BOLD + VARIABLE + BIG	<BOLD><VAR><BIG>
BOLD + TYPEWRITER + BIG	<BOLD><TT><BIG>
ITALICIZED + CITATION + BIG	<I><CITE><BIG>
ITALICIZED + COMPUTER CODE + BIG	<I><CODE><BIG>
ITALICIZED + KEYBOARD INPUT + BIG	<I><KBD><BIG>
ITALICIZED + LITERAL + BIG	<I><SAMP><BIG>
ITALICIZED + VARIABLE + BIG	<I><VAR><BIG>
ITALICIZED + TYPEWRITER + BIG	<I><TT><BIG>
STRONG + EMPHASIS + SMALL	<STRONG><EM><SMALL>
STRONG + ITALICIZED + SMALL	<STRONG><I><SMALL>
STRONG + CITATION + SMALL	<STRONG><CITE><SMALL>
STRONG + COMPUTER CODE + SMALL	<STRONG><CODE><SMALL>
STRONG + LITERAL + SMALL	<STRONG><SAMP><SMALL>
STRONG + VARIABLE + SMALL	<STRONG><VAR><SMALL>
STRONG + TYPEWRITER + SMALL	<STRONG><TT><SMALL>
EMPHASIS + CITATION + SMALL	<EM><CITE><SMALL>
EMPHASIS + COMPUTER CODE + SMALL	<EM><CODE><SMALL>
EMPHASIS + KEYBOARD INPUT + SMALL	<EM><KBD><SMALL>
EMPHASIS + LITERAL + SMALL	<EM><SAMP><SMALL>
EMPHASIS + TYPEWRITER + SMALL	<EM><TT><SMALL>
BOLD + EMPHASIS + SMALL	<BOLD><EM><SMALL>
BOLD + ITALICIZED + SMALL	<BOLD><I><SMALL>
BOLD + CITATION + SMALL	<BOLD><CITE><SMALL>
BOLD + COMPUTER CODE + SMALL	<BOLD><CODE><SMALL>
BOLD + KEYBOARD INPUT + SMALL	<BOLD><KBD><SMALL>
BOLD + LITERAL + SMALL	<BOLD><SAMP><SMALL>
BOLD + VARIABLE + SMALL	<BOLD><VAR><SMALL>
BOLD + TYPEWRITER + SMALL	<BOLD><TT><SMALL>
ITALICIZED + CITATION + SMALL	<I><CITE><SMALL>
ITALICIZED + COMPUTER CODE + SMALL	<I><CODE><SMALL>
ITALICIZED + KEYBOARD INPUT + SMALL	<I><KBD><SMALL>
ITALICIZED + LITERAL + SMALL	<I><SAMP><SMALL>
ITALICIZED + VARIABLE + SMALL	<I><VAR><SMALL>
ITALICIZED + TYPEWRITER + SMALL	<I><TT><SMALL>

Arguments for Character Transcoding

The following arguments allow you to specify a character set or convert character data to the corresponding Unicode Numeric Character Reference (NCR).

CHARSET=char-set-name

specifies the character set name that will be written into the META tag of the HTML output file. For information on available character set names, see http://www.iana.org/assignments/character-sets.

Used by:

DS2TREE, DS2CONST, META2HTM

TRANLIST=transcoding-list-name

specifies the name and location of an existing transcoding list, either user-defined or from SAS. The transcoding list name must be a four-level name, and the fourth level must be SLIST, as in the following example:

TRANLIST=SASHELP.HTMLGEN.IDENTITY.SLIST

This argument is required if you are implementing character transcoding.

SAS provides a number of transcoding lists in the SASHELP.HTMLNLS catalog. For a description of these transcoding lists, and for information on generating your own transcoding lists, see the SAS Web site at http://support.sas.com/rnd/web/intrnet/format/lang2.html.

Used by:

DS2TREE, DS2CONST, META2HTM

Reserved Names

Do not use the following names as the value of a macro variable:

Libnames and Filerefs

	HTML
	CATENT
	HTMSS

Global Macro Variables

	_htmovp
	_htmcap
	_htmtitl
	_htmwher

Data Sets or Views

WORK._BYGRP

Catalogs

	WORK._HTMLG_
	SASHELP.HTMLNLS

Catalog Entries

	SASHELP.HTMLGEN.DSPROP.SLIST
	SASHELP.HTMLGEN.IDENTITY.SLIST
	SASHELP.HTMLGEN.OUTPROP.SLIST
	SASHELP.HTMLGEN.TABPROP.SLIST
	SASHELP.HTMLGEN.TAGS.SLIST

Top of Page