ODS MARKUP Statement

OPTIONS FORMCHAR="|----|+|---+=|-/\<>*"; 

Actions

An action is one of the following:

CLOSE

closes the destination and any files that are associated with it.

Tip:	When an ODS destination is closed, ODS does not send output to that destination. Closing an unneeded destination conserves system resources.
Feature in:	All examples

EXCLUDE exclusion(s)| ALL | NONE

excludes one or more output objects from the destination.

Default:	NONE
Restriction:	A destination must be open for this action to take effect.
Main discussion:	ODS EXCLUDE Statement

SELECT selection(s) | ALL | NONE

selects output objects for the specified destination.

Default:	ALL
Restriction:	A destination must be open for this action to take effect.
Main discussion:	ODS SELECT Statement

SHOW

writes the current selection or exclusion list for the destination to the SAS log .

Restriction:	A destination must be open for this action to take effect.
See also:	ODS SHOW Statement
Tip:	If the selection or exclusion list is the default list (SELECT ALL), then SHOW also writes the entire selection or exclusion list. For information about selection and exclusion lists, see Selection and Exclusion Lists.

ANCHOR= 'anchor-name'

specifies a unique base name for the anchor tag that identifies each output object in the current body file.

Each output object has an anchor tag for the contents, page, and frame files to reference. The links and references, which are automatically created by ODS, point to the name of an anchor. Therefore, each anchor name in a file must be unique.

anchor-name

is the base name for the anchor tag that identifies each output object in the current body file.

ODS creates unique anchor names by incrementing the name that you specify. For example, if you specify ANCHOR= 'tabulate', then ODS names the first anchor tabulate. The second anchor is named tabulate1; the third is named tabulate2, and so on.

Requirement:	You must enclose anchor-name in quotation marks.
Tip:	You can change anchor names as often as you want by specifying the ANCHOR= option in a Markup Family statement anywhere in your program. Once you have specified an anchor name, it remains in effect until you specify a new one.

Restriction:	Each anchor name in a file must be unique.
Interaction:	If you open a file to append to it, then be sure to specify a new anchor name so that you do not write the same anchors to the file again. ODS does not recognize anchors that are already in a file when it opens the file.
Tip:	Specifying new anchor names at various points in your program is useful when you want other web pages to link to specific parts of your markup language output. Because you can control where the anchor name changes, you know in advance what the anchor name will be at those points.

ARCHIVE='string'

The ARCHIVE= option is valid only for the GOPTIONS java device. The ARCHIVE= option enables you to specify which applet to use in order to view the ODS HTML output.

The string must be one that the browser can interpret. For example, if the archive file is local to the computer that you are running SAS on, you can use the FILE protocol to identify the file. If you want to point to an archive file that is on a web server, use the HTTP protocol .

Default:	If you do not specify ARCHIVE= and you are using the JAVA device driver, ODS uses the value of the SAS system option APPLETOC=. This value points to the location of the Java archive files that ship with the SAS system. To find out what the value of this option is, you can either look in the Options window in the Files folder under Environment Control, or you can submit the following procedure step: proc options option=appletloc; run; There is no default if you are using the ACTIVEX device driver.
Requirement:	You must enclose string in quotation marks.
Requirement:	The ARCHIVE attribute is a feature of Java 1.1. Therefore, if you are using the Java device driver, your browser must support this version of Java. Both Internet Explorer 4.01 and Netscape 4.05 support Java 1.1.
Interaction:	Use ARCHIVE= in conjunction with SAS/GRAPH procedures and the DEVICE=JAVA or DEVICE=ACTIVEX option in the GOPTIONS statement.
Tip:	Typically, this option should not be used, because the SAS server automatically determines the correct SAS/GRAPH applets to view the ODS HTML output . However, if you have renamed the .jar files, or have other applets with which to view the ODS HTML output, this option enables you to access these applets.
Tip:	As stated in the CODEBASE= documentation, it is recommended that you do not put a file path in your ARCHIVE option. Instead, use the CODEBASE option to specify the file path.

ATTRIBUTES= (attribute-pair-1 ... attribute-pair-n)

writes the specified attributes between the tags that generate dynamic graphics output.

attribute-pair

