| 1 | command SWITCH <switchname> <on/off> |
|---|
| 2 | ============== |
|---|
| 3 | |
|---|
| 4 | key: set global switches |
|---|
| 5 | |
|---|
| 6 | Turns an SH switch on or off. Unless the "/global"-qualifier is |
|---|
| 7 | specified the switch state is changed only locally. |
|---|
| 8 | |
|---|
| 9 | |
|---|
| 10 | parameters |
|---|
| 11 | ---------- |
|---|
| 12 | |
|---|
| 13 | <switchname> --- parameter type: string |
|---|
| 14 | Name of switch to be turned on or off. Valid names see below. |
|---|
| 15 | |
|---|
| 16 | <on/off> --- parameter type: string |
|---|
| 17 | Either keyword "on" (turns switch on) of keyword "off" (turns |
|---|
| 18 | switch off) |
|---|
| 19 | |
|---|
| 20 | valid switch names are (default settings are underlined): |
|---|
| 21 | |
|---|
| 22 | cmderrstop on: On errors, command files are aborted, an error log file |
|---|
| 23 | --- is created and SH returns to the interactive level 0. |
|---|
| 24 | |
|---|
| 25 | off: Command files don't care about errors and continue |
|---|
| 26 | execution. Be careful turning this switch off, use it |
|---|
| 27 | only in fail-safe command files. |
|---|
| 28 | |
|---|
| 29 | sherrstop on: On errors the whole seismhandler session is aborted. |
|---|
| 30 | Useful mainly for batch jobs which should be terminated |
|---|
| 31 | on errors to prevent them from working on erroneus data. |
|---|
| 32 | |
|---|
| 33 | off: Errors cause error messages but no program exit. |
|---|
| 34 | ---- |
|---|
| 35 | |
|---|
| 36 | verify on: Each command (interactively entered or read from command |
|---|
| 37 | file) is displayed on screen after translating all |
|---|
| 38 | parameters. |
|---|
| 39 | |
|---|
| 40 | off: Commands are not displayed. |
|---|
| 41 | ---- |
|---|
| 42 | |
|---|
| 43 | protocol on: Each interactive command is logged in the session |
|---|
| 44 | --- protocol file. The actual name of the session |
|---|
| 45 | protocol file depends on the operating system. |
|---|
| 46 | |
|---|
| 47 | off: The commands are not logged in the protocol file. |
|---|
| 48 | |
|---|
| 49 | echo on: Each command is echoed on the info channel(s) before |
|---|
| 50 | translation. |
|---|
| 51 | |
|---|
| 52 | off: The commands are not echoed |
|---|
| 53 | ---- |
|---|
| 54 | |
|---|
| 55 | capcnv on: The whole command line is converted to uppercase letters |
|---|
| 56 | --- before translation. |
|---|
| 57 | |
|---|
| 58 | off: Lowercase letters are not converted. In this case you |
|---|
| 59 | have to enter all command verbs and keywords in uppercase |
|---|
| 60 | otherwise they will not be recognized. |
|---|
| 61 | |
|---|
| 62 | step on: Stops execution of a command procedure after each command, |
|---|
| 63 | displays the original comand line and waits for input |
|---|
| 64 | of <CR>. |
|---|
| 65 | |
|---|
| 66 | off: Command procedures are processed normally. |
|---|
| 67 | ---- |
|---|
| 68 | |
|---|
| 69 | noerrmsg on: On errors no error messages are displayed and no |
|---|
| 70 | warning bell is generated. Useful in combination |
|---|
| 71 | with "cmderrstop" flag if possibly occurring errors |
|---|
| 72 | are handled inside a command procedure. |
|---|
| 73 | |
|---|
| 74 | off: Errors cause messages and warning bell. |
|---|
| 75 | ---- |
|---|
| 76 | |
|---|
| 77 | chatty on: Some commands print an information message, for |
|---|
| 78 | --- example "sum" or "write". |
|---|
| 79 | |
|---|
| 80 | off: The information message is suppressed. This is |
|---|
| 81 | useful in command procedures whode internal structure |
|---|
| 82 | should be hidden from the user. |
|---|
| 83 | |
|---|
| 84 | startup special flag. A startup file of SH must contain the |
|---|
| 85 | command "switch startup off". |
|---|
| 86 | |
|---|
| 87 | |
|---|
| 88 | qualifiers |
|---|
| 89 | ---------- |
|---|
| 90 | |
|---|
| 91 | /global |
|---|
| 92 | The specified switch is changed globally and not only local to |
|---|
| 93 | the current command level. |
|---|
| 94 | |
|---|
| 95 | |
|---|
| 96 | example |
|---|
| 97 | ------- |
|---|
| 98 | |
|---|
| 99 | switch cmderrstop off ! switches cmderrstop flag off |
|---|
| 100 | |
|---|
| 101 | |
|---|
