SGDESIGN Procedure

PROC SGDESIGN Statement

Renders a graph (SGD file) that was created by using ODS Graphics Designer. The statement also enables you to specify a data set and other options.

Restrictions:

On z/OS systems, the SGDESIGN procedure does not render SGD files that were generated with the previous release of the ODS Graphics Designer. You must open the SGD file in the 9.3 version of the ODS Graphics Designer (on a Windows or UNIX system). Then save the file in the 9.3 format.

On z/OS systems, SGD files must be transferred to the HFS file system of UNIX System Services in order to be rendered by the SGDESIGN procedure.

Requirement:

An input SGD file specification is required. If the SGD file was created to use a temporary data set, such as a data set in the SAS Work library, then that data set must exist in the current SAS session in order for the graph to be rendered. The data set might need to be re-created in the current SAS session.

Syntax

Required Argument

Optional Arguments

Syntax

PROC SGDESIGN SGD= "SGD-file-specification"

<DATA= input-data-set>

< DESCRIPTION=“text-string” >

< LIBNAME=library-name >

;

Summary of Optional Arguments

CONTENT

outputs important information about the SGD file into the SAS log.

DATA= input-data-set

specifies the SAS data set that contains the variables to process.

DESCRIPTION= “text-string”

specifies a description for the output image.

LIBNAME= library-name

specifies an alternate library for all data sets that are associated with the SGD file.

Required Argument

SGD= "SGD-file-specification": specifies the SGD file to use for the graph. Include the complete path and filename enclosed in single or double quotation marks.

If you do not specify the full path, then the procedure looks for the file in the SAS current working directory. The SAS current directory is the same directory in which you start your SAS session. If you are running SAS with the Windowing environment in the Windows operating system, then the current directory is displayed in the status bar at the bottom of the main SAS window.

For complete instructions on creating SGD files, see SAS ODS Graphics Designer: User's Guide.

Optional Arguments

CONTENT: outputs important information about the SGD file into the SAS log. The information includes data set names, library names, variable names (including those for dynamic variables), and the ODS style.

Note:When the CONTENT option is used, no graphics output is produced.

DATA= input-data-set: specifies the SAS data set that contains the variables to process.
By default, the SGDESIGN procedure uses the data set or data sets that are currently defined in the SGD file. You have the option to specify an alternate data set. Only one data set can be specified here. If the SGD file uses columns from multiple data sets, then the specified data set should contain all the columns that are required to render the graph.

Specify the full name of the SAS data set in the format libref.data-set. If you do not specify the library, then the procedure looks for the data set in the SAS Work library.

DESCRIPTION= “text-string”

specifies a description for the output image.

The description identifies the image in the following locations:

the Results window
the alternate text for the image in HTML output
the table of contents that is created by the CONTENTS option in an ODS statement

Alias:DES

Default:The default description is “The SGDesign Procedure”.

LIBNAME= library-name: specifies an alternate library for all data sets that are associated with the SGD file. If no library is specified, then the procedure uses the library that is currently defined in the SGD file.
The data sets in the SGD file can come from multiple libraries. However, when you use the LIBNAME= option, you override all of those library names with the specified library.