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 and link diagram.
Note: For DS2TREE, the arguments NDATA and NID are required.
Note: For DS2CONST, the arguments NDATA, NID, LDATA, and LTO are required.
DATATYPE=ARCS | ASSOC
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.
Used by:DS2CONST
LABELS=Y | N
indicates whether 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 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 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.
Used by:DS2CONST
Requirement:This argument is required.
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.
Used by:DS2CONST
Requirement:This argument is required.
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.
Used by:DS2CONST
Requirement:This argument is required.
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 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 NWHERE argument.
Used by:DS2CONST
LWIDTH=variable-name
specifies the name of the variable in the data set that determines the width of the link lines.
For DS2CONST: When this argument is not specified, the width is determined by the LVALUE argument. This argument is valid for DS2CONST only when the value of the DATATYPE argument is ASSOC.
For DS2TREE: This option maps the range of values of the specified variable to a range of link widths. If this option is not specified or if only one link width value is provided for all of the links, then the width of all of the links is set to the minimum link width in the pixel range.
Used by:DS2CONST, DS2TREE
MINLNKWT=minimum-link-weight
specifies the initial minimum link weight, which determines which links are initially displayed. The initial diagram show only those links that have weights that are greater than or equal to the minimum weight. In the Constellation Applet, a scroll bar allows the Web user to change the minimum link weight to change the number of links that are displayed. Selecting the browser's Refresh option restores the initial minimum link weight that is specified in the MINLNKWT argument. Link weights are determined by the LVALUE argument. This argument is valid only when the value of the DATATYPE argument is ASSOC.
Used by:DS2CONST
NACTION=variable-name
specifies the name of the variable in the nodes data set that provides the menu text that is displayed when the Web user selects a node with the right mouse button. Selecting this menu option text displays the URL that is associated with that node in the NURL= argument. This argument overrides the ACTION= argument (see Arguments for Diagram Appearance). The default menu option text is Open URL.
Used by:DS2CONST, DS2TREE
NCOLFMT=SAS-format-name
specifies the name of a user-defined SAS format that converts the values in the variable named in the NCOLOR= argument to valid HTML color names. Note that the data in the data set is not altered; the formatted value is used in the hierarchical tree rather than the data value.
Used by:DS2TREE
NCOLOR=variable-name
specifies the variable in the nodes data set that determines the background color of the nodes, using HTML 3.2 color names or 6-digit hexadecimal RGB values . If the variable does not contain valid HTML color names, then you can use the NCOLFMT=argument to convert those values to the HTML color names. See also the NCOLVAL= and NVALUE=arguments.
Used by:DS2CONST, DS2TREE
NCOLVAL=variable-name
specifies the name of the variable in the nodes data set that determines the color mapping for the nodes. This argument is valid only when the DATASET= argument is set to ASSOC, and only when the value of the COLORMAP= argument is Y. If this argument is not specified, then the node color is determined by the LVALUE= argument.
Used by:DS2CONST
NDATA=SAS-data-set-name
specifies the SAS data set that contains the node data.
Used by:DS2CONST, DS2TREE
Requirement:This argument is required.
NFNTNAME=node-font-variable-name
specifies the name of the variable that determines the text font for the node labels. The variable value can be SERIF, SANSSERIF, DIALOG, DIALOGINPUT, or MONOSPACED. The default node font is specified by the FNTNAME= argument (see Arguments for Diagram Appearance).
Used by:DS2CONST, DS2TREE
NFNTSIZE=variable-name
specifies the name of the variable in the nodes data set that determines the size of the text font used for node labels. This font size is expressed in points. This argument overrides the FNTSIZE= argument.
Used by:DS2CONST, DS2TREE
NFNTSTYL=node-font-style-variable-name
specifies the name of the variable that determines the font style for the node label. The valid values that can be assigned to the variable are BOLD, ITALIC, and PLAIN.
Used by:DS2CONST, DS2TREE
NID=variable-name
specifies the name of the variable in the nodes data set whose values are to be illustrated as the nodes in the diagram. The node ID variable type can be either numeric or character. For the DS2CONST macro, the values of the NID variable must be coordinated with the values of the LFROM and LTO variables.
This argument is required.
Used by:DS2CONST, DS2TREE
NLABEL=node-label-variable-name
specifies the name of the variable that represents the node labels. This variable type can be either numeric or character.
Used by:DS2CONST, DS2TREE
NPARENT=node-parent-variable-name
specifies the name of the variable that represents the parent nodes. This variable type can be either numeric or character.
Used by:DS2TREE
NPW=password
specifies the password that is needed for accessing a password-protected data set. This 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 only WRITE or ALTER passwords.
Used by:DS2CONST, DS2TREE
NSCBACK=variable-name
specifies the name of the variable in the node styles data set that determines the background color of the nodes. The variable values must be HTML 3.2 color names. The default value is determined by the CNODE= argument (see Arguments for Diagram Appearance).
Used by:DS2CONST, DS2TREE
NSCTEXT=variable-name
specifies the name of the variable in the node styles data set that provides the colors for the node label text. Valid variable values must be HTML 3.2 color names. The default color is provided by the CATEXT= argument.
Used by:DS2CONST, DS2TREE
NSDATA=SAS-data-set-name
specifies the name of the node styles data set.
Used by:DS2CONST, DS2TREE
NSFNTNAM=variable-name
specifies the name of the variable in the node styles data set that determines the text font that is to be used for node labels. Valid variable values can be SERIF, SANSSERIF, DIALOG, DIALOGINPUT, or MONOSPACED. This argument overrides the FNTNAME= argument.
Used by:DS2CONST, DS2TREE
NSFNTSIZ=variable-name
specifies the name of the variable in the node styles data set that determines the size of the node label text, in points. This argument overrides the FNTSIZE= argument.
Used by:DS2CONST, DS2TREE
NSFNTSTY=variable-name
specifies the name of the variable in the node styles data set that determines the style of the node label text. Valid variable values can be BOLD, ITALIC, or the default value, PLAIN. This argument overrides the FNTSTYL= argument.
Used by:DS2CONST, DS2TREE
NSHAPE=variable-name
specifies the name of the variable that determines the shape of the nodes. Valid variable values can be CIRCLE, DIAMOND, NONE, SQUARE, or TRIANGLE. The default value is SQUARE. This argument overrides the NODESHAP= argument.
Used by:DS2CONST
NSID=variable-name
specifies the name of the variable in the node styles data set that represents the nodes.
Used by:DS2CONST, DS2TREE
NSIZE=variable-name
specifies the name of the variable that determines the size of the nodes. The values of this variable can be real numbers. Node sizes are determined based on the value of the LAYOUT= argument. When LAYOUT=USER, the values of the NSIZE variable are interpreted as literal pixel measurements. When LAYOUT=AUTO, the values of the NSIZE variable determine the size of the nodes based on the relative size of individual values. The values of the NSIZE variable can be scaled with the SCNSIZE= argument (see Arguments for Diagram Appearance). This argument is valid only when the value of the DATATYPE= argument is ASSOC.
Used by:DS2CONST
NSPW=password
specifies the password that is needed to access a password-protected node styles data set. This 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 only WRITE or ALTER passwords.
Used by:DS2CONST, DS2TREE
NSTYLE=variable-name
specifies the name of the variable that determines the style of the nodes. This variable type can be either numeric or character, and the values must correspond to the node identifiers specified in the NSID= argument.
Used by:DS2CONST, DS2TREE
NSWHERE=subset-expression
specifies a WHERE clause that subsets the node styles data set for display in the diagram. If the expression contains any special characters (for example, % or &), then include %NRBQUOTE in the expression to process those characters correctly. The following example shows how to correctly specify INT%:
NSWHERE=%NRBQUOTE(value="Int%")
Used by:DS2CONST, DS2TREE
NTEXTCOL=variable-name
specifies the name of the variable that determines the color of the text for the node labels. Valid variable values must be HTML 3.2 color names.
Used by:DS2CONST, DS2TREE
NTIP=variable-name
specifies the name of the variable that provides the data or text that is displayed in the pop-up data tips window.
Used by:DS2CONST, DS2TREE
NTIPFMT=user-defined-format-name
specifies the name of a user-defined SAS format that is applied to the data tips variable that is named in the NTIP= argument. Note that the data set is not altered; the formatted value is used only in the diagram.
Used by:DS2CONST, DS2TREE
NURL=drill-down-URL
specifies the name of the variable that provides the drill-down URLs for the nodes. These URLs are displayed when the Web user double-clicks on a node or selects the node with the right mouse button and chooses an option from the pop-up menu. Menu text is determined by the NACTION= argument above and by the ACTION= argument in Arguments for Diagram Appearance. The default menu option text is Open URL.
Used by:DS2CONST, DS2TREE
NVALUE=variable-name
specifies the name of the variable that determines the relative node size. This argument is valid only when DATATYPE=ASSOC.
If you do not specify a particular node color using either the NCOLOR or NCOLVAL argument (and if COLORMAP=Y), then this argument also determines a default node color. By default, the largest value of NVALUE is mapped to red, the median value to green, and the lowest value to blue. Values in between result in interpolated colors.
Used by:DS2CONST
NWHERE=subset-expression
specifies a WHERE clause that subsets the nodes data set for display in the diagram. If the expression contains any special characters (for example, % or &), then include %NRBQUOTE in the expression to process those characters correctly. The following example shows how to correctly specify INT%:
NWHERE=%NRBQUOTE(value="Int%")
See also the LWHERE= argument.
Used by:DS2CONST, DS2TREE
NX=variable-nameNY=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