Syntax

           ┌◄──────────────────────────────────┐
──┬─ SO ─┬─┴─┬───────────────────────────────┬─┴───────────────────────┤
  └─ RO ─┘   ├─ GETWARN ───┬─────────────────┤
             │             └─ = ─┬─ SET ─────┤
             │                   ├─ RESET ───┤
             │                   └─ DEFAULT ─┤
             ├─ CASED ───────────────────────┤
             ├─ DISPLAYONLYTOMCS ────────────┤
             ├─ MSG ─────────────────────────┤
             ├─ MESSAGE ─────────────────────┤
             ├─ NOJOBSUMIO ──────────────────┤
             ├─ QWAIT ───────────────────────┤
             ├─ SHOWALLFILES ────────────────┤
             ├─ UNNAMED ─────────────────────┤
             └─ AUTORECOVER ─────────────────┘

Explanation

The SO and RO commands control the setting and resetting of session options, respectively.

The current state of session options is displayed if either the RO or SO command is entered without a specified session option.

GETWARN

The GETWARN session option controls the behavior of CANDE when a user attempts to get a previously loaded workfile. This option can be used to affect workfiles that have been loaded during other CANDE sessions.

The GETWARN option can also be used by individual users to override the NOGETWARN option set using the CANDE ?OP control command so that users can control CANDE behavior according to their own needs.

When the GETWARN option is

The ?OP command is explained in the CANDE Configuration Reference Manual.

CASED

The CASED option controls the case sensitivity of the REPLACE command for the CANDE session.

When the CASED option is

The options CASED and UNCASED for the FIND and REPLACE commands override the case sensitivity set at the CANDE session level.

DISPLAYONLYTOMCS

The DISPLAYONLYTOMCS option control the default value for the DISPLAYONLYTOMCS task attribute. The value of this option is first set by the ?OP control option. The task attribute can still be set for each task.

The DISPLAYONLYTOMCS task attribute specifies whether any DISPLAY messages created by the process are displayed at the ODT. The operator can use the MSG (Display Messages) system command to list recent system messages.

If a process was not created from an MCS session, DISPLAY messages appear in the MSG command output, regardless of the setting of DISPLAYONLYTOMCS.

If a process was initiated from an MCS session and DISPLAYONLYTOMCS is FALSE, then DISPLAY messages appear in the MSG command output, as well as at the session that initiated the process. If a process was initiated from an MCS session and DISPLAYONLYTOMCS is TRUE, then DISPLAY messages appear only at the session that initiated the process. A DISPLAYONLYTOMCS value of TRUE allows a process to communicate with an end user without distracting the operator.

For detailed information about the DISPLAYONLYTOMCS task attribute, refer to the Task Attributes Programming Reference Manual. For information about the CANDE command ?OP, refer to the CANDE Configuration Reference Manual.

MESSAGE MSG

MSG

The MSG session option controls the automatic display of job-related and task-related messages at your terminal during a CANDE session. MESSAGE and MSG are synonyms.

If MSG is

CANDE returns only those messages to a station from which jobs and tasks were initiated. Because an LSN is assigned to each station and pseudostation and the LSN is used in message transferring, you might not see messages from a job if you are on a station other than the job-initiating station.

For example, if LSN 100 and 101 are logged on under the same usercode, and LSN 100 initiates a job, LSN 101 will not receive messages for the job initiated from LSN 100 even if messages are enabled with the SO command.

The default value of the MSG option is determined by the CANDEGETMSG Boolean setting for the usercode in the SYSTEM/USERDATAFILE.

NOJOBSUMIO

The NOJOBSUMIO option assigns the NOJOBSUMMARYIO task attribute to any task initiated from a CANDE session. Any assignments made to the task affect the job summary for the session.

The NOJOBSUMMARYIO value is inherited by a new session started with the SPLIT command.

QWAIT

The QWAIT option specifies that the state of the user's queued input is to be set to waiting rather than pending in the event of an error. (Refer to Input Queue Manipulation for details.)

The default value of the QWAIT option is determined by the CANDEQWAIT Boolean setting for the usercode in the SYSTEM/USERDATAFILE.

SHOWALLFILES

The SHOWALLFILES option controls at the session level whether nonresident file names are displayed when the FILES command is used to list files.

If SHOWALLFILES is

The ?SO and ?RO command option SHOWALLFILES is a session level option that overrides the global SHOWALLFILES option of the ?OP network control command. However, both global and session option settings can be overridden by the FILES command modifiers RES, NON, or ALL. Refer to the CANDE Configuration Reference Manual for more information about the ?OP network control command. See the FILES command in this manual for a description of the RES, NON, and ALL modifiers.

UNNAMED

The UNNAMED option controls whether an unnamed work file is created or the work file under your usercode is retrieved when you use the GET or LOAD command.

If you specify the UNNAMED option with the SO command, you will get an unnamed work file when you specify your usercode and/or your primary family with a subsequent GET command. An unnamed work file is also known as a foreign file.

If the UNNAMED option is not set (or reset with the RO command) and you specify your usercode and/or primary family with the file name, then your file is retrieved as a work file. By default, the UNNAMED option is not set.

AUTORECOVER

The AUTORECOVER option controls the action of CANDE when processing any recovery file, including the recovery file discovered after successfully logging on.

The default value for the AUTORECOVER option is determined by the

If the option CANDEAUTORECOVER is not initialized for the specified usercode, then the default value used is RESET.

The default value of AUTORECOVER for a session can be determined by the following table:

The SO and RO commands are also available as control commands (?SO and ?RO). The only difference is that the control forms can be entered when a remote file is open or the station is busy, whereas the noncontrol forms are queued if entered while the station is busy.

Examples

SO GETWARN
#GETWARN SET
SO
#MESSAGES SET, QWAIT RESET, AUTORECOVER RESET,
          SHOWALLFILES RESET, UNNAMED RESET,
          DISPLAYONLYTOMCS RESET, GETWARN SET,
         CASED RESET, NOJOBSUMIO RESET

SO MESSAGES
#MESSAGES SET

SO GETWARN=RESET QWAIT
#GETWARN RESET
#QWAIT SET

SO AUTORECOVER
#AUTORECOVER SET

SO UNNAMED
#UNNAMED SET

SO CASED
#CASED SET

SO
#MESSAGES SET, QWAIT SET, AUTORECOVER SET, 
          SHOWALLFILES RESET, UNNAMED SET, 
          DISPLAYONLYTOMCS RESET, GETWARN RESET,
          CASED SET, NOJOBSUMIO RESET

RO
#MESSAGES SET, QWAIT SET, AUTORECOVER SET, 
          SHOWALLFILES RESET, UNNAMED SET, 
          DISPLAYONLYTOMCS RESET, GETWARN RESET,
          CASED SET, NOJOBSUMIO RESET

RO MESSAGES
#MESSAGES RESET

SO NOJOBSUMIO
#NOJOBSUMIO SET 

RO QWAIT
#QWAIT RESET

RO AUTORECOVER
#AUTORECOVER RESET

RO GETWARN UNNAMED
#GETWARN RESET
#UNNAMED RESET

RO CASED
#CASED RESET