Duplicates grouped on a single line.
A repeated message takes a single line, with its repeat count and the period it covers. One click expands every occurrence.
Monitor your IBM i message queues directly from a browser: read, filter, answer pending messages, send and interrupt, with the rights of your IBM i profile.
Features
Features
A repeated message takes a single line, with its repeat count and the period it covers. One click expands every occurrence.
Inquiry messages rise to the top of the queue, with their severity, time and sender. One click shows the details and the default reply.
One click on “Show” expands the message help, with the cause and the recovery to perform, as IBM i provides it.
One click on the sending job opens its details: current function, detailed status, resource use.
Type the reply (the message’s default reply is shown next to it), then confirm. It runs with the rights of your IBM i profile.
Comparison
On 5250, you have to page through the queue. In NTi Inbox, the pending message comes first and repeats are grouped.
Drag the slider, or choose a view.
Send
An immediate or predefined message, of the type you choose, sent to one or more queues or to all active users. It lands in the recipient’s queue. To have it appear right away on a workstation, use the break message.
How it works
Each function relies on a system API, called with NTi.
Ten APIs, no SQL query.
QUSLOBJList queues
QMHLSTMList messages
QMHRTVMRead help
QMHSNDRMSend the reply
QMHSNDMSend
QMHSNDBMAlert a workstation
QMHRMVMDelete
QMHRMQATQueue attributes
QUSRJOBIJob status
QSYRUSRISigned-in profile
Get started
A single command, and the application is ready.
Docker downloads and starts everything for you. No program to install on the IBM i,
only the NTi license.
Before you start
Free, available from the Aumerial portal and installed on your IBM i. After that period, the application can no longer connect to it.
*DATABASE, *RMTCMD and *SIGNON must be started on the IBM i.
The machine running the application must reach the IBM i on ports 8471, 8475 and 8476 (9471, 9475 and 9476 with SSL/TLS).
Copy the command, paste it, that’s it.
Install and start Docker Desktop.
Copy this command, then paste it into a terminal (PowerShell on Windows, Terminal on macOS or Linux).
docker run -p 127.0.0.1:8080:8080 -v ntiinbox-data:/app/App_Data aumerial/ntiinbox-v creates a volume that keeps your saved connections (without password) between runs.
Open http://localhost:8080 and sign in with the IBM i address, a profile and its password.
Docker downloads the image on first launch. The command stops with Ctrl+C.
For developers who want to read, change or extend the code. The .NET 10 SDK and Git are required.
Clone the repository.
git clone https://github.com/Aumerial/NTiInbox.git
cd NTiInboxStart the application.
dotnet run --project NTiInboxOpen http://localhost:5115, or the address shown in the console, and sign in.
Warning
This demo acts on the connected partition: replying to a message can restart or stop a job, and deletion erases messages. Use it on a test partition, with a limited-rights IBM i profile, and do not expose it on the Internet: the application has no authentication of its own.
The code
NTi calls the QMHSNDRM system API directly. If it fails, the IBM i returns an error code the application can read.
var parameters = new List<NTiProgramParameter>{ new NTiProgramParameter(messageKey), new NTiProgramParameter(messageQueueName, 10).Append(libraryName, 10), new NTiProgramParameter(reply, reply.Length), new NTiProgramParameter(reply.Length), new NTiProgramParameter(removeOption, 10), // *NO or *YES ApiErrorCode.Create()}; conn.CallProgram("QSYS", "QMHSNDRM", parameters);ApiErrorCode.ThrowIfError(parameters[5], "QMHSNDRM");
Security
NTi Inbox adds no rights: every action runs
with the rights of the signed-in IBM i profile.
If the profile is not allowed to act, the action is refused. The application shows the message identifier (CPF…) and, for common cases, an explanation.
Sending, replying, deleting and interrupting all ask for confirmation. To interrupt a workstation, you must retype its name. A banner flags production and profiles with elevated rights.
Held on the server for the duration of the session, never written to disk or to a log.
Tick “Encrypted connection” when signing in. It requires a certificate configured on the IBM i.
The app
lines of C# and Razor code
IBM i system APIs
program to install on the IBM i or on client machines
French and English
Development time
4 days with a code assistant.
The kit used