specifies the name and value of each attribute. attribute-pair has the following form:

'attribute-name'= 'attribute-value'

attribute-name

is the name of the attribute.

attribute-value

is the value of the attribute.

Requirement:

You must enclose attribute-name and attribute-value in quotation marks.

Interaction:	Use the ATTRIBUTES= option in conjunction with SAS/GRAPH procedures and with the DEVICE=JAVA, JAVAMETA, or ACTIVEX options in the GOPTIONS statement.
See also:	SAS/GRAPH Software: Reference, Volumes 1 and 2 for valid attributes for the following applets: Graph Applet Map Applet Contour Applet MetaView Applet

BASE= 'base-text'

Specifies the text to use as the first part of all links and references that ODS creates in the output files.

base-text

is the text that ODS uses as the first part of all links and references that ODS creates in the file.

Consider this specification:

BASE= 'http://www.your-company.com/local-url/'

In this case, ODS creates links that begin with the string http://www.your-company.com/local-url/. The appropriate anchor-name completes the link.

Requirement:

You must enclose base-text in quotation marks.

BODY= 'file-specification' <(sub-option(s))>

opens a markup family destination and specifies the file that contains the primary output that is created by the ODS statement. These files remain open until you do one of the following:

• close the destination with either an ODS Markup-family-destination CLOSE statement or ODS _ALL_ CLOSE statement.

• open the same destination with a second markup family statement. This closes the first file and opens the second file.

file-specification

specifies the file, fileref, or SAS catalog to write to.

file-specification is one of the following:

external-file

is the name of an external file to write to.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref.

Restriction:	The BODY=fileref option cannot be used in conjunction with the NEWFILE= option.
See:	For information about the FILENAME statement, see SAS Language Reference: Dictionary.

entry.markup

specifies an entry in a SAS catalog to write to.

Interaction:

If you specify an entry name, you must also specify a library and catalog. See the discussion of the PATH= option.

(sub-option(s))

specifies one or more suboptions in parentheses. Suboptions are instructions for writing the output files. For a list of suboptions, see Suboptions.

Note:   For some values of TAGSET=, this output will be an HTML file, for other TAGSET= values, the output will be an XML file, and so on.   

Alias:	FILE=
Interaction:	If you use the BODY= option in an ODS markup family statement that refers to an open ODS markup destination, the option will force ODS to close the destination and all files associated with it, and then to open a new instance of the destination. For more information see Opening and Closing the MARKUP Destination.
Featured in:	All examples

CHARSET= character-set

specifies the character set to be generated in the META declaration for the HTML output.

See:	For information about the CHARSET option, see SAS National Language Support (NLS): Reference Guide.

CODE= 'file-specification' <(sub-option(s))>

opens a markup family destination and specifies the file that contains relevant style information, such as XSL (Extensible Stylesheet Language). These files remain open until you do one of the following:

• close the destination with either an ODS Markup-family-destination CLOSE statement or ODS _ALL_ CLOSE statement.

• open the same destination with a second markup family statement. This closes the first file and opens the second file.

file-specification

specifies the file, fileref, or SAS catalog to write to.

file-specification is one of the following:

external-file

is the name of an external file to write to.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref.

See:	For information about the FILENAME statement, see SAS Language Reference: Dictionary.

entry.markup

specifies an entry in a SAS catalog to write to.

Interaction:

If you specify an entry name, you must also specify a library and catalog. See the discussion of the PATH= option.

sub-option(s)

specifies one or more suboptions in parentheses. Suboptions are instructions for writing the output files. For a list of suboptions, see Suboptions.

CODEBASE='string'

specifies the location of the executable Java applet or the ActiveX control file. string is specified as a pathname or as a URL. The CODEBASE file path option has two definitions, depending on the GOPTIONS device used.

For the ActiveX device:

If you use the ActiveX device driver with ODS to generate output containing an ActiveX control, then specify the location and version of the .exe file with the CODEBASE= option on the ODS statement.

Tip:	You do not need to specify the CODEBASE= option with the DEVICE=ACTIVEX option unless the users that view your output do not have the ActiveX control installed on their machine.
See also:	SAS/GRAPH Software: Reference, Volumes 1 and 2

