Next: , Previous: QUIT, Up: Utilities



13.15 SET

     SET
     
     (data input)
             /BLANKS={SYSMIS,'.',number}
             /DECIMAL={DOT,COMMA}
             /FORMAT=fmt_spec
             /EPOCH={AUTOMATIC,year}
     
     (program input)
             /ENDCMD='.'
             /NULLINE={ON,OFF}
     
     (interaction)
             /CPROMPT='cprompt_string'
             /DPROMPT='dprompt_string'
             /ERRORBREAK={OFF,ON}
             /MXERRS=max_errs
             /MXWARNS=max_warnings
             /PROMPT='prompt'
             /VIEWLENGTH={MINIMUM,MEDIAN,MAXIMUM,n_lines}
             /VIEWWIDTH=n_characters
     
     (program execution)
             /MEXPAND={ON,OFF}
             /MITERATE=max_iterations
             /MNEST=max_nest
             /MPRINT={ON,OFF}
             /MXLOOPS=max_loops
             /SEED={RANDOM,seed_value}
             /UNDEFINED={WARN,NOWARN}
     
     (data output)
             /CC{A,B,C,D,E}={'npre,pre,suf,nsuf','npre.pre.suf.nsuf'}
             /DECIMAL={DOT,COMMA}
             /FORMAT=fmt_spec
     
     (output routing)
             /ECHO={ON,OFF}
             /ERRORS={ON,OFF,TERMINAL,LISTING,BOTH,NONE}
             /INCLUDE={ON,OFF}
             /MESSAGES={ON,OFF,TERMINAL,LISTING,BOTH,NONE}
             /PRINTBACK={ON,OFF}
             /RESULTS={ON,OFF,TERMINAL,LISTING,BOTH,NONE}
     
     (output activation)
             /LISTING={ON,OFF}
             /PRINTER={ON,OFF}
             /SCREEN={ON,OFF}
     
     (output driver options)
             /HEADERS={NO,YES,BLANK}
             /LENGTH={NONE,length_in_lines}
             /LISTING=filename
             /MORE={ON,OFF}
             /PAGER={OFF,"pager_name"}
             /WIDTH={NARROW,WIDTH,n_characters}
     
     (logging)
             /JOURNAL={ON,OFF} [filename]
             /LOG={ON,OFF} [filename]
     
     (system files)
             /COMPRESSION={ON,OFF}
             /SCOMPRESSION={ON,OFF}
     
     (security)
             /SAFER=ON
     
     (obsolete settings accepted for compatibility, but ignored)
             /AUTOMENU={ON,OFF}
             /BEEP={ON,OFF}
             /BLOCK='c'
             /BOXSTRING={'xxx','xxxxxxxxxxx'}
             /CASE={UPPER,UPLOW}
             /COLOR=...
             /CPI=cpi_value
             /DISK={ON,OFF}
             /EJECT={ON,OFF}
             /HELPWINDOWS={ON,OFF}
             /HIGHRES={ON,OFF}
             /HISTOGRAM='c'
             /LOWRES={AUTO,ON,OFF}
             /LPI=lpi_value
             /MENUS={STANDARD,EXTENDED}
             /MXMEMORY=max_memory
             /PTRANSLATE={ON,OFF}
             /RCOLORS=...
             /RUNREVIEW={AUTO,MANUAL}
             /SCRIPTTAB='c'
             /TB1={'xxx','xxxxxxxxxxx'}
             /TBFONTS='string'
             /WORKDEV=drive_letter
             /WORKSPACE=workspace_size
             /XSORT={YES,NO}

SET allows the user to adjust several parameters relating to PSPP's execution. Since there are many subcommands to this command, its subcommands will be examined in groups.

On subcommands that take boolean values, ON and YES are synonym, and as are OFF and NO, when used as subcommand values.

The data input subcommands affect the way that data is read from data files. The data input subcommands are

