McIDAS User's Guide
Version 2013.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]

Starting McIDAS-X

To start a McIDAS-X session, log on to your account. Then, run one of the following three commands from a Unix prompt.

Type:  mcidas


Type:  mcidas flags


Type:  mcidas -config

The first command (mcidas) starts a McIDAS-X session using the current settings of the flags in the .mcidasrc file. The flags and their defaults are described in Configuring McIDAS-X Sessions with .mcidasrc. If McIDAS-X has not been previously run in your account, the .mcidasrc file does not exist. In this case, the mcidas command displays the McIDAS-X Configuration GUI (described below) and creates the .mcidasrc file. You can have the Configuration GUI appear each time you start a session with the mcidas command by adding the -config flag to your .mcidasrc file.

The second command (mcidas flags) is similar to the first, except it allows you to override one or more of the flags' settings in the .mcidasrc file by specifying the flags on the command line. This flags option makes it easy to override selected settings in .mcidasrc for the current session. Without the flags option, you would have to change the settings in .mcidasrc, start a session with the mcidas command, then edit .mcidasrc again to change the settings back to their previous values.

The third command (mcidas -config) displays a McIDAS-X Configuration Graphical User Interface (GUI) window with sliders, checkboxes and text fields that are used to select values that override the settings of the corresponding flags in the .mcidasrc file. This Configuration GUI is designed to make one-time (for the current session only) configuration changes easier and less error-prone than other methods like changing flag settings in the .mcidasrc file or specifying the flags in the command line like the mcidas flags option above. The Configuration GUI also includes a "Save Settings" button to save the GUI settings in the .mcidasrc file. However, caution should be used with this option because it replaces the current .mcidasrc file so its settings are lost. To make recovery easier, the option first moves the current .mcidasrc to .mcidasrc.old before creating the new .mcidasrc with the GUI settings.

When a McIDAS-X session is started by any of the three methods above, the following then occur:

Running multiple McIDAS-X sessions

Though not recommended because of possible file conflicts, you can run multiple McIDAS-X sessions from the same account. Multiple sessions include those started with the mcidas script and McIDAS-X commands run from the mcenv process or the Unix scheduler. For more information on using the mcenv process or Unix scripts, see Appendix H, Running Commands Outside a McIDAS-X Session. To differentiate between the files used for various sessions, each session stores many of its files in its own $HOME/.mctmp subdirectory. When you run multiple sessions, the mccheck program warns you if there are files in a MCPATH directory that belong in a .mctmp subdirectory. The mccheck program only provides warnings when you run multiple sessions.

File conflicts are still possible because certain files and directories may be used by all sessions. For example, the default scheduler file, SKEDFILE, is stored in $HOME/mcidas/data (not a .mctmp directory) because it often contains entries to run in subsequent sessions. Therefore, if you are running multiple sessions and the scheduler is on (SKU command), anything scheduled to run in one session runs in all of them. If you need to set different schedulers in separate sessions under the same account, specify the -c 'SKED file' flag when starting each session. The file should be a different scheduler file for each session. Then use keyword FILE to specify the different scheduler files in the SKE and SKU commands.

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]