Valid in: Configuration file, OPTIONS window, OPTIONS statement, SAS invocation
Category: Macro
PROC OPTIONS
GROUP=
MACRO
Type: System option
Default: NOMRECALL
Syntax
MRECALL | NOMRECALL
Required Arguments
MRECALL
searches the autocall libraries for an undefined macro name each time an attempt is
made to invoke the macro. It is inefficient to search the autocall libraries repeatedly
for an undefined macro. Generally, use this option when you are developing or
debugging programs that call autocall macros.
NOMRECALL
searches the autocall libraries only once for a requested macro name.
Details
Use the MRECALL option primarily for
• developing systems that require macros in autocall libraries.
• recovering from errors caused by an autocall to a macro that is in an unavailable
library. Use MRECALL to call the macro again after making the library available. In
general, do not use MRECALL unless you are developing or debugging autocall
macros.
MREPLACE System Option
Specifies whether to enable existing macros to be redefined.
Valid in: Configuration file, OPTIONS window, OPTIONS statement, SAS invocation
Category: Macro
PROC OPTIONS
GROUP=
MACRO
Type: System option
Default: MREPLACE
Syntax
MREPLACE | NOMREPLACE
MREPLACE System Option 379
Required Arguments
MREPLACE
enables you to redefine existing macro definitions that are stored in a catalog in the
Work library.
NOMREPLACE
prevents you from redefining existing macro definitions that are stored in a catalog in
the Work library.
Details
The MREPLACE system option enables you to overwrite existing macros if the names
are the same.
The NOMREPLACE system option prevents you from overwriting a macro even if a
macro with the same name has already been compiled.
MSTORED System Option
Specifies whether the macro facility searches a specific catalog for a stored compiled macro.
Valid in: Configuration file, OPTIONS window, OPTIONS statement, SAS invocation
Category: Macro
PROC OPTIONS
GROUP=
MACRO
Type: System option
Default: NOMSTORED
Syntax
MSTORED | NOMSTORED
Required Arguments
MSTORED
searches for stored compiled macros in a catalog in the SAS library referenced by the
SASMSTORE= option.
NOMSTORED
does not search for compiled macros.
Details
Regardless of the setting of MSTORED, the macro facility first searches for macros
compiled in the current SAS session. If the MSTORED option is in effect, the macro
facility next searches the libraries containing compiled stored macros. If the
MAUTOSOURCE option is in effect, the macro facility next searches the autocall
libraries. Then, the macro facility searches the SASMacr catalog in the SASHelp library.
MSYMTABMAX= System Option
Specifies the maximum amount of memory available to the macro variable symbol table or tables.
380 Chapter 20 • System Options for Macros
Valid in: Configuration file, OPTIONS window, OPTIONS statement, SAS invocation
Category: Macro
PROC OPTIONS
GROUP=
MACRO
Type: System option
See: “MSYMTABMAX System Option: UNIX” in SAS Companion for UNIX Environments
“MSYMTABMAX System Option: Windows” in SAS Companion for Windows
“MSYMTABMAX= System Option: z/OS” in SAS Companion for z/OS
Syntax
MSYMTABMAX= n | nK | nM | nG | MAX
Required Arguments
n
specifies the maximum memory available in bytes.
nK
specifies the maximum memory available in kilobytes.
nM
specifies the maximum memory available in megabytes.
nG
specifies the maximum memory available in gigabytes.
MAX
specifies the maximum memory of 65534.
Details
Once the maximum value is reached, additional macro variables are written out to disk.
The value that you specify with the MSYMTABMAX= system option can range from 0
to the largest nonnegative integer representable on your operating environment. The
default values are host dependent. A value of 0 causes all macro symbol tables to be
written to disk.
The value of MSYMTABMAX= can affect system performance. If this option is set too
low and the application frequently reaches the specified memory limit, then disk I/O
increases. If this option is set too high (on some operating environments) and the
application frequently reaches the specified memory limit, then less memory is available
for the application, and CPU usage increases. Before you specify the value for
production jobs, run tests to determine the optimum value.
MVARSIZE= System Option
Specifies the maximum size for macro variable values that are stored in memory.
Valid in: Configuration file, OPTIONS window, OPTIONS statement, SAS invocation
Category: Macro
PROC OPTIONS
GROUP=
MACRO
MVARSIZE= System Option 381
Type: System option
Default: 65534
See: “MVARSIZE System Option: UNIX” in SAS Companion for UNIX Environments
“MVARSIZE System Option: Windows” in SAS Companion for Windows
“MVARSIZE= System Option: z/OS” in SAS Companion for z/OS
Syntax
MVARSIZE=n | nK | nM | nG | MAX
Required Arguments
n
specifies the maximum memory available in bytes.
nK
specifies the maximum memory available in kilobytes.
nM
specifies the maximum memory available in megabytes.
nG
specifies the maximum memory available in gigabytes.
MAX
specifies the maximum memory of 65534.
Details
If the memory required for a macro variable value is larger than the MVARSIZE= value,
the variable is written to a temporary catalog on disk. The macro variable name is used
as the member name, and all members have the type MSYMTAB.
The value that you specify with the MVARSIZE= system option can range from 0 to
65534. A value of 0 causes all macro variable values to be written to disk.
The value of MVARSIZE= can affect system performance. If this option is set too low
and the application frequently creates macro variables larger than the limit, then disk I/O
increases. Before you specify the value for production jobs, run tests to determine the
optimum value.
Note: The MVARSIZE= option has no affect on the maximum length of the value of the
macro variable. For more information, see “Macro Variables” on page 23.
SASAUTOS= System Option
Specifies the location of one or more autocall libraries.
Valid in: Configuration file, OPTIONS window, OPTIONS statement, SAS invocation
Category: Macro
PROC OPTIONS
GROUP=
ENVFILES
MACRO
Type: System option
Default: SASAUTOS
382 Chapter 20 • System Options for Macros
See: “SASAUTOS System Option: UNIX” in SAS Companion for UNIX Environments
“SASAUTOS System Option: Windows” in SAS Companion for Windows
“SASAUTOS= System Option: z/OS” in SAS Companion for z/OS
Syntax
SASAUTOS= library-specification |
(library-specification-1, library-specification-2, …)
Required Arguments
library-specification
identifies a location that contains library members that contain a SAS macro
definition. A location can be a SAS fileref or a host-specific location name enclosed
in quotation marks. Each member contains a SAS macro definition.
(library-specification-1, library-specification-2, ...)
identifies two or more locations that contain library members that contain a SAS
macro definition. A location can be a SAS fileref or a host-specific location name
enclosed in quotation marks. When you specify two or more autocall libraries,
enclose the specifications in parentheses and separate them with either a comma or a
blank space.
Details
SAS automatically generates a fileref named SASAUTOS. This is the default value of
the SASAUTOS= option and points to all the SAS autocall macros. If the value of
SASAUTOS= is overwritten, then SAS no longer knows where to locate its own autocall
macros. When you specify the value of the SASAUTOS= system option, list the fileref
SASAUTOS first, followed by the location of other autocall libraries. This enables SAS
to locate the SAS autocall macros as well as any autocall macros that you have defined.
When SAS searches for an autocall macro definition, it opens and searches each location
in the same order that it is specified in the SASAUTOS option. If SAS cannot open any
specified location, it generates a warning message and sets the NOMAUTOSOURCE
system option on. To use the autocall facility again in the same SAS session, you must
specify the MAUTOSOURCE option again. Also see “MRECALL System Option” on
page 378, which searches the autocall libraries for an undefined macro name each time
an attempt is made to invoke the macro.
Note: When searching the list of library specifications for an autocall macro definition,
SAS silently ignores library access failures due to insufficient access privileges and
continues to search through the list of library specifications.
Operating Environment Information
You specify a source library by using a fileref or by enclosing the host-specific
location name in quotation marks. A valid library specification and its syntax are
host specific. Although the syntax is generally consistent with the command-line
syntax of your operating environment, it might include additional or alternate
punctuation. For more information, see the SAS documentation for your operating
environment.
z/OS Specifics
You can use the APPEND or INSERT system options to add additional library-
specification. For more information, see the documentation for the APPEND and
INSERT system options under UNIX and z/OS.
SASAUTOS= System Option 383
..................Content has been hidden....................
You can't read the all page of ebook, please click here login for view all page.