For the Java device:

If you use the Java device driver with ODS to generate output containing a SAS/GRAPH applet, specify the path to the .jar file with the CODEBASE= option on the ODS statement.

Tip:	By default, the location of the SAS Java archive files is specified by the APPLETLOC= system option. This value is the default value of the CODEBASE= parameter. If the default location is accessible by users who will be viewing your Web presentation, and the SAS Java archive is installed at that location, then you do not need to change the value of the CODEBASE= parameter.
Tip:	Specify only the directory of the .jar file.
See also:	SAS/GRAPH Software: Reference, Volumes 1 and 2

CONTENTS= 'file-specification' <(sub-option(s))>

opens a markup family destination and specifies the file that contains a table of contents for the output. These files remain open until you do one of the following:

• close the destination with either an ODS Markup-family-destination CLOSE statement or ODS _ALL_ CLOSE statement.

• open the same destination with a second markup family statement. This closes the first file and opens the second file.

file-specification

specifies the file, fileref, or SAS catalog to write to.

file-specification is one of the following:

external-file

is the name of an external file to write to.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref.

See:	For information about the FILENAME statement, see SAS Language Reference: Dictionary.

entry.markup

specifies an entry in a SAS catalog to write to.

Interaction:

If you specify an entry name, you must also specify a library and catalog. See the discussion of the PATH= option.

sub-option(s)

specifies one or more suboptions in parentheses. Suboptions are instructions for writing the output files. For a list of suboptions, see Suboptions.

CSSSTYLE= 'file-specification'<(media-type-1 <..media-type-10>)>

specifies a cascading style sheet to apply to your output.

file-specification

specifies a file, fileref, or URL that contains CSS code..

file-specification is one of the following:

"external-file"

is the name of the external file.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref.

See:	For information about the FILENAME statement, see SAS Language Reference: Dictionary.

"URL"

is a URL to an external file.

Requirement:

You must enclose external-file in quotation marks.

(media-type-1<.. media-type-10>)

specifies one or more media blocks that corresponds to the type of media that your output will be rendered on. CSS uses media type blocks to specify how a document is to be presented on different media: on the screen, on paper, with a speech synthesizer, with a braille device, etc.

The media block is added to your output in addition to the CSS code that is not contained in any media blocks. By using the media-type suboption, in addition to the general CSS code, you can import the section of a CSS file intended only for a specific media type.

Default:	If no media-type is specified in your ODS statement, but you do have media types specified in your CSS file, then ODS uses the Screen media type.
Range:	You can specify up to ten different media types.
Requirement:	You must enclose media-type in parentheses.
Requirement:	You must specify media-type next to the file-specification specified by the CSSSTYLE= option.
Tip:	If you specify multiple media types, all of the style information in all of the media types is applied to your output. However, if there is duplicate style information in different media blocks, then the styles from the last media block are used.

Interaction:	If both the STYLE= option and the CSSSTYLE= option are specified on an ODS statement, the option specified last it the option that is used.
Requirement:	CSS files must be written in the same type of CSS produced by the ODS HTML statement. Only class names are supported, with no IDs and no context based selectors. To view the CSS code that ODS creates, you can specify the STYLESHEET= option, or you can view the source of an HTML file and look at the code between the <STYLE> </STYLE> tags at the top of the file. For an example of a valid for ODS CSS file, see Applying a CSS File to ODS Output.
Featured in:	Applying a CSS File to ODS Output

IMAGE_DPI=

specifies the image resolution for graphical output.

ENCODING= local-character-set-encoding

overrides the encoding for input or output processing (transcodes) of external files.

See:	For information about the ENCODING= option, see SAS National Language Support (NLS): Reference Guide.

EVENT=event-name (FILE= | FINISH | LABEL= | NAME= | START | STYLE= |TARGET= | TEXT= | URL= )

specifies an event and the value for event variables that are associated with the event.

(FILE= BODY | CODE | CONTENTS | DATA | FRAME | PAGES | STYLESHEET);

triggers one of the known types of output files that correspond to the BODY=, CODE=, CONTENTS=, FRAME=, PAGES=, and STYLESHEET= options.

(FINISH)

triggers the finish section of an event.

