CQELSVR Run List Guide

Learn how to view the CQE (Custom Query Engine) script schedules registered on a specific logical server (LSSN), and how to force-run, toggle activation, delete, and view scripts for them.

🚀 Go to CQELSVR Run List →

📋 Overview

The CQELSVR Run List shows and directly controls the CQE script schedules (tMgmtScriptList) registered on one logical server (LSSN). Once you select a server, its registered schedules are listed, and each row lets you force-run, toggle activation, delete, or view the script body immediately.

🔍 Screen Layout

1. Server Selection

• LSSN input: type a logical server ID (LSSN) directly into the field at the top.
• Select button: opens a popup listing the servers registered under the current project (csn). Picking one fills in the LSSN field automatically.
• Session memory: the last selected LSSN is saved to browser sessionStorage and survives a page reload.

2. Viewing the Run List

• Run button: after entering or selecting an LSSN, click this to load that server's schedule list below.
• Paging: use Prev / Next to move page by page, or type a number into the Offset field and press Run to jump to a specific offset. (The server returns at most 25 rows per request.)

3. Per-Row Actions

Each row (one schedule = one mslsn) supports:

• Force run: queues an immediate one-time run regardless of the schedule's interval. Fails if a run for this schedule is already queued.
• Toggle activation: flips this schedule's Active state on/off.
• Delete: permanently removes this schedule (mslsn) from the list — this is a hard delete, not a simple cancel; it must be re-registered if needed again.
• View script: clicking the run ID (mssn) on a row shows that script's body in a panel (or popup) below.

4. Navigating to Detail Pages

• Machine Detail button: goes to the selected LSSN's detail page (/lsvrdetail).
• Add Queue button: goes to /en/cqeQueuePut to register a new schedule for this server.

📊 Column Reference

Column	Description
msName	Name of the registered script
mssn	Unique script ID. Click to view the script body.
mslsn	Unique ID of this schedule (server-to-script assignment). This is the target of force-run/toggle/delete.
lssn	The logical server this schedule is registered on
active	Whether the schedule is enabled (1=on / 0=off)
repeat	Whether/how the schedule repeats
interval	Repeat interval, in minutes
q_flag	Whether the schedule is currently queued for execution
lastdate	Time the schedule was last queued/run
regdate	Time this schedule was registered

⚙️ Requirements

• Requires a logged-in session (CSN) — without one, the server list cannot be loaded.
• The LSSN you look up must be registered under the currently selected project.
• Force-run and activation toggle require you to own the schedule, or hold separate permission (e.g. a marketplace purchase).

API Reference

For detailed API specifications of this feature, refer to the dedicated guide.

📘 System Management API Reference

Troubleshooting

Symptom	Cause	Resolution
The server-select popup shows an empty list	No servers are registered under the currently selected project (csn)	Confirm the correct project is selected at the top.
Force run silently fails	A run for this schedule is already queued (duplicate prevention), or you lack permission on it	Retry later, or check with the schedule's owner.
The row still appears after deleting it	The delete succeeded but the screen hasn't refreshed yet	Press Run again to reload the latest list.
Turning activation on doesn't run it immediately	Activation only re-enables the scheduled run, it does not trigger an immediate execution	Use Force run if you need it to run right now.

🔌 CQE API (for automation)

The UI actions above map to these CQE API verbs (byAK/bySk dispatcher). Requests send text (verb + parameter names), jsondata (values), and token — except the list query (CQELsvrRunList), which is the one exception: its parameters are embedded directly in the text string (no jsondata).

• CQELsvrRunList lssn <lssn> <offset> — list the schedules registered on that LSSN. The server always returns at most 25 rows from the given offset (fixed, not caller-configurable). Response columns match the "Column Reference" table above.
• LSVRList csn — list the logical servers registered under that csn (project); used by the server-select popup.
• CQERunForce mslsn — queues an immediate one-time run regardless of schedule. Response RstVal: 200=success, 300=no permission, 302=already queued (conflict), 610=insufficient permission or gas balance.
• CQERunActvate mslsn — toggles that schedule's active value between 1 and 0. Uses the same RstVal scheme as CQERunForce (200/300/302/610).
• CQEQueueDel mslsn — permanently deletes that schedule (not a simple cancel — it must be re-registered). Response RstVal: 200=success, 403=no permission, 404=not found.
• CQERepoScript mssn — fetches that script's (mssn) body (msBody).

Auth model: this page's API does not use the giip-issue skill's x-api-key/SK model — it uses the logged-in session's token model, sending user_id + token with each request.

Full specification for the adjacent feature (script registration / bulk server deployment): the "🔌 CQE API (for automation)" section of the CQE Repository Script Management Guide, and giipdb docs/30_Specs/CQE_SPECIFICATION.md.

---

Version: 1.1 Last Updated: 2026-09-06 Source File: giipv3/public/help/cqelsvrRunList.en.md