Article Beatrice Zorzoli · Sep 10, 2025 4m read

I joined InterSystems less than a year ago. Diving into ObjectScript and IRIS was exciting, but also full of small surprises that tripped me up at the beginning. In this article I collect the most common mistakes I, and many new colleagues, make, explain why they happen, and show concrete examples and practical fixes. My goal is to help other new developers save time and avoid the same bumps in the road.

1. Getting lost among system classes and where to start

The issue: ObjectScript/IRIS ships with many system classes and packages (%Library, %SYS, %Persistent, %SQL, etc.).

12
3 420
InterSystems Developer Community is a community of 26,769 amazing developers
We're a place where InterSystems IRIS programmers learn and share, stay up-to-date, grow together and have fun!
Article Ariel Glikman · Sep 16, 2025 14m read

One of the recommendations when deploying InterSystems Technologies for production is to set up High Availability. The recommended API Manager for these InterSystems Technologies is the InterSystems API Manager (IAM). IAM (essentially Kong Gateway) has multiple deployment topologies.

If you are looking for high availability you could use:

a) Kong Traditional Mode: Multiple Node Clusters

b) 

c)

Before we break them down let's first understand the out of the box deployment that is provided by InterSystems: Installing IAM Version 3.10.

Kong Traditional Mode

3
3 306
New
Question Shane M Elliott · Apr 28

