27.03.2013 Views

SPSS® 12.0 Command Syntax Reference

SPSS® 12.0 Command Syntax Reference

SPSS® 12.0 Command Syntax Reference

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

1680 XSAVE<br />

Basic Specification<br />

The basic specification is the OUTFILE subcommand, which specifies a name for the SPSSformat<br />

data file to be saved.<br />

Subcommand Order<br />

• Subcommands can be specified in any order.<br />

<strong>Syntax</strong> Rules<br />

• OUTFILE is required and can be specified only once. If OUTFILE is specified more than<br />

once, only the last OUTFILE specification is in effect.<br />

• KEEP, DROP, RENAME, and MAP can be used as many times as needed.<br />

• Only one of the subcommands COMPRESSED or UNCOMPRESSED can be specified per<br />

XSAVE command.<br />

• Documentary text can be dropped from the working data file with the DROP DOCUMENTS<br />

command.<br />

• XSAVE cannot appear within a DO REPEAT—END REPEAT structure.<br />

• Multiple XSAVE commands writing to the same file are not permitted.<br />

Operations<br />

• Unlike the SAVE command, XSAVE is a transformation command and is executed when<br />

the data are read for the next procedure.<br />

• The new SPSS-format data file dictionary is arranged in the same order as the working file<br />

dictionary unless variables are reordered with the KEEP subcommand. Documentary text<br />

from the working file dictionary is always saved unless it is dropped with the DROP DOCU-<br />

MENTS command before XSAVE.<br />

• New variables created by transformations and procedures previous to the XSAVE<br />

command are included in the new SPSS-format data file, and variables altered by transformations<br />

are saved in their modified form. Results of any temporary transformations<br />

immediately preceding the XSAVE command are included in the file; scratch variables<br />

are not.<br />

• SPSS-format data files are binary files designed to be read and written by SPSS only.<br />

SPSS-format data files can be edited only with the UPDATE command. Use the MATCH<br />

FILES and ADD FILES commands to merge SPSS-format data files.<br />

• The working data file is still available for transformations and procedures after XSAVE is<br />

executed.<br />

• XSAVE processes the dictionary first and displays a message that indicates how many variables<br />

will be saved. Once the data are written, XSAVE indicates how many cases were<br />

saved. If the second message does not appear, the file was probably not completely written.

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

Saved successfully!

Ooh no, something went wrong!