Proscia POC

Get Started

What the POC builds, how it works, and how to stand up the environment.

Overview

This POC builds an HL7-in / JSON-out interface on InterSystems IRIS for Health from scratch.

Part	Covers
Set up the environment	Docker, IRIS, login, namespace, VS Code
Build the interface	Message class, transform, service, operation, router, test

Environment setup

Install Docker

Install Docker Desktop for Mac (Apple Silicon) from docker.com. Launch it and wait for Engine running.

Verify the install:

bash

docker version

The output must contain both a Client and a Server block. A Client-only response means the engine has not started yet.

Start IRIS

Create the durable volume:

bash

docker volume create proscia-durable

Hand the volume to the account IRIS runs as (uid 51773):

bash

docker run --rm -v proscia-durable:/durable alpine chown -R 51773:51773 /durable

Start the container:

bash

docker run --name proscia-iris -d -p 1972:1972 -p 52773:52773 -v proscia-durable:/durable -e ISC_DATA_DIRECTORY=/durable containers.intersystems.com/intersystems/irishealth-community:2026.2

Wait for healthy in the container list before continuing:

bash

docker ps

Create the working folders:

bash

docker exec -it proscia-iris mkdir -p /durable/hl7/in /durable/json/out

Log in

Open the Management Portal at http://localhost:52773/csp/sys/UtilHome.csp

Field	Value
Username	`SuperUser`
Password	`SYS`

IRIS forces a password reset immediately on first login. VS Code connects with the same credentials.

Create the namespace

In the portal: Health (left nav) → Installer Wizard (top banner).

Open Configure Foundation, set the Local Name to PROSCIA, Save, then Activate.

Connect VS Code

Install the InterSystems ObjectScript Extension Pack from the Extensions panel.

Click the InterSystems icon in the Activity Bar, then + in the Server Manager panel:

Prompt	Value
Name	`proscia`
Description	skip
Hostname	`localhost`
Port	`52773`
Path prefix	skip
Username	`superuser`
Security	Unsecured (http)

Then open the namespace's file system:

Open the server

In the InterSystems tab, expand All Servers → proscia. Enter the username and password when prompted.

Open the namespace

Expand Namespaces, hover over PROSCIA, and click the pen icon (Edit Code).