Institut für Arbeitsmarkt- und Berufsforschung

Navigation zu den wichtigsten Bereichen.

Inhaltsbereich: Institut für Arbeitsmarkt- und Berufsforschung

JoSuA: Frequently Asked Questions

The following FAQ contains a list of known user problems with JoSuA. The list is updated on a regular basis. Please check if your question is included.

The FAQ are of supplementary use only. Further, we’d like to ask you to consult our guidelines as to the use of remote data access and on-site use with JoSuA. These guidelines contain important information on the process of remote data access and on-site use as well as on data privacy provisions.

Changes between the versions JoSuA 2 and JoSuA 3 are outlined in the document New Features in JoSuA.

Our Video-Tutorial offers a short overview for getting started with JoSuA.

Job Submission

Do I need to worry if the message "failed" appears after the run?

No. The status "failed" can occur despite a successful run.

Is it possible to run several jobs in JoSuA at the same time?

Usually, please upload a new job in "Internal-Use" mode only after the previous job has run through.

Can data sets be stored and accessed by subsequent JoSuA jobs?

In JoSuA you can access all data sets stored in your orig or data folders. You can therefore access data sets that you created in earlier Stata runs or during on-site use and that were saved in the data folder of your project share.

Back to top

Upload of Files

What does "Transfers" mean?

"Transfers" is used to transfer scripts before or after on-site use. It is accessible under the main menu item "Transfers" or via Projects -> View -> TRANSFERS -> +. JoSuA. It only accepts uploading or drag & drop of single files; however, it is possible to upload multiple files in one archive file (.zip, .7z). The scripts are available for download after a privacy check. (In order for an archive file to be released, all the files it contains must be safe from a data protection point of view).

What does "Resources" mean?

"Resources" is used to transmit and store additional command libraries, e.g. Stata-Ado packages. The function is accessible via Projects -> View -> RESOURCES -> +. It is only possible to upload single files. These are permanently available in the project for the use within JoSuA, after the data protection check.
This function may only be used for command libraries that are not available elsewhere in the FDZ guest network, e.g. in the repository of Stata-Ado packages (see question "How do I upload Ado files?").
To make ado packages uploaded via RESOURCES available for guest stays as well, they have to be downloaded once during the guest stay and stored in the prog-directory.

How do I upload Ado files?

Ado packages must be installed from the repository using "fdzinstall package name", e. g., "fdzinstall gtools". Except: They are not available there (in the required version). In this case you can use "Resources".

Files cannot be uploaded

Under "Transfers" and "RESOURCES" files can only be uploaded individually (unlike to "Submission"). When transferring scripts before ⁄ after an on-site use ("Transfers"), however, you can pack the individual files beforehand (.zip, .7z).

Back to top

Stata exits with an error

Error indication in the log-file "File not found"

This error indication occurs when the data path is not specified with the intended globals $prog, $data, $orig oder $log. Please use the above-mentioned globals at every path specification because otherwise JoSuA cannot find the data files.
Please be adviced not to use umlauts or special characters in file names.

Log-file master.log ⁄ Error message "log-file already open"

JoSuA automatically creates a log file called master.log. Please don’t create another master.log in your program. Use the command "cap log close" to close the present log file and subsequently open a new log file. For naming conventions please see the guidelines for remote data access.

Error message "File not ok (suspicious mismatch between file suffix and actual file type)"

This error message appears when opening a log-file in Stata’s smcl format. Please create text-only log files. Use the commands "log using "$log\logfile.log", replace" or "log using "$log\logfile", text replace".

Job keeps on restarting

This error appears when a log-file is more than 2 MB of size. Please have the FDZ staff stop your current job and please reduce the amount of output created in future job submission.

Error message "Error!"

The error appears when the combined size of generated output files exceeds 8 MB. Please modify your programs and make sure that less output is generated.

Back to top

Provision of aggregated data files

Is it possible to upload aggregated data files in JoSuA?

No, an upload of aggregated data with JoSuA is not intended. Please upload only do- or ado-files in JoSuA. Please send your aggregated data files via mail to the fdz mail address. You have to provide a description of the variables and data sources as described in the FDZ guidelines for remote data processing.

Back to top



Current limits for job Submission

  • Internal Use Mode: 3 jobs per day / project
  • Presentation / Publication Mode: 8 jobs per month / project


Remote Data Access via JoSuA Video-Tutorial