-------------------------------------------------------------------------------
help for subsave                                                 (Roger Newson)
-------------------------------------------------------------------------------

 
Save a subset of the dataset in memory to a disk file

        subsave [varlist] [if] [in] using filename [,
               rename(oldvarname_1 newvarname_1 ... oldvarname_n newvarname_n)
               gsort( gsort_list [ , gsort_options ] )
               save_options ]

where gsort_list is a list of one or more elements of the form

        [+|-]varname

(as used by the gsort command), gsort_options is a list of options used by 
gsort, and save_options are options used by save.


Description

subsave saves a subset of the dataset currently in memory, specified by the
varlist and/or the if and/or in qualifiers, to the disk filename specified by
the using qualifier.  This saves the user the trouble of inserting a preserve
statement before a save command and a restore statement after a save command.
This is especially useful in a group of commands between a preserve command and
a restore command, as paired preserve and restore statements cannot be nested.
In the output dataset, variables can be renamed, and observations can be
resorted.


Options

rename(oldvarname_1 newvarname_1 ... oldvarname_n newvarname_n) specifies a
    list of pairs of variable names. The first variable name of each pair
    specifies a variable in the output dataset, which is renamed to the second
    variable name of the pair. This option may be used to change the names of
    output variables to prevent name clashes, especially if the output dataset
    is to be match merged with the old dataset using merge.

gsort( gsort_list [ , gsort_options ] ) specifies a generalized sorting order
    (as recognised by gsort) for the observations in the output dataset
    specified by using.  If rename() is specified, then gsort() must use the
    new names.

save_options are options used by save.


Examples

        . subsave make mpg weight foreign using trash1

        . subsave if foreign using trash1, replace

        . subsave make weight price in 1/50 using trash2, replace

        . subsave make mpg weight foreign using trash1, replace rename(mpg
                mileage weight pounds) gsort(make -foreign)


Author

Roger Newson, Imperial College London, UK.  Email: r.newson@imperial.ac.uk


Also see

 Manual:  [D] gsort, [D] merge, [D] save, [D] use
On-line:  help for gsort, merge, save, use