scosession(XC)

scosession -- manages starting and stopping clients

Command syntax

scosession [Xt_options] [-stop] [-configure] [-help]

Desktop syntax

Double-click on the Session icon in the Preferences Editor in the Controls window.

Description

The session manager client, scosession is responsible for the startup and shutdown of your X server session. Regardless of the method used to actually run the X server, a default Desktop session is controlled by scosession, which defines the clients that run when you start the server and controls their appearance and behavior.

NOTE: After you have logged in, you may find yourself waiting several minutes for the Desktop and clients to start. You can use scosession to circumvent this delay by pressing <Esc>.

Command options

This client supports all Xt_options. In addition, you can issue the following commands:

-stop: shuts down a user's session. A message comes up which, if confirmed by the user, shuts down the clients comprising the session and saves the state of that session.
-configure: configures the clients initially started by scosession. This option brings up a dialog box that allows users to specify if they want subsequent sessions to start in the same state as their previous session, or if they want to start in the default state. This dialog box also allows users to save the current session's state as a customized default state and to choose the option of an interactive logout prompt.

The scosession preferences for each user are stored in the directory:

$HOME/.odtpref/ScoSession

Desktop options

Double-click on the Session icon to bring up the dialog box described for the -configure command option.

Resources

You can customize the characteristics of scosession using your personal X resource file, $HOME/.Xdefaults-hostname, where hostname is the name of the machine on which the client is running. If this file does not exist in your home directory, you will need to create it. Changes made to this file take effect the next time you run scosession.

In addition to recognizing the core resource names and classes, scosession defines the following application-specific resources. Additional resources are listed in /usr/lib/X11/app-defaults/ScoSession.

preferencesDir

specifies a directory containing preferences for the beginning of a session. The default is $HOME/.odtpref/.

defaultSession

specifies the system file that describes the clients to start at session startup. This file is only used if the file specified by staticSession does not exist. The default is /usr/lib/X11/sco/ScoSession/static.

dynamicSession

specifies the user's file that describes the clients to start at session startup when the user wants to continue their last session. The default is $HOME/.odtpref/ScoSession/dynamic.

positionIsFrame

determines if the x and y coordinates of a client's geometry are the x and y coordinates of the top left corner of the window manager's frame surrounding the client or if these coordinates represent the client window's top left corner. This resource should correspond with the manner in which a window manager interprets a client's geometry settings. The default is ``True''.

windowManager

specifies the window manager that scosession starts. The default is /usr/bin/X11/pmwm.

startTimeout

specifies the amount of time in milliseconds that scosession waits for all the clients to start. scosession does not enforce any state or geometry on clients that fail to start during this period. The default is ``120,000'' (two minutes). Note that you can press <Esc> to circumvent the delay sometimes caused by waiting for the Desktop and clients to start.

quitTimeout

specifies the amount of time in milliseconds that scosession waits for a client to shut down. If the value is zero, then scosession waits indefinitely. The default is 0.

saveTimeout

specifies the amount of time in milliseconds that scosession waits for a client to save its state. The default is ``500''.

enableMessages

specifies whether scosession should log system messages, such as those broadcast with the standard write command, including broadcast messages from the system administrator. Whenever a message is received, scosession displays it in a dialog box. The default is ``True''.

enableConsoleErrors

specifies whether scosession should log console error messages that are normally displayed on the console screen. Whenever a message is received, scosession displays it in a dialog box. This resource is only valid if you are on the console and has no effect on X terminals. The default is ``True''.

enablePalette

specifies whether scosession should manage the color palette that provides dynamic color support in SCO OpenServer. The default is ``True''.

enableIdleout

specifies whether scosession should keep track of the amount of time the session is inactive. The default is ``False''.

idleTime

specifies the amount of session idle time (in seconds) that can elapse before the command specified by the exec resource is executed. This resource is only valid if enableIdleout is ``True''. The default is ``1800'' seconds (30 minutes).

exec

specifies the command to execute if the session is idle for the amount of time specified by the idleTime resource. This resource is only valid if enableIdleout is ``True''. The default is /usr/bin/X11/scolock +confirm. This command locks the display until the user types a valid password.

sampleRate

specifies how often (in seconds) scosession samples the display to determine if the session is idle. This resource is only valid if enableIdleout is ``True''. The default is ``60'' seconds.

staticSession

specifies the user's file that describes the clients to start at session startup when the user wants to start their default session. The default is $HOME/.odtpref/ScoSession/static.

sysStartup

specifies the shell script scosession executes at startup. The default is:

   /usr/lib/X11/%L/sco/ScoSession/startup:/usr/lib/X11/sco/ScoSession/startup.

sysShutdown

specifies the shell script scosession executes at shutdown. The default for sysShutdown is:

   /usr/lib/X11/%L/sco/ScoSession/shutdown:/usr/lib/X11/sco/ScoSession/shutdown.

Localization

If you want these files installed in language-specific directories, the following substitutions are available:

%L: equals current locale.
%t: equals territory.
%c: equals codeset.
%l: equals language.

All resources that point to a file or a directory will use these substitutions. In addition to the %L, %l, %t, and %c substitutions, both sysStartup and sysShutdown can accept a colon-separated list of files. scosession executes the first file it finds according to this list.

The default for sysStartup is:
/usr/lib/X11/%L/sco/ScoSession/startup:/usr/lib/X11/sco/ScoSession/startup.

The default for sysShutdown is:
/usr/lib/X11/%L/sco/ScoSession/shutdown:/usr/lib/X11/sco/ScoSession/shutdown.

In addition, resources exist that allow you to localize the client. The string resources that can be localized are in /usr/lib/X11/app-defaults/msg/ScoSession. This file is #included by /usr/lib/X11/app-defaults/ScoSession.

Files

/usr/bin/X11/scosession
/usr/lib/X11/[$LANG]/sco/ScoSession/startup
/usr/lib/X11/[$LANG]/sco/ScoSession/shutdown
/usr/lib/X11/[$LANG]/sco/ScoSession/static
/usr/lib/X11/[$LANG]/app-defaults/ScoSession