Treeview HTML Generator

Generating and Saving the HTML File

Use the following arguments in your DS2TREE macro call when you want to generate the hierarchical tree to an HTML file. Default argument values are listed first and displayed in bold type.

htmlfile=external-filename
specifies the name of the HTML file where the formatted output is to be written. If the file you specify does not exist, then it is created for you. This argument, or HTMLFREF, is required if you specify MAKEHTML=Y.

Note: Do not use the HTMLFILE argument if you use the HTMLFREF argument.

htmlfref=fileref
specifies the SAS fileref that points to the location of the HTML file where the formatted output is to be written. If the file you specify does not exist, then it is created for you. This argument, or HTMLFILE, is required if you specify MAKEHTML=Y.

Note: Do not use the HTMLFREF argument if you use the HTMLFILE argument.

xmlfile=external-filename
specifies the name of the XML file where the formatted output is to be written. If the file you specify 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.

xmlfref=fileref
specifies the SAS fileref that points to the location of the XML file where the formatted output is to be written. If the file you specify 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.

makehtml=Y | N
specifies whether or not an HTML file is generated. If you specify MAKEHTML=N and MAKEXML=Y, then only an XML file will be generated.

makexml=Y | N
specifies whether or not an XML file is generated. 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.

openmode=REPLACE | APPEND
indicates whether the new HTML and/or XML output 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). This argument is required only if you want to override the default setting (OPENMODE=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 dataset (PDS) on z/OS.

  • Specify REPLACE to delete the information from an existing file and replace it with the new output.

runmode=B | S
specifies whether you are running the DS2TREE macro in batch or server mode.

  • Batch mode (RUNMODE=B) 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) is used with Application Dispatcher applications and causes the generator to print the HTTP header that is required by Application Dispatcher. For more information, refer to the SAS/IntrNet Application Dispatcher documentation at http://support.sas.com/documentation..

xmltype=INLINE | EXTERNAL
specifies whether the XML file generated is to be written to an external file or included inline with the HTML. If you specify EXTERNAL you must also specify a value for either the XMLFILE or XMLFREF arguments.

This argument is required if MAKEXML=Y was specified.

xmlurl=value
specifies a URL that contains the XML. This is useful if you have an existing XML file that you wish to use.

This argument is required if specified XMLTYPE=EXTERNAL.

Note: z/OS is the successor to the OS/390 and MVS operating systems. SAS/IntrNet 9.1 for z/OS is supported on the MVS, OS/390, and z/OS operating systems and, throughout this document, any reference to z/OS also applies to OS/390 and MVS, unless otherwise stated.