You can use the ctxcfg tool with the -t switch to specify time-out intervals for connected, disconnected, and idle ICA sessions.
To enable shadowing Use the command
So that sessions on the server can be shadowed.
By default, input is set to on and notify to on. ctxcfg -s enable
To change the input and notify options Use the command
So that the shadower can input keyboard and
mouse actions to the shadowed session. ctxcfg -s input=on So that the shadower cannot input keyboard and
mouse actions to the shadowed session. ctxcfg -s input=off So that the shadowed user gets a notification
message requesting confirmation that the shadowing can occur.
ctxcfg -s notify=on
So that the shadowed user does not get a
notification message. ctxcfg -s notify=off
To disable shadowing Use the command
So that sessions on the server cannot be
shadowed. ctxcfg -s disable
Important Disabling shadowing notification means that users might be shadowed by another user, but be unaware that they are being shadowed. Some countries require by law that users be notified before shadowing occurs.
These settings specify time-out intervals in minutes or seconds. The time-outs are:
Connection The maximum connection duration (in minutes). If a connection duration is specified, the session is disconnected or terminated when the specified duration elapses. If NONE is specified, the connection timer is disabled.
Disconnection The maximum duration that a disconnected session is retained (in minutes). If a disconnection duration is specified, sessions in the disconnected state are either terminated or logged off when the specified duration elapses. If NONE is specified, the disconnection timer is disabled.
Log off Disconnected sessions can be logged off when the specified duration elapses. You must also set the disconnection time-out for this to take effect. If NONE is specified, the disconnected session is reset unless the disconnection time-out is also set to NONE.
If log off fails, the session is reset.
Idle The maximum idle time (time without user activity) allowed before the session is disconnected or reset (in minutes). If an idle duration is specified, the session is disconnected or reset when the specified interval elapses without any activity on the connection. If NONE is specified, the idle timer is disabled. To specify whether sessions are disconnected or reset, see “Controlling Behavior for Disconnected or Broken Connections” on page 111. To specify an idle time-out period for anonymous users, see “Configuring Anonymous Users” on page 135.
Authentication The maximum duration that a session in the connected state exists on the server, prior to the user logging on or reconnecting (in minutes). When the specified duration elapses, the session is reset. This is useful, for example, if network problems result in sessions becoming stuck in the “conn” state; using this setting means you do not have to reset these sessions manually.
Client check The maximum period of time before the server checks that a client is still connected and responsive (in seconds). If a client check time-out is set, the server sends a ping to unresponsive clients when the specified interval elapses. If NONE is specified, the client check timer is disabled.
Note: You must configure both client check and client response options if you want sessions to be disconnected automatically.
Client
response The maximum period of time before the server disconnects sessions associated with unresponsive clients (in seconds). If a client response time-out is set, the server disconnects all sessions associated with unresponsive clients when the specified interval elapses. Clients must respond to the server’s ping during the specified time period to prevent sessions from being disconnected automatically. If NONE is specified, the client response timer is disabled.
Note: You must configure both client check and client response options if you want sessions to be disconnected automatically.
To display the current time-out intervals 1. Log on to the server as an administrator. 2. At a command prompt, type:
ctxcfg -t list
The current time-out value for each setting appears. If a time-out interval is configured, the value is shown in minutes. If no time-out interval is configured, the keyword NONE shows that sessions will not be timed out.
To change the time-out intervals
1. Log on to the server as an administrator. 2. At a command prompt:
To set Use the command
A connection time-out (in minutes). All connections are terminated after this period.
ctxcfg -t connect=num
No connection time-out. All sessions continue until the user disconnects or logs off.
ctxcfg -t connect=NONE
A disconnection time-out (in minutes). Disconnected sessions are reset after this period unless you specified that they be logged off (see below).
ctxcfg -t disconnect=num
No disconnection time-out. Disconnected sessions remain until reset by a user or an administrator.
ctxcfg -t disconnect=NONE
A disconnection time-out (in minutes). Disconnected sessions are logged off after this period.
Example
If you expect users to dial in to the server, you may want to set the disconnect time-out to a suitable setting in case of a broken connection. Users can reconnect to their sessions during the time-out interval. To set the disconnection time-out to 15 minutes, type:
ctxcfg -t disconnect=15
No logoff time-out. Disconnected sessions are reset unless the disconnect time-out was also set to None.
ctxcfg -t disclogoff=NONE
An idle time-out (in minutes). If no user activity is detected during this time, the connection is terminated.
ctxcfg -t idle=num
No idle time-out. All sessions continue until the user disconnects or logs off.
ctxcfg -t idle=NONE
An authentication time-out (in minutes). If a session remains in the connected state after this period, the session is reset.
ctxcfg -t authentication=num
No authentication time-out. ctxcfg -t authentication=NONE
A client check time-out (in seconds). If the server receives no traffic from the client during this period, it sends a ping to the client to check if the client is still responding.
ctxcfg -t clientcheck=num
No client check time-out. ctxcfg -t clientcheck=NONE
A client response time-out (in seconds). If the server does not receive a response to the ping sent to the client during this period, the session is disconnected.
ctxcfg -t clientresponse=num
No client response time-out. ctxcfg -t clientresponse=NONE
Note Only new sessions are affected by changes to the time-out intervals.
ctxcfg -t has no effect on anonymous users—to specify an idle time-out period for anonymous users, see “Configuring Anonymous Users” on page 135.