*! version 1.2 18 June 2019
help for neps setversion 1.2 (18 June 2019)

Title

neps set -- Helper command to record preferences that the neps : prefix command might use in the Stata session.

Table of contents

Syntax
Options
Description
Remarks
Examples
Authors
Also see

Syntax

Set NEPS Scientific Use File parameters for the current Stata session

neps set parameter "value" [ parameter "value" ... ] [, replace]

replace replace already set parameters, if any

Description

The neps set command is a helper command to the neps : prefix command.
It enables users to set any parameter that neps : may use permanently in the Stata session.

The basic syntax is

. neps set <parameter> <value>

where <parameter> is the name of a parameter (e.g. "version"),

and <value> is the value to store (e.g. "9.1.1").

Be sure to specify <value> in double quotes if it contains spaces.

Several <parameter> / <value> settings can be placed in one invocation of neps set.

Options

Main

replace if specified, parameters to be set will overwrite previously set parameters.

If not specified, a warning message will be displayed if already set, conflicting parameters are detected.

Remarks

Technically, neps set is no more than a wrapper for creating and filling global macros.
The name of a global that is saved is concatenated from the prefix "NEPS_" and the parameter name.

This means that invoking

. neps set version "9.1.1" study "SC4"

has the same effect as executing

. global NEPS_version "9.1.1"

. global NEPS_study "SC4"

However, neps set additionally checks if the corresponding global macros have been previously defined, and warns the user if so.

Note that neps set does not check the saved parameters for validity or consistency.
It is the user's task to make sure only valid parameters are neps set.

Further note that manually specifying parameters as option to the neps : prefix command always takes precedence over recorded parameters from neps set.

This command is part of the NEPStools bundle, written to assist with the NEPS dataset files.

The source code of the program is licensed under the GNU General Public License version 3 or later. The corresponding license text can be found on the internet at http://www.gnu.org/licenses/ or in gnugpl.

Examples

Set the NEPS sub-study to use to "SC4":

. neps set study "SC4"

Set the NEPS version to use to "9.1.1":

. neps set version "9.1.1"

Set the directory path to read NEPS files from to "C:\my path":

. neps set directory "C:\my path"

Do all of the above in one step:

. neps set study "SC4" version "9.1.1" directory "C:\my path"

Authors

Daniel Bela (daniel.bela@lifbi.de), Leibniz Institute for Educational Trajectories (LIfBi), Germany.

Also see

neps :, NEPStools