I am working on setting up OAUTH with FHIR and Microsoft Entra.  I have configured the Client and configured it in the FHIR Server successfully. However, I get 401 when authenticating with a token.   Looking at ^ISCLOG I see:
^ISCLOG("Data",9,0)="accessToken=<jwt token>, scope=, aud="
^ISCLOG("Data",10)=$lb(3,"OAuth2","[OAuth2.ServerDefinition:ValidateJWT]","171430","%SYS","2026-04-28 17:41:25.305549397","OAuth2.ServerDefinition.1","","zwKKakZZZx2")
^ISCLOG("Data",10,0)="JWT valid? sc=1"
^ISCLOG("Data",11)=$lb(3,"HSFHIRServer","[HS.FHIRServer.

4
0 31
New
Announcement Larry Finlayson · 2 hr ago
  • HealthShare Unified Care Record Overview – Virtual  May 19-20, 2026
    • Overview of HealthShare Unified Care Record® architecture, data flows, consent, and notifications
    • This 2-day course provides an overview of HealthShare Unified Care Record®. It focuses on architecture, data flows, consent, alerts, user management and terminology.
    • This non-technical course provides an introduction to the product for those who do not need the detail provided in the 5-day HealthShare Unified Care Record Fundamentals class.
0
0 6
InterSystems Official Aya Heshmat · Mar 27, 2025 4m read

The Interoperability user interface now includes modernized user experiences for the DTL Editor and Production Configuration applications that are available for opt-in in all interoperability products. You can switch between the modernized and standard views. All other Interoperability screens remain in the Standard user interface. Please note that changes are limited to these two applications and we identify below the functionality that is currently available. 

To try out the new screens prior to upgrading, you can download the 2025.

24
4 908
Article Vachan C Rannore · Sep 15, 2025 2m read

Starting out with ObjectScript, it is really exciting, but it can also feel a little unusual if you're used to other languages. Many beginners trip over the same hurdles, so here are a few "gotchas" you'll want to watch out for. (Also few friendly tips to avoid them)


NAMING THINGS RANDOMLY

We have all been guilty of naming something Test1 or MyClass just to move on quickly. But once your project grows, these names become a nightmare. 

➡ Pick clear, consistent names from the start. Think of it as leaving breadcrumbs for your future self and your teammates.


16
2 447
New
Discussion Anastasia Safronova · Apr 26

READY 2026 is in full swing and we know there are already some great moments happening 🚀

What has stood out to you so far?

It could be a session, a conversation, an idea or just a moment that made you think this is why I came”.

Share your experience in a few lines 👇

We’d love to hear what you’ve discovered and feel free to explore other replies and like the ones you relate to 💙

2
0 63
New
Question Kenji Kishimoto · 21 hr ago

Hi everyone,

I’ve been diving into the new IRIS 2026.1 features this week, specifically trying out the opt-in modernized Interoperability UI and the new DTL Explainer, but I’ve recently hit a persistent technical snag where the Management Portal becomes incredibly sluggish and my Terminal sessions start to experience significant input latency.

I am currently using a community setup to handle some automated local logging and script-based data scrubbing for my production archives in the background while I work.

0
0 25
New
InterSystems Official Bob Kuszewski · 22 hr ago

Below is an update to the IRIS release calendar for 2026 and an early look at the planned changes for 2027. The key takeaway for 2026 is that maintenance release numbering will differ slightly from prior years.

2026: IRIS 2026.1 maintenance release numbering

  • July 2026: first maintenance release for IRIS 2026.1 (planned version: 2026.1.4)
  • October 2026: next maintenance release (planned version: 2026.1.5)
  • February 2027: following maintenance release (planned version: 2026.1.6)

This numbering change prepares us for the expanded maintenance cadence planned for 2027.

1
0 60
New
InterSystems Official Bob Kuszewski · Apr 29

InterSystems has released IAM 3.10.0.9, which is a maintenance release of IAM 3.10 that includes significant fixes, including fixes for security vulnerabilities.

For those of you running older versions of IAM, we encourage you to start planning your upgrade. Customers upgrading from versions of IAM earlier than 3.10 must get a new IRIS license key to use IAM 3.10.  

IAM is an API gateway between your InterSystems IRIS servers and applications, providing tools to effectively monitor, control, and govern HTTP-based traffic at scale.

0
0 29
Contestant
Article David Hockenbroch · Apr 28 2m read

. . . you are not alone. 

Help is available.

This took me a while to figure out, and I assume there may be others struggling too. I made my way through all the Entra stuff to set up a client credentials workflow to send email through a Microsoft 365 account. I was able to successfully retrieve my token, but I couldn't ever get it to authenticate with the SMTP server using the %Net.SMTP class. There were two parts to fixing this.

First, the authenticator's access token needs to be more than JUST the access token. It has to be formatted as:

set smtp.authenticator.AccessToken = "user="_emailaddress_$C(1)_"auth=Bearer "_token_$C(1,1)
2
0 41
Announcement Ben Spead · Apr 15

READY is right around the corner, and this year the Application Services team from InterSystems will be hosting a CCR Users GroupMeeting during the conference!This will be held Wednesday, April 29th during breakfast from 7:30 – 8:30 (breakfast will be served at the meeting room starting at 7:00am).

2
0 72
New
Article Ben Spead · Apr 28 2m read

We are very excited to launch a new AI powered CCR feature which should help our users save time and prevent calls to Support.  Today we are introducing the new CCR Transport Log Analyst (or CTLA) AI-Generated summary.  The goal of CTLA is to provide an analysis of errors that have occurred in the Transport Log for a specific CCR, and advise the user as to what steps could be taken to correct the situation, as well as what might have been done to prevent it in the first place. When there is an issue with integrating or deploying a CCR, all of the details are captured in the Transport Log.

0
0 26
Article Ariel Glikman · Mar 11, 2024 3m read

In case you're planning on deploying IRIS For Health, or any of our containerized products, via the IKO on OpenShift, I wanted to share some of the hurdles we had to overcome.

As with any IKO based installation, we first need to deploy the IKO itself. However we were getting this error:

Warning FailedCreate 75s (x16 over 3m59s) replicaset-controller Error creating: pods "intersystems-iris-operator-amd-f6757dcc-" is forbidden: unable to validate against any security context constraint:

proceeded by a list of all the security context constraints (SCCs) it could not validate against.

1
0 446
New
Announcement Larry Finlayson · Apr 28
  • InterSystems EMPI (formerly HealthShare Patient Index) – Virtual  May 12-14, 2026
    • Configure, tune, and work with InterSystems EMPI, an Enterprise Master Person Index
    • This 3-day course teaches the installation, configuration, and use of InterSystems EMPI™ (formerly HealthShare® Patient Index). Starting with version 2025.1, HealthShare Patient Index has been renamed to InterSystems EMPI, but the core functionality remains the same.
    • The first half of the class focuses on person identification issues and the tools for reviewing records and record matches.
0
0 11
Contestant
Article Andrew Sklyarov · Apr 23 4m read

Hey Community, 

Yeah, I know we have a lot of tips & tricks articles - we even have a special tag for it, right? But I can not share my own collection. In this collection, you can find snippets for beginners, as well as some everyday ObjectScript constructions. In fact, it's also a way to learn something new about my favorite programming language. So, if you guys have anything to add, you are welcome!

8
8 178
Question Luis Gallardo · Mar 24

Hi!
We are deploying the iris image in a Kubernetes environment and the cluster state is "Hung" , looking the alerts endpoint we get 2 alerts:

[
  {
     "time":"2026-03-24T13:45:44.548Z",
     "severity":"2",
     "message":"System appears to have failed over from node a69a9f137593"
  },
  {
     "time":"2026-03-24T13:46:30.274Z",
     "severity":"2",
     "message":"Error: <PROTECT>KillAlive+1^%SYS.CDIRECT in SERVERS"
  }
]
Any idea / help where those are comming from and how to address them?

2
0 61
New
Article Tani Frankel · Apr 26 1m read

A very important feature for HL7 FHIR has been introduced with the release of v2026.1 - the support for SMART on FHIR v2 fine-grained granular Scopes.

This enables you to be much stricter and more accurate in the access you provide to the data in your FHIR repository.

Part of this new support is to refuse requests that don't match the scopes, but an even more interesting ability is to filter the results according to the provided scopes.

0
0 27
Article Robert Cemper · Sep 4, 2025 3m read

The article was motivated by the 2025 September Article Bounty

The principle of Docker is just convincing to me.

  • Get a sandbox where you play and try whatever you want/need to do
  • Once done. You drop it without leaving traces in your working environment

This was the technical base for me to run about 700 reviews in OEX 
with almost no side effects  (except those caused by myself).

For beginners, I'll start with straight pure IRIS, no *health, *ML, *whatever

First, you need a Docker installation. It's available on almost any platform.

4
9 411
Article Anastasia Dyubaylo · Apr 13 3m read

Every great community is enriched by those who work tirelessly behind the scenes, crafting the knowledge and resources that help others grow. In the InterSystems Developer Community, one such person is @Derek Robinson — a dedicated educator, whose passion for teaching has helped shape how developers everywhere learn to work with InterSystems technologies.

👏 Let's take a closer look at Derek's journey in the InterSystems ecosystem.

4
0 177
New
Article Robert Cemper · Apr 25 1m read

If one of your packages on OEX receives a review, you get notified by OEX only of YOUR own package.   
The rating reflects the experience of the reviewer with the status found at the time of review.   
It is kind of a snapshot and might have changed meanwhile.   
Reviews by other members of the community are marked by * in the last column.
 

# Package Review Stars IPM Docker *
1 ms-iris-credit-risk another 6* top experience 6.0 . y .
2 Free DBsize with Swagger great remote access 5.0 . . *
3 iris-configuration-manager-extension Me popupou muito tempo. 5.0 . . *
4 docbook-markdown-extension Convenient 5.
0
0 31