164 |
|
|
165 |
@display |
@display |
166 |
MATCH FILES |
MATCH FILES |
|
/BY var_list |
|
167 |
/@{FILE,TABLE@}=@{*,'filename'@} |
/@{FILE,TABLE@}=@{*,'filename'@} |
168 |
/DROP=var_list |
/DROP=var_list |
169 |
/KEEP=var_list |
/KEEP=var_list |
170 |
/RENAME=(src_names=target_names)@dots{} |
/RENAME=(src_names=target_names)@dots{} |
171 |
/IN=var_name |
/IN=var_name |
172 |
|
|
173 |
|
/BY var_list |
174 |
/FIRST=var_name |
/FIRST=var_name |
175 |
/LAST=var_name |
/LAST=var_name |
176 |
/MAP |
/MAP |
186 |
The BY subcommand specifies a list of variables that are used to match |
The BY subcommand specifies a list of variables that are used to match |
187 |
records from each of the system files. Variables specified must exist |
records from each of the system files. Variables specified must exist |
188 |
in all the files specified on FILE and TABLE. BY should usually be |
in all the files specified on FILE and TABLE. BY should usually be |
189 |
specified. If TABLE is used then BY is required. |
specified. If TABLE or IN is used then BY is required. |
190 |
|
|
191 |
Specify FILE with a system file as a file name string or file handle |
Specify FILE with a system file as a file name string or file handle |
192 |
(@pxref{FILE HANDLE}), or with an asterisk (@samp{*}) to |
(@pxref{FILE HANDLE}), or with an asterisk (@samp{*}) to |
204 |
files. |
files. |
205 |
|
|
206 |
Any number of FILE and TABLE subcommands may be specified. Each |
Any number of FILE and TABLE subcommands may be specified. Each |
207 |
instance of FILE or TABLE can be followed by DROP, KEEP, and/or RENAME |
instance of FILE or TABLE can be followed by any sequence of DROP, |
208 |
subcommands. These take the same form as the corresponding subcommands |
KEEP, or RENAME subcommands. These have the same form and meaning as |
209 |
of @cmd{GET} (@pxref{GET}), and perform the same functions. |
the corresponding subcommands of @cmd{GET} (@pxref{GET}), but apply |
210 |
|
only to variables in the given file. |
211 |
|
|
212 |
|
Each FILE or TABLE may optionally be followed by an IN subcommand, |
213 |
|
which creates a numeric variable with the specified name and format |
214 |
|
F1.0. The IN variable takes value 1 in a case if the given file |
215 |
|
contributed a row to the merged file, 0 otherwise. The DROP, KEEP, |
216 |
|
and RENAME subcommands do not affect IN variables. |
217 |
|
|
218 |
Variables belonging to files that are not present for the current case |
Variables belonging to files that are not present for the current case |
219 |
are set to the system-missing value for numeric variables or spaces for |
are set to the system-missing value for numeric variables or spaces for |
220 |
string variables. |
string variables. |
221 |
|
|
222 |
IN, FIRST, LAST, and MAP are currently not used. |
FIRST, LAST, and MAP are currently ignored. |
223 |
|
|
224 |
@cmd{MATCH FILES} may not be specified following @cmd{TEMPORARY} |
@cmd{MATCH FILES} may not be specified following @cmd{TEMPORARY} |
225 |
(@pxref{TEMPORARY}) if the active file is used as an input source. |
(@pxref{TEMPORARY}) if the active file is used as an input source. |