IBM Tivoli Software IBM Tivoli Software

[ Bottom of Page | Previous Page | Next Page | Contents ]


Configuring the concurrent login feature

After installing the concurrent login feature as described in Installing the concurrent login feature, you can configure the registry keys created on the endpoints by the Tivoli_login_control_4.2.1.spb software package.

The registry keys are created in the following locations within the Registry Editor:

To view and edit the registry keys, use the wdepcem command. For more information on this command, see wdepcem.

The following is a list of all the registry keys created on the endpoints:

Keys located in HKEY_LOCAL_MACHINE\SOFTWARE\Tivoli\SWDnotification

IsEnabled
Specifies whether the concurrent login feature is enabled. Supported values are 1, which means that the feature is enabled, and 0, which means that the feature is disabled. The default value is 1.
TraceLevel
Specifies the tracing level. Supported values are as follows:
0
Traces are disabled. This is the default value.
1
Standard tracing is enabled.
2
Verbose tracing is enabled.
TracePath
Specifies the full path and name of the trace files. The default value is: $(system_drive)\SWDnotification.log.
DenyPopupEnabled
Specifies whether a message must be displayed on the endpoint to notify the user that login is temporarily disabled. Supported values are 1, which means that the dialog is displayed, and 0 which means that the dialog is not displayed. The default value is 1.
PopUpTimeout
Specifies how many seconds the message must be displayed on the endpoint if you set the DenyPopupEnabled key to 1. The default value is 10.
LoginDeniedTitle
Defines the title of the dialog box displayed on the endpoint if you set the DenyPopupEnabled key to 1. The default value is SWDNotification.
LoginDeniedMsg
Defines the text contained in the dialog box displayed on the endpoint if you set the DenyPopupEnabled key to 1. When customizing the message, you can use the \r\n symbols for inserting a carriage return. The default value is: "Distribution in progress\r\nLogon temporarily disabled."
DenyLogonOnPauseError
Specifies whether the user is allowed to log in to the workstation if an error occurs during an attempt to pause the distribution. Supported values are 1, which means the user is not allowed to log in, and 0, which means the user is allowed to log in. The default value is 1.
LoginDeniedMsgOnPauseError
Defines the text contained in the dialog box displayed on the endpoint if the distribution cannot be paused and you set the DenyLogonOnPauseError key to 1. When customizing the message, you can use the \r\n symbols for inserting a carriage return and the $(DIST_ID) variable which is replaced at run time with the distribution ID. The default value is: " The pause failed for distribution $(DIST_ID)\r\n Contact system administrator."
SwitchPopupDesktop
Specifies whether the message displayed on the endpoint if you set the DenyPopupEnabled key to 1, must be shown on a new Windows(R) desktop. Supported values are 0, which means the default Windows desktop is used, and 1, which means a new Windows desktop is used. The default value is 1.
LogoffType
Specifies which type of logoff must be performed. Supported values are as follows
0
Performs a standard logoff. This is the default value.
1
Performs a forced log off ending all active processes.
2
Performs a logoff ending active and hung processes.
DefaultShutdownAllowdBeforeReset
Defines the number of shutdown operations after which the user is allowed to log in again. This key prevents the user from being irrecoverably logged out of the workstation. The default value is 20.
CompletionPopupEnabled
Specifies whether a message is displayed on the endpoint to notify the user that the distribution has completed and login is allowed. Supported values are 0, which means the message is not displayed, and 1, which means the message is displayed.
CompletionProgramPath
Specifies the path to the application that manages the message to be displayed if you set the CompletionPopupEnabled to 1. Use this key if you modified the path where wcompmsg.exe is installed or if you want to use a different application for managing the message.
CompletionPopupTitle
Defines the title of the dialog box displayed on the endpoint if you set the CompletionPopupEnabled key to 1. The default value is SWDNotification.
CompletionPopupMsg
Defines the text contained in the dialog box displayed on the endpoint if you set the CompletionPopupEnabled key to 1. When customizing the message, you can use the \n symbol for inserting a carriage return. The default value is: "Distribution complete\nLogon is now permitted."
ShutdownPopupEnabled
Specifies whether a message is displayed when you attempt to perform a shutdown during a distribution for which shutdown has been disabled. You must choose between performing a logoff immediately, performing a restart immediately, or performing a logoff immediately and subsequently a shutdown when the distribution completes. See also LogoffShutdownString. Supported values are 0, which means the message is not displayed, and 1, which means the message is displayed. The default value is 1.
ShutdownPopupMsg
Defines the text contained in the dialog box displayed on the endpoint if you set the ShutdownPopupEnabled key to 1. When customizing the message, you can use the \n symbol for inserting a carriage return. The default value is: "The machine will shut down when the distribution completes."