See:	For information about events, see Understanding Events.

(LABEL='variable-value')

specifies the value for the LABEL event variable.

Requirement:	variable-value must be enclosed in quotation marks.
See:	For information about the LABEL event variable, see Event Variables.

(NAME='variable-value')

specifies the value for the NAME event variable.

Requirement:	variable-value must be enclosed in quotation marks.
See:	For information about the NAME event variable, see Event Variables.

(START)

triggers the start section of an event.

See:	For information about events, see Understanding Events.

(STYLE=style-element)

specifies a style element.

See:	For information about style elements, see Style Attributes and Their Values.

(TARGET='variable-value')

specifies the value for the TARGET event variable.

Requirement:	variable-value must be enclosed in quotation marks.
See:	For information about the TARGET event variable, see Event Variables.

(TEXT='variable-value')

specifies the value for the TEXT event variable.

Requirement:	variable-value must be enclosed in quotation marks.
See:	For information about the TEXT event variable, see Event Variables.

(URL='variable-value')

specifies the value for the URL event variable.

Requirement:	variable-value must be enclosed in quotation marks.
See:	For information about the URL event variable, see Event Variables.

Default:	(FILE='BODY')
Requirement:	The EVENT= option's suboptions must be enclosed in parenthesis.

FRAME= 'file-specification' <(sub-option(s))>

opens a markup family destination and, for HTML output, specifies the file that integrates the table of contents, the page contents, and the body file. If you open the frame file, then you see a table of contents, a table of pages, or both, as well as the body file. For XLM output, FRAME= specifies the file that contains the DTD. These files remain open until you do one of the following:

• close the destination with either an ODS Markup-family-destination CLOSE statement or ODS _ALL_ CLOSE statement.

• open the same destination with a second markup family statement. This closes the first file and opens the second file.

file-specification

specifies the file, fileref, or SAS catalog to write to.

file-specification is one of the following:

external-file

is the name of an external file to write to.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref.

See:	For information about the FILENAME statement, see SAS Language Reference: Dictionary.

entry.markup

specifies an entry in a SAS catalog to write to.

Interaction:

If you specify an entry name, you must also specify a library and catalog. See the discussion of the PATH= option.

sub-option(s)

specifies one or more suboptions in parentheses. Suboptions are instructions for writing the output files. For a list of suboptions, see Suboptions.

Restriction:	If you specify the FRAME= option, then you must also specify the CONTENTS= option, the PAGE= option, or both.
Featured in:	Creating an XML File and a DTD

GFOOTNOTE | NOGFOOTNOTE

controls the location where footnotes are printed in the graphics output.

GFOOTNOTE

prints footnotes that are created by SAS/GRAPH, which appear inside the graph borders.

NOGFOOTNOTE

prints footnotes that are created by ODS, which will appear outside the graph borders.

Default:	GFOOTNOTE
Restriction:	Footnotes that are displayed by a markup language statement support all SAS/GRAPH FOOTNOTE statement options. The font must be valid for the browser. Options that ODS cannot handle, such as text angle specifications, are ignored. For details about the SAS/GRAPH FOOTNOTE statement, see SAS/GRAPH Software: Reference, Volumes 1 and 2.
Restriction:	This option applies only to SAS programs that produce SAS/GRAPH output files.

GPATH= file-specification <(url='Uniform-Resource-Locator' | NONE)>

specifies the location for all graphics output that is generated while the destination is open.

file-specification

specifies the file or SAS catalog to write to. Each output object that ODS places in the file is named automatically using the SAS/GRAPH catalog entry name as the base name and incrementing the name as necessary. For more information about how ODS names catalog entries and external files, see SAS/GRAPH Software: Reference, Volumes 1 and 2. file-specification is one of the following:

external-file

is the name of an external file to write to.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref. For information about the FILENAME statement, see SAS Language Reference: Dictionary.

Interaction:

If you specify a fileref in the GPATH= option, then ODS does not use information from the GPATH= option when it constructs links.

libref.catalog

specifies a SAS catalog to write to.

URL= 'Uniform-Resource-Locator' | NONE

specifies a URL for file-specification.

Uniform-Resource-Locator

