---
title: "system.util.setConnectionMode"
description: "Sets the connection mode for the client session."
---

# system.util.setConnectionMode

> Sets the connection mode for the client session.

This function is used in **Python Scripting**.

## Description
Sets the connection mode for the client session. Normally a client runs in mode 3, which is read-write. You may wish to change this to mode 2, which is read-only, which will only allow reading and subscribing to tags, and running SELECT queries. Tag writes and INSERT/UPDATE/DELETE queries will not function. You can also set the connection mode to mode 1, which is disconnected, all tag and query features will not work.

## Client Permission Restrictions
This scripting function has no [Client Permission](projects\project-properties\project-properties.md#client---permissions) restrictions.

## Syntax
`system.util.setConnectionMode(mode)`

### Parameters

|Type|Parameter|Description|
|--|--|--|
|int |`mode`| The new connection mode. 1 = Disconnected, 2 = Read-only, 3 = Read/Write.|
### Returns
Nothing
### Scope
All

## Code Examples
```python title="Example #1"
# This example, which could go in a project's startup script, would check the current username and set the connection mode to read-only if it is the "guest" user.
  
username = system.security.getUsername()
if "guest" == username.lower():
   # Set "guest" user to read-only mode
   system.util.setConnectionMode(2)
else:
   system.util.setConnectionMode(3)
```