scosession(X) 19 June 1992 scosession(X) Name scosession - manage starting and stopping clients Command syntax scosession [Xtoptions] [-stop] [-configure] [-help] Desktop syntax Double-click on the Session icon. The Session icon is located, by default, in the Controls. Description The scosession client allows you to customize how you start and exit an X session. Command options This client supports all Xtoptions. In addition, you can issue the fol- lowing commands: -stop shuts down a user's session. A dialog box pops 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 sub- sequent 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. -help provides a list of the options available Desktop options Use scosession -configure if you want to change how you log in and log out. You can also use it to modify the default appearance of your clients when you log in. The ``When I log in'' field gives you three options: Resume previous session. Click this to always return to the session as you left it when you logged out. Start a new session (my desktop). Click this to return to the default session, as defined by you or the system. Ask each time. Click this to be asked each time you log in which option you prefer. The ``When I log out'' field gives you one option: Confirm that I want to log out. Click this to get a dialog box asking you to confirm your deci- sion to log out appears each time you exit an X session. The ``For my default Desktop'' field gives you one option: Save current configuration. Click on this to change the default appearance of your clients when you log in and have the current state become the default appearance. After you have made your Session selections, click on OK to exit and implement your changes. To return to the previous Session options, click on Cancel. Resources You can customize some characteristics of scosession by editing your own personal X resource file; this file contains user preferences for all of the X clients. If the file does not already exist, create it with the full pathname: $HOME/.Xdefaults-hostname/ScoSession where $HOME represents your home directory and hostname is the name of the machine. The most common resources are listed here. For guidelines on how to modify the resources, refer to the Graphical Environment Administrator's Guide. preferencesDir specifies a directory containing preferences for the beginning of a session. The default is $HOME/.odtpref/. 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 set- tings. The default is true. windowManager specifies the window manager that scosession starts. The default is /usr/bin/X11/mwm. 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 60,000 (1 minute). 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. Preferences The scosession preferences for each user are stored in: $HOME/.odtpref/ScoSession If this file is edited before a user starts a session, it could be confusing if the Desktop is not configured as the user expects. Files /usr/bin/X11/scosession /usr/lib/X11/ScoSession /usr/lib/X11/$LANG/ScoSession $HOME/.odtpref/ScoSession $HOME/.Xdefaults-hostname/ScoSession See also Xtoptions(X)