is the URL you specify. ODS uses this URL instead of the filename in all the links and references that it creates to the file.

Requirement:

You must enclose Uniform-Resource-Locator in quotation marks.

NONE

specifies that no information from the GPATH= option appears in the links or references.

Tip:	This option is useful for building output files that can be moved from one location to another. If the links from the contents and page files are constructed with a simple URL (one name), then they will resolve, as long as the contents, page, and body files are all in the same location.

Default:

If you omit the GPATH= option, then ODS stores graphics in the location that is specified by the PATH= option. If you do not specify the PATH= option, then ODS stores the graphics in the current directory. For more information, see the PATH= option.

GTITLE | NOGTITLE

controls the location where titles are printed in the graphics output.

GTITLE

prints the title that is created by SAS/GRAPH, which will appear inside the graph borders

NOGTITLE

prints the title that is created by ODS, which will appear outside the graph borders.

Default:	GTITLE
Restriction:	Titles that are displayed by any markup language statement support most SAS/GRAPH TITLE statement options. The font must be valid for the browser. Options that ODS cannot handle, such as text angle specifications, are ignored. For details about the SAS/GRAPH TITLE statement, see SAS/GRAPH Software: Reference, Volumes 1 and 2.
Restriction:	This option applies only to SAS programs that produce one or more SAS/GRAPH output files.

HEADTEXT= 'markup-document-head'

specifies markup tags to place between the <HEAD> and </HEAD> tags in all the files that the destination writes to.

markup-document-head

is the markup tags to place between the <HEAD> and </HEAD> tags.

Requirement:

You must enclose markup-document-head in quotation marks.

Tip:	ODS cannot parse the markup that you supply. It should be well-formed markup that is correct in the context of the <HEAD> and </HEAD> tags.
Tip:	Use the HEADTEXT= option to define programs (such as JavaScript) that you can use later in the file.

(ID= identifier)

enables you to run multiple instances of the same destination at the same time. Each instance can have different options.

identifier

specifies another instance of the destination that is already open. identifier is numeric or a series of characters that begin with a letter or an underscore. Subsequent characters can include letters, underscores, and numeric characters.

Restriction:	If identifier is numeric, it must be a positive integer.
Requirement:	The ID= option must be specified immediately after the ODS MARKUP/TAGSET statement keywords.
Tip:	You can omit the ID= option, and instead use a name or a number to identify the instance.
Featured in:	Opening Multiple Instances of the Same Destination at the Same Time

METATEXT= 'metatext-for-document-head'

specifies HTML code to use as the <META> tag between the <HEAD> and </HEAD> tags of all the HTML files that the destination writes to.

'metatext-for-document-head'

specifies the HTML code that provides the browser with information about the document that it is loading. For example, this attribute could specify the content type and the character set to use.

Requirement:

You must enclose metatext-for-document-head in quotation marks.

Default:	If you do not specify METATEXT=, then ODS writes a simple <META> tag, which includes the content-type of the document and the character set to use, to all the HTML files that it creates.
Tip:	ODS cannot parse the HTML code that you supply. It should be well-formed HTML code that is correct in the context of the <HEAD> tags. If you are using METATEXT= as it is intended, then your META tag should look like this: <META your-metatext-is-here>
Restriction:	METATEXT= cannot exceed 256 characters.

NEWFILE= starting-point

creates a new body file at the specified starting-point.

starting-point

is the location in the output where you want to create a new body file.

ODS automatically names new files by incrementing the name of the body file. In the following example, ODS names the first body file REPORT.XML. Additional body files are named REPORT1.XML, REPORT2.XML, and so on.

Example:

BODY= 'REPORT.XML'

starting-point is one of the following:

BYGROUP

starts a new file for the results of each BY group.

NONE

writes all output to the body file that is currently open.

OUTPUT

starts a new body file for each output object. For SAS/GRAPH this means that ODS creates a new file for each SAS/GRAPH output file that the program generates.

Alias:

TABLE

PAGE

starts a new body file for each page of output. A page break occurs when a procedure explicitly starts a new page (not because the page size was exceeded) or when you start a new procedure.

PROC

starts a new body file each time that you start a new procedure.