BLANKS
This is the value assigned to an item data item that is empty or contains only white space. An argument of SYSMIS or '.' will cause the system-missing value to be assigned to null items. This is the default. Any real value may be assigned.
DECIMAL
The default DOT setting causes the decimal point character to be .. A setting of COMMA causes the decimal point character to be ,.
FORMAT
Allows the default numeric input/output format to be specified. The default is F8.2. See Input/Output Formats.
EPOCH
Specifies the range of years used when a 2-digit year is read from a data file or used in a date construction expression (see Date Construction). If a 4-digit year is specified, then 2-digit years are interpreted starting from that year, known as the epoch. If AUTOMATIC (the default) is specified, then the epoch begins 69 years before the current date.

Program input subcommands affect the way that programs are parsed when they are typed interactively or run from a script. They are

ENDCMD
This is a single character indicating the end of a command. The default is .. Don't change this.
NULLINE
Whether a blank line is interpreted as ending the current command. The default is ON.

Interaction subcommands affect the way that PSPP interacts with an online user. The interaction subcommands are

CPROMPT
The command continuation prompt. The default is > .
DPROMPT
Prompt used when expecting data input within BEGIN DATA (see BEGIN DATA). The default is data> .
ERRORBREAK
Whether an error causes PSPP to stop processing the current command file after finishing the current command. The default is OFF.
MXERRS
The maximum number of errors before PSPP halts processing of the current command file. The default is 50.
MXWARNS
The maximum number of warnings + errors before PSPP halts processing the current command file. The default is 100.
PROMPT
The command prompt. The default is PSPP> .
VIEWLENGTH
The length of the screen in lines. MINIMUM means 25 lines, MEDIAN and MAXIMUM mean 43 lines. Otherwise specify the number of lines. Normally PSPP should auto-detect your screen size so this shouldn't have to be used.
VIEWWIDTH
The width of the screen in characters. Normally 80 or 132.

Program execution subcommands control the way that PSPP commands execute. The program execution subcommands are

MEXPAND
MITERATE
MNEST
MPRINT
Currently not used.
MXLOOPS
The maximum number of iterations for an uncontrolled loop (see LOOP).
SEED
The initial pseudo-random number seed. Set to a real number or to RANDOM, which will obtain an initial seed from the current time of day.
UNDEFINED
Currently not used.

Data output subcommands affect the format of output data. These subcommands are

CCA
CCB
CCC
CCD
CCE
Set up custom currency formats. The argument is a string which must contain exactly three commas or exactly three periods. If commas, then the grouping character for the currency format is ,, and the decimal point character is .; if periods, then the situation is reversed.

The commas or periods divide the string into four fields, which are, in order, the negative prefix, prefix, suffix, and negative suffix. When a value is formatted using the custom currency format, the prefix precedes the value formatted and the suffix follows it. In addition, if the value is negative, the negative prefix precedes the prefix and the negative suffix follows the suffix.

DECIMAL
The default DOT setting causes the decimal point character to be .. A setting of COMMA causes the decimal point character to be ,.
FORMAT
Allows the default numeric input/output format to be specified. The default is F8.2. See Input/Output Formats.

Output routing subcommands affect where the output of transformations and procedures is sent. These subcommands are

ECHO
If turned on, commands are written to the listing file as they are read from command files. The default is OFF.
ERRORS
INCLUDE
MESSAGES
PRINTBACK
RESULTS
Currently not used.

Output activation subcommands affect whether output devices of particular types are enabled. These subcommands are

LISTING
Enable or disable listing devices.
PRINTER
Enable or disable printer devices.
SCREEN
Enable or disable screen devices.

Output driver option subcommands affect output drivers' settings. These subcommands are

HEADERS
LENGTH
LISTING
MORE
PAGER
WIDTH

Logging subcommands affect logging of commands executed to external files. These subcommands are

JOURNAL
LOG
Not currently used.

System file subcommands affect the default format of system files produced by PSPP. These subcommands are

COMPRESSION
Not currently used.
SCOMPRESSION
Whether system files created by SAVE or XSAVE are compressed by default. The default is ON.

Security subcommands affect the operations that commands are allowed to perform. The security subcommands are

SAFER
Setting this option disables the following operations:

Be aware that this setting does not guarantee safety (commands can still overwrite files, for instance) but it is an improvement. When set, this setting cannot be reset during the same session, for obvious security reasons.