FAQ

When is Git available in OL Code, and why did pull/push ask for a token?

Git is available on Unix workspaces when a repository URL is configured. Pull and push prompt for a token because the workspace does not keep a persistent credential store the way a desktop IDE does. After Git Login, the pending action retries. Save open tabs first so you do not lose editor state.

How does Reverse API handle code page and client generation?

Reverse API generates OLREVAPI COBOL/RPG clients from Hub REVERSE projects. Code page is a runtime setting, not inferred from OpenAPI.

Should I import a raw .trail recording or a TermIQ .trmiq file?

Use a .trail when you have a recorded session and want optional AI help to infer screens and fields. Use a TermIQ .trmiq when you already have identified screens and want a deterministic import. Both produce jsonSpec, OpenAPI, models, mock, and docs. Prefer .trmiq when TermIQ has already done the identification work.

How do I generate linked List/Get/Create/Update/Delete processes from a global model?

Define or reuse a global model, then generate the CRUD set. Update implies Get — you do not generate Update alone. Mark searchable fields, choose list columns, and set display modes so List/Get stay consistent with Create/Update. The generated operations stay linked to that model so later field changes propagate.

How do I compile, submit JCL, and view job output from the Code Viewer?

Open the member, compile with the matching connection template, view job files, and submit JCL from the viewer. BMS map viewer and Discard CICS Program appear when applicable. These actions need platform permissions on the connection — they are not local-only editor commands.

Which CICS image or adapter should I use, and why does CICS return 500?

Match CICS COMMAREA vs containers to the generator image. HTTP 500s are often CICS adapter or COMMAREA size, not Hub UI.

How do deployment profiles keep Hub publish out of production?

Publish always uses the Hub connection on the currently selected deployment profile. Create separate profiles (and credentials) for development, test, and production. Switch the profile before publish — there is no extra “are you sure this is prod” gate beyond which profile is selected.

How do I build and debug a 3270/5250 Screens Flow?

Build Hub terminal Screens Flows for 3270/5250: capture trails, identifiers, conditions, and debug with Test Flow or OL Terminal Play Flow.

How does RACF apply to catalog search and dataset content reads?

Protected APIs use HTTP Basic as the caller’s RACF identity. Catalog search and dataset content reads succeed or fail as that user. /ping and /help.html are unauthenticated.

What does "Current screen is not synchronized with Host" mean?

The Screens Flow expected a different 3270/5250 screen than the host showed. Check identifiers, popups, AID timing, and firstScreenId.

Why do insert, update, delete, or create-dataset return 403 even with valid RACF credentials?

RACF is necessary but not sufficient. The write surface is off by default. Enable it with ol.dataset-write.enabled or send X-OL-Dataset-Write-Authorized. Read-by-key is not write-gated. Valid RACF plus a closed write surface still returns 403 on insert, update, delete, and create-dataset.

Is it safe to write a KSDS that CICS is also updating?

Not without RLS or DFSMStvs. SHAREOPTIONS(3,3) is not enough when CICS is also updating the same KSDS. Treat concurrent writes from Z Gateway and CICS as unsafe unless the file is under record-level sharing or transactional VSAM.

Why is OL Terminal disconnecting or misbehaving?

OL Terminal idle timeout, screen size, s3270 permissions, and key mappings explain most session and keyboard issues.

How is Screener different from OL Terminal and Hub terminal Screens Flows?

Screener drives map descriptors over MQ or IMS Connect. It is not a 3270/5250 emulator (OL Terminal), not a Hub terminal Screens Flow (live session automation), and not OL Next (offline converted Groovy maps). Use Screener when the host conversation is BMS/MFS over message queues.

What do Modernization Rules & Routing decide?

Rules and routing classify how discovered operations should be modernized and where they should go next (API, rewrite, retain, and similar routes). Apply them after operations exist so routing follows business-process boundaries, not program names alone.

What does Create Baseline upload to Hub?

Create Baseline uploads selected members for Hub dependency analysis (calls, DB, file operations). Use checkbox mode to multi-select across datasets. This is analysis inventory, not Create API and not Add Test Asset.

How do I copy schemas and query results between connections for test data?

Export schema to create tables on a target connection (optional drop first). From a SELECT, Export Dataset into an existing target table with a record limit and optional clear. Connection JSON export/import shares connection sets (it includes credentials — treat it as a secret). CSV download is for fixtures, not a live

How do I bulk-expose CICS programs as REST System APIs?

Use Populate from CICS (CTG Browse). CoreIQ discovers programs through CMCI, matches COBOL source and linkage copybooks, adds them to the CICS catalog, and publishes them as REST System APIs with a dynamic OpenAPI. Publish is what makes the APIs callable — discovery alone is not enough.

Which databases can I connect, including generic JDBC?

Built-in: DB2, DB400, MySQL, PostgreSQL, Oracle, SQL Server, and IMS DB. Generic JDBC uses driver JARs under /.dataiq/jars/. Test the connection after create. An embedded PostgreSQL demo appears when no connections exist. Passwords are encrypted at rest.

When should I use IMS-DB Universal JDBC versus native IMS-DLI browse?

Use IMS-DB Universal JDBC when you can reach IMS through ODBM and want to browse, query, and page segments in the workbench, then attach COBOL layouts in the IMS-DB catalog. Use native IMS-DLI when you need hierarchical PSB/segment access via the OLIMDBR DL/I batch path on z/OS and layouts under the IMS-DLI catalog. Th

How do I browse schema, generate CREATE/ALTER TABLE, and edit DB2 or AS/400 procedures?

Use the metadata sidebar for tables, columns, keys, indexes, and the schema graph. Visual Create Table and Alter Table emit dialect DDL into the console. The Stored Procedure Editor is DB2 and AS/400 (DB400) only — view and save procedure DDL there, not for Oracle or SQL Server.

When do I use Create API versus Add Test Asset on the open COBOL?

Add Test Asset registers the program and copybooks so you can run JSON tests in the IDE. Create API registers the same program as a Hub API asset for generation and further testing. Both need Hub URL, API key, and a CICS or AS/400 connector. Use Test Asset for the edit-compile-retest loop; Create API when you want the

How do I edit cells and generate UPDATE or DELETE from Query Console results?

Run a SELECT, then edit cells inline (primary-key columns stay read-only). Generate UPDATE or DELETE statements keyed by primary keys, review them, then execute. This is not a silent write — you review the DML first.

Can I insert or update VSAM records from CoreIQ, and what blocks writes?

Yes, for VSAM KSDS from View File or the host APIs. Every write runs as the caller’s RACF identity. Writes still fail if the CoreIQ endpoint write flag is off, the dataset-server / Z Gateway write surface is closed, or RACF denies the dataset. This is separate from CDC (including IAM file support).