Default:	NONE
Restriction:	The NEWFILE= option cannot be used in conjunction with the BODY=fileref option.
Tip:	If you end the filename with a number, then ODS begins incrementing with that number. In the following example, ODS names the first body file MAY5.XML. Additional body files are named MAY6.XML, MAY7.XML, and so on. Example: BODY= 'MAY5.XML'

NOGFOOTNOTE

See:	GFOOTNOTE | NOGFOOTNOTE options

NOGTITLE

See:	GTITLE | NOGTITLE options

PAGE= 'file-specification' <(sub-option(s))>

opens a markup family destination and specifies the file that contains a description of each page of the body file, and contains links to the body file. ODS produces a new page of output whenever a procedure requests a new page. These files remain open until you do one of the following:

• close the destination with either an ODS Markup-family-destination CLOSE statement or ODS _ALL_ CLOSE statement.

• open the same destination with a second markup family statement. This closes the first file and opens the second file.

file-specification

specifies the file, fileref, or SAS catalog to write to.

file-specification is one of the following:

external-file

is the name of an external file to write to.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref.

See:	For information about the FILENAME statement, see SAS Language Reference: Dictionary.

entry.markup

specifies an entry in a SAS catalog to write to.

Interaction:

If you specify an entry name, you must also specify a library and catalog. See the discussion of the PATH= option.

sub-option(s)

specifies one or more suboptions in parentheses. Suboptions are instructions for writing the output files. For a list of suboptions, see Suboptions.

Interaction:

The SAS system option PAGESIZE= has no effect on pages in HTML output except when you are creating batch output. For information about the PAGESIZE= option see SAS Language Reference: Dictionary.

PARAMETERS= (parameter-pair-1 ... parameter-pair-n)

writes the specified parameters between the tags that generate dynamic graphics output.

parameter-pair

specifies the name and value of each parameter. parameter-pair has the following form:

'parameter-name'= 'parameter-value'

parameter-name

is the name of the parameter.

parameter-value

is the value of the parameter.

Requirement:

You must enclose parameter-name and parameter-value in quotation marks.

Interaction:	Use PARAMETERS= in conjunction with SAS/GRAPH procedures and the DEVICE=JAVA, JAVAMETA, or ACTIVEX options in the GOPTIONS statement.
See also:	SAS/GRAPH Software: Reference, Volumes 1 and 2 for valid parameters for the following applets: Graph Applet Map Applet Contour Applet MetaView Applet

PATH= file-specification (URL= 'Uniform-Resource-Locator' | NONE)

specifies the location of an external file or a SAS catalog for all markup files.

file-specification

specifies the file or SAS catalog to write to.

file-specification is one of the following:

external-file

is the name of an external file to write to.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref.

Interaction:	If you use a fileref in the PATH= option, then ODS does not use information from PATH= when it constructs links.
See:	For information about the FILENAME statement, see SAS Language Reference: Dictionary.

libref.catalog

specifies a SAS catalog to write to.

See:	For information about the LIBNAME statement, see SAS Language Reference: Dictionary.

URL= 'Uniform-Resource-Locator' | NONE

specifies a URL for the file-specification.

Uniform-Resource-Locator

is the URL you specify. ODS uses this URL instead of the filename in all the links and references that it creates to the file.

NONE

specifies that no information from the PATH= option appears in the links or references.

Tip:	This option is useful for building output files that can be moved from one location to another. The links from the contents and page files must be constructed with a single-name URL, and the contents, page, and body files must be in the same location.

RECORD_SEPARATOR= 'alternative-separator' | NONE

specifies an alternative character or string that separates lines in the output files.

Different operating environments use different separator characters. If you do not specify a record separator, then the files are formatted for the environment where you run the SAS job. However, if you are generating files for viewing in a different operating environment that uses a different separator character, then you can specify a record separator that is appropriate for the target environment.

alternative-separator

represents one or more characters in hexadecimal or ASCII format. For example, the following option specifies a record separator for a carriage return character and a linefeed character for use with an ASCII file system:

RECORD_SEPARATOR= '0D0A'x

Operating Environment Information:   In a mainframe environment, the option that specifies a record separator for a carriage return character and a linefeed character for use with an ASCII file system is:

RECORD_SEPARATOR= '0D25'x

  

