Previous Page | Next Page

The SGDESIGN Procedure

DYNAMIC Statement


Assigns values to dynamic variables that have been defined in the SGD file. You can either specify variables in multiple DYNAMIC statements or specify all of your variables in a single DYNAMIC statement.
Featured in: Use the DYNAMIC Statement to Specify a Column and Use the DYNAMIC Statement to Specify a Column and a Character String


Syntax

DYNAMIC dynamic-var-1="assigned-value-1" <dynamic-var-n="assigned-value-n">;

Required Arguments

dynamic-var= assigned-value

specifies the values for one or more dynamic variables. For more information about dynamic variables, see Dynamic Variable Concepts.

dynamic-var

specifies the name of a dynamic variable.

The variable must be declared in a DYNAMIC statement within the SGD file's template. (In ODS Graphics Designer, you can see the dynamic variables that have been declared for a graph when you view the graph's template code from the View menu.)

assigned-value

specifies the value for the dynamic variable. If the value is a character string or a column name, then it must be enclosed in single or double quotation marks. For example: V1="year" and MYTITLE="Distribution of Patient Weight".

If the value is a numeric value, then you should supply a number. In this case, no quotation marks are required. For example: BINS=5.

When the value refers to a column name, then the new column must be the same type as the column it replaces. For example, if V1 is a numeric type column, then the column name you specify must also be numeric.

When the value is a column name, the case of the string value does not matter. For example, V1="Weight" is effectively the same as V1="WEIGHT". When the value resolves to text that appears in the graph (for example, titles and axis labels) the value entered is case-sensitive.


Details

When you use dynamic variables, be aware that some variables must be initialized, whereas for others, initialization is optional. For example, suppose that the graph file Histogram.sgd is defined with dynamic content in the title. In order to successfully execute this SGD file with a correct title, the dynamic variable used in the title must be initialized (in the example, the dynamic variable is named TITLE):

proc sgdesign sgd = "Histogram.sgd";
  dynamic TITLE = "This is a Histogram";
run;

However, if the SGD file was created with a shared variable, then that shared variable has already been assigned a column value in the SGD file. You do not need to specify a value for the variable unless you want to change the column. For more information about shared variables, see Dynamic Variable Concepts.

Previous Page | Next Page | Top of Page