Keys located in HKEY_LOCAL_MACHINE\SOFTWARE\Tivoli\SWDnotification\upcall

LCF_BINDIR
Is the fully qualified path to the LCF_BINDIR.
LCF_CACHEDIR
Is the fully qualified path to the LCF_CACHEDIR.
LCF_DATDIR
Is the fully qualified path to the LCF_DATDIR.
UpcallProgram
Is the fully qualified path to the application which communicates with the gateway.
UpcallTimeout
Specifies the timeout in seconds for communicating with the gateway. The default value is 120 seconds.

Keys located in HKEY_LOCAL_MACHINE\SOFTWARE\Tivoli\SWDnotification\wmansd

Title
Defines the title of the dialog box displayed on the endpoint if you set the ShutdownPopupEnabled key to 1 and the user attempts to perform a shutdown during a distribution for which shutdown has been disabled. The default value is SWDNotification.
Message
Defines the message contained in the dialog box displayed on the endpoint if you set the ShutdownPopupEnabled key to 1 and the user attempts to perform a shutdown during a distribution for which shutdown has been disabled. When customizing the message, you can use the \n symbol for inserting a carriage return. The default value is: "Please choose one of the following."
Timeout
Specifies a timeout in seconds for choosing between a logoff, a restart, and a logoff and shutdown. If you set the timeout to 0, the message is not displayed and the default action is performed. Otherwise, the default action is performed after the timeout expires. For more information on the default action, see DefaultAction. The default value is 0.
LogoffString
Defines the first option displayed in the message to request whether a logoff should be performed. If you select this option, a logoff is performed immediately. The default value is "Logoff".
LogoffShutdownString
Defines the second option displayed in the message to request whether a logoff and a shutdown should be performed. If you select this option, a logoff is performed immediately and a shutdown is performed when the distribution completes. The default value is "Logoff and shutdown when complete".
RestartString
Defines the third option displayed in the shutdown message to request whether a restart should be performed. If you select this option, a restart is performed immediately. The default value is "Restart".
DefaultAction
Specifies the default action to be performed when the timeout expires or is set to 0. Supported values are as follows:
1
Performs a logoff immediately.
2
Performs a logoff immediately and a shutdown when the distribution completes. This is the default value.
3
Performs a restart immediately.
LeftLogonPopupEnabled
Specifies whether a message must be displayed on the endpoint listing the number of logins allowed on the workstation. You can define this key when limited logins are allowed during the distribution. If an error occurs and the distribution cannot be paused, the message is not displayed. Supported values are 0, which means the message is not displayed, and 1, which means the message is displayed. The default value is 1.
LeftLogonPopupMsg
Defines the message contained in the dialog box displayed on the endpoint if you set the LeftLogonPopupEnabled key to 1. When customizing the message, you can use the \n symbol for inserting a carriage return and the $(LEFT_LOGON) variable which is replaced at run time with the number of allowed logins. The default value is: "The current distribution has been paused\nYou can logon $(LEFT_LOGON) times."

[ Top of Page | Previous Page | Next Page | Contents | ]