Requirement:

You must enclose alternative-separator in quotation marks.

NONE

produces the markup language that is appropriate for the environment where you run the SAS job.

Operating Environment Information:   In a mainframe environment, by default, ODS produces a binary file that contains embedded record separator characters. This binary file is not restricted by the line-length restrictions on ASCII files. However, if you view the binary files in a text editor, then the lines run together.

If you want to format the files so that you can read them with a text editor, then use RECORD_SEPARATOR= NONE. In this case, ODS writes one line of markup language at a time to the file. When you use a value of NONE, the logical record length of the file that you are writing to must be at least as long as the longest line that ODS produces. If the logical record length of the file is not long enough, then the markup language might wrap to another line at an inappropriate place.  

Alias:

RECSEP= RS=

STYLE= style-definition

specifies the style definition to use in writing the output files.

style-definition

describes how to display the presentation aspects (color, font face, font size, and so on) of your SAS output. A style definition determines the overall appearance of the documents that use it. Each style definition consists of style elements.

Main discussion:	For a complete discussion of style definitions, see TEMPLATE Procedure: Creating a Style Definition.
Interaction:	The STYLE= option is not valid when you are creating XML output.

Default:	If you do not specify a style definition, then ODS uses the file that is specified in the SAS registry subkey ODS  DESTINATIONS  MARKUP  Selected StyleBy default, this value specifies styles.default.
Interaction:	If you specify the STYLE= option on an ODS HTML4 statement and want to change the style definition with another ODS HTML4 statement , you must close the first statement before specifying the second statement, in order for any PROC PRINT output to use the second style definition.

STYLESHEET= 'file-specification' <(sub-option(s))>

opens a markup family destination and places the style information for markup output into an external file, or reads style sheet information from an existing file. These files remain open until you do one of the following:

• close the destination with either an ODS Markup-family-destination CLOSE statement or ODS _ALL_ CLOSE statement.

• open the same destination with a second markup family statement. This closes the first file and opens the second file.

file-specification

specifies the file, fileref, or SAS catalog to write to.

file-specification is one of the following:

external-file

is the name of an external file to write to.

Requirement:

You must enclose external-file in quotation marks.

fileref

is a file reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref.

See:	For information about the FILENAME statement, see SAS Language Reference: Dictionary.

entry.markup

specifies an entry in a SAS catalog to write to.

Interaction:

If you specify an entry name, you must also specify a library and catalog. See the discussion of the PATH= option.

sub-option(s)

specifies one or more suboptions in parentheses. Suboptions are instructions for writing the output files. For a list of suboptions, see Suboptions.

Note:   By default, if you do not specifically send the information to a separate file, then the style sheet information is included in the specified HTML file.  

Featured in:

Including Multiple Cascading Style Sheets in One HTML Document

TAGSET= tagset-name

specifies a keyword value for a tagset. A tagset is a template that defines how to create a markup language output type from a SAS format. Tagsets produce markup output such as Hypertext Markup Language (HTML), Extensible Markup Language (XML), and LaTeX.

An alternate form for specifying a tagset is as follows:

ODS directory.tagset-name file-specification(s)<option(s)>; ODS directory.tagset-name action; A directory can be a TAGSET, a user defined entry, or a libref. By default, the tagsets that SAS supplies are located in the directory TAGSETS, which is within the item store SASUSER.TMPLMST. For more information about user defined tagsets and item stores, see TEMPLATE Procedure: Overview.

Alias:	TYPE=
Default:	If you do not specify a TAGSET= value, then the ODS MARKUP statement defaults to XML output.
Interaction:	If you use the TAGSET= option in an ODS markup family statement that refers to an open ODS markup destination, then the option will force ODS to close the destination and all files associated with it, and then to open a new instance of the destination. For more information, see Opening and Closing the MARKUP Destination.
Tip:	SAS provides a set of tagset definitions. To get a list of the tagset names that SAS supplies, plus any tagsets that you created and stored in the SASUSER.TMPLMST template store, submit the following SAS statements: proc template; list tagsets; run;
See also:	For additional information about specifying tagsets, see TEMPLATE Procedure: Creating Markup Language Tagsets.
Featured in: