02.05.2013 Views

SAS(R) 9.1.3 Companion for z/OS

SAS(R) 9.1.3 Companion for z/OS

SAS(R) 9.1.3 Companion for z/OS

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

474 LOGPARM= System Option Chapter 18<br />

Syntax Description<br />

OPEN=<br />

when a log file already exists, controls how the contents of the existing file are<br />

treated.<br />

APPEND<br />

appends the log when opening an existing file. If the file does not already exist, a<br />

new file is created. This option cannot be used if the LOG= system option specifies<br />

a member of a PDS or PDSE.<br />

REPLACE<br />

overwrites the current contents when opening an existing file. If the file does not<br />

already exist, a new file is created.<br />

REPLACEOLD<br />

appends the log when opening an existing file. If the file does not already exist, a<br />

new file is created. This option cannot be used if the LOG= system option specifies<br />

a member of a PDS or PDSE.<br />

Default: REPLACE<br />

ROLLOVER=AUTO|NONE|SESSION<br />

controls when or if the <strong>SAS</strong> log “rolls over,” that is, when the current log is closed<br />

and a new one is opened.<br />

AUTO<br />

causes an automatic “rollover” of the log when the directives in the value of the<br />

LOG= option change, that is, the current log is closed and a new log file is opened.<br />

Interaction: The name of the new log file is determined by the value of the LOG=<br />

system option. If LOG= does not contain a directive, however, the name would<br />

never change, so the log would never roll over, even when ROLLOVER=AUTO.<br />

Note: Because the directives do not resolve, specifying a % instead of a #<br />

would result in an invalid name <strong>for</strong> a native z/<strong>OS</strong> user. R<br />

NONE<br />

specifies that rollover does not occur, even when a change occurs in the name that<br />

is specified with the LOG= option.<br />

Interaction: If the LOG= value contains any directives, they do not resolve. For<br />

example, if Log="#b.log" is specified, the directive “#” does not resolve, and the<br />

name of the log file remains "#b.log".<br />

SESSION<br />

at the beginning of each <strong>SAS</strong> session, opens the log file, resolves directives that<br />

are specified in the LOG= system option, and uses its resolved value to name the<br />

new log file. During the course of the session, no rollover is per<strong>for</strong>med.<br />

Default: NONE<br />

Interaction: Rollover is triggered by a change in the value of the LOG= option.<br />

See Also: LOG= system option<br />

WRITE=<br />

specifies when content is written to the <strong>SAS</strong> log.<br />

BUFFERED<br />

writes content to the <strong>SAS</strong> log only when a buffer is full in order to increase<br />

efficiency.<br />

IMMEDIATE

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!