Each line of a configuration
file can contain one or more system options or comments. If you specify
more than one system option on a line, use either a blank space or
a comma to separate the options. If the file has the legacy configuration
file format of LRECL=80 and RECFM=FB, then only columns 1-72 are used.
The contents of columns 73-80 are ignored. If the file has any other
format, then the entire line is used.
Two different types
of comments are supported. If a line contains an asterisk in column
one, then the entire line is a comment. If a comment of this type
requires multiple lines, each line must begin with an asterisk. Comments
beginning with /* and ending with */ can appear anywhere between option
specifications, but cannot be imbedded within an option specification.
Comments of this type can continue across line boundaries.
Note: An */ that ends a comment
cannot be in column one. If it is in column one, it starts a separate
comment for the entire line.
Some options can be
on (enabled) or off (disabled). Specifying only the keyword enables
the option, and specifying the keyword prefixed with NO disables the
option. For example, a configuration file might contain the following
option specifications to disable the options:
NOCENTER
NOSTIMER
NOSTATS
Options that take a
value must be specified in the following way:
option-name=value
For example, a configuration
file might contain the following lines:
LINESIZE=80
PAGESIZE=60
Note: When you specify SAS system
options in a configuration file, blank spaces are not permitted before
or after an equal sign.
A configuration file
can contain the CONFIG= option. A CONFIG= option in a configuration
file can name a single ddname, data set name, or UFS filename. It
cannot name a list of config files. The contents of the named config
file are logically inserted in place of the CONFIG= specification.
If a CONFIG= option specifies a file that has already been read as
a configuration file, a warning message is written to the log and
the file is not read again during this session.
The configuration file
is processed as if all of the lines (other than comments) were concatenated
into a single string with one blank space separating the lines, which
means that options whose value can contain blank spaces can be continued
across line boundaries. For example, the specification of the option
in the following example is on five separate lines, but it would be
processed as if it is on one line:
jreoptions=(
-jreoption1
-jreoption2
-jreoption3
)
In cases where separating concatenated lines with
a blank space is not suitable, two alternative methods of explicit
concatenation are provided.
-
If the file has the legacy format,
and there is a non-blank character in column 72, then the next line
is concatenated without an intervening blank space. The character
in column 72 is not ignored, it is included in the concatenated value.
-
If the legacy method of explicit
concatenation does not apply, and the last non-blank character of
the line (or of columns 1-71 in a legacy format file) is a hyphen
(-), then the hyphen is deleted and the next non-comment line is concatenated
without an intervening blank space. If the last non-blank character
is a plus sign (+), then the next non-comment line is concatenated
without an intervening blank space. Any leading blank spaces of that
line are also removed.
For example, the following option specification is
invalid because a blank space is inserted between the equal sign and
the value.
YEARCUTOFF=
1950
The following option specification is valid because
the value is concatenated immediately following the equal sign, and
a blank space is not inserted.
YEARCUTOFF=+
1950
Option values in SAS
configuration files can contain symbolic references. The values of
these symbolic references are resolved from a variable that is set
in the TKMVSENV file. For example, the localized member of the default
configuration file concatenation contains a statement similar to the
following:
SASHELP='MVS:&HLQ..ENW0.SASHELP'
In
this option value,
&HLQ.
is a variable
symbol. The variable HLQ is assigned a value in the TKMVSENV file,
in a statement similar to the following:
set HLQ=<high-level-qualifier>
where
"<high-level-qualifier>"
is
your actual high-level-qualifier for SAS that is set at install time.
Therefore, the final value of the SASHELP option is resolved as the
following:
SASHELP=’<high-level-qualifier>.ENW0.SASHELP’