<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://m204wiki.rocketsoftware.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Tthoresen</id>
	<title>m204wiki - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://m204wiki.rocketsoftware.com/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Tthoresen"/>
	<link rel="alternate" type="text/html" href="https://m204wiki.rocketsoftware.com/index.php?title=Special:Contributions/Tthoresen"/>
	<updated>2026-11-22T18:41:08Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.43.1</generator>
	<entry>
		<id>https://m204wiki.rocketsoftware.com/index.php?title=Internal_Developing_Model_204_from_WSL&amp;diff=122109</id>
		<title>Internal Developing Model 204 from WSL</title>
		<link rel="alternate" type="text/html" href="https://m204wiki.rocketsoftware.com/index.php?title=Internal_Developing_Model_204_from_WSL&amp;diff=122109"/>
		<updated>2026-11-13T20:34:31Z</updated>

		<summary type="html">&lt;p&gt;Tthoresen: Document em204 alias and em204.jsonc fallback (GM204-30)&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;__NOINDEX__&lt;br /&gt;
&amp;lt;div style=&amp;quot;border:1px solid #c00; padding:6px;&amp;quot;&amp;gt;&#039;&#039;&#039;Internal use only.&#039;&#039;&#039; This page is intentionally not linked from the main page or any category. Do not link it from customer-facing pages.&amp;lt;/div&amp;gt;&lt;br /&gt;
&lt;br /&gt;
__TOC__&lt;br /&gt;
&lt;br /&gt;
= Developing Model 204 from WSL or macOS (internal) =&lt;br /&gt;
&lt;br /&gt;
The &amp;lt;code&amp;gt;@rocket/m204-tools&amp;lt;/code&amp;gt; package makes it possible to edit, assemble, link, patch, and test Model 204 from WSL or macOS. The main commands are:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Command !! Purpose&lt;br /&gt;
|-&lt;br /&gt;
| [[#Building with make204|&amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt;]] || Incrementally assemble Model 204 and link CMS and z/OS modules&lt;br /&gt;
|-&lt;br /&gt;
| [[#Running and testing under emu204|&amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt;]] || Run the real linked Model 204 module on the workstation&lt;br /&gt;
|-&lt;br /&gt;
| [[#Automated smoke test with testM204Qa|&amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt;]] || Start Model 204 under &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; and run a QA smoke test&lt;br /&gt;
|-&lt;br /&gt;
| [[#Create the maintenance branch with prezap|&amp;lt;code&amp;gt;prezap&amp;lt;/code&amp;gt;]] || Create the header for a new maintenance ZAP&lt;br /&gt;
|-&lt;br /&gt;
| [[#Find patch space with scanzap|&amp;lt;code&amp;gt;scanzap&amp;lt;/code&amp;gt;]] || Find the next available local and &amp;lt;code&amp;gt;PTCH$&amp;lt;/code&amp;gt; patch offsets&lt;br /&gt;
|-&lt;br /&gt;
| [[#Build the ZAP with make204 and bldzap|&amp;lt;code&amp;gt;bldzap&amp;lt;/code&amp;gt;]] || Compare two object decks and generate VER/REP statements&lt;br /&gt;
|-&lt;br /&gt;
| [[#Testing on CMS with putmod|&amp;lt;code&amp;gt;putmod&amp;lt;/code&amp;gt;]] || Upload a linked CMS module and map for mainframe testing&lt;br /&gt;
|-&lt;br /&gt;
| [[#Testing on z/OS with putmodzos and gitzosl|&amp;lt;code&amp;gt;putmodzos&amp;lt;/code&amp;gt;]] || Upload the z/OS object deck that the z/OS binder uses to create the test load module&lt;br /&gt;
|-&lt;br /&gt;
| [[#Running a local Online with Janus TNSERV|&amp;lt;code&amp;gt;c3270&amp;lt;/code&amp;gt; / &amp;lt;code&amp;gt;s3270&amp;lt;/code&amp;gt;]] || Connect directly to a Janus Telnet Server running under &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
This page describes the Model 204 8.0 and 8.1 workflows. Release 8.0 is under &#039;&#039;&#039;ZAP maintenance&#039;&#039;&#039;, so its baseline and ZAP objects must be kept separate. Release 8.1 is under normal development and currently builds directly into &amp;lt;code&amp;gt;obj/&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Workstation setup ==&lt;br /&gt;
&lt;br /&gt;
The published tools support:&lt;br /&gt;
&lt;br /&gt;
* WSL 2 or another x86-64 Linux environment; and&lt;br /&gt;
* macOS on Apple silicon.&lt;br /&gt;
&lt;br /&gt;
The npm package does not currently include an Intel macOS emulator binary.&lt;br /&gt;
&lt;br /&gt;
=== WSL ===&lt;br /&gt;
&lt;br /&gt;
Use WSL 2 with a current Ubuntu distribution. Keep the Git repositories in the Linux filesystem, for example under &amp;lt;code&amp;gt;~/gitm204&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;~/m204-80&amp;lt;/code&amp;gt;, rather than under &amp;lt;code&amp;gt;/mnt/c&amp;lt;/code&amp;gt;. Linux builds and Git operations are faster there and do not inherit Windows filename and permission behavior.&lt;br /&gt;
&lt;br /&gt;
Install Git and Node.js/npm, and make sure npm has access to Rocket&#039;s registry.&lt;br /&gt;
&lt;br /&gt;
=== macOS ===&lt;br /&gt;
&lt;br /&gt;
Install Git and Node.js/npm. The command-line developer tools supplied by Xcode are sufficient for Git. Homebrew or nvm can be used for Node.js; use one installation consistently so an old global npm prefix does not remain earlier on &amp;lt;code&amp;gt;PATH&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
The CMS and z/OS passwords are stored in the macOS Keychain. No Linux keyring setup is needed.&lt;br /&gt;
&lt;br /&gt;
The upload commands invoke an &amp;lt;code&amp;gt;ftp&amp;lt;/code&amp;gt; command-line client. Modern macOS does not supply one, so verify &amp;lt;code&amp;gt;command -v ftp&amp;lt;/code&amp;gt;. If it is absent, install a compatible client such as &amp;lt;code&amp;gt;tnftp&amp;lt;/code&amp;gt; with Homebrew.&lt;br /&gt;
&lt;br /&gt;
=== Install the tools ===&lt;br /&gt;
&lt;br /&gt;
On either platform, install or update the complete tool suite:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
npm install -g @rocket/m204-tools@latest&lt;br /&gt;
hash -r&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The single package supplies &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;hlasm&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;cmslink&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;zapobj&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt;, the ZAP utilities, and the Imagine JavaScript runtime.&lt;br /&gt;
&lt;br /&gt;
Verify the installation:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
make204 --help&lt;br /&gt;
emu204 --help&lt;br /&gt;
testM204Qa --help&lt;br /&gt;
type -a make204 emu204 testM204Qa prezap scanzap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
All commands should normally come from the same npm installation. If the shell finds a mixture of commands under &amp;lt;code&amp;gt;/usr/local/bin&amp;lt;/code&amp;gt;, an nvm directory, a Homebrew prefix, or another npm prefix, remove or update the obsolete installation. A split installation can make &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt; use one package version while &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; uses another.&lt;br /&gt;
&lt;br /&gt;
If &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; reports that &amp;lt;code&amp;gt;@rocket/em204-linux-x64&amp;lt;/code&amp;gt; is not installed, reinstall &amp;lt;code&amp;gt;@rocket/m204-tools&amp;lt;/code&amp;gt; without &amp;lt;code&amp;gt;--no-optional&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;--ignore-scripts&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
The package still installs &amp;lt;code&amp;gt;em204&amp;lt;/code&amp;gt; as an alias for &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt;, so existing scripts keep working.&lt;br /&gt;
&lt;br /&gt;
This installation procedure was verified on WSL on 5 November 2026 with &amp;lt;code&amp;gt;@rocket/m204-tools&amp;lt;/code&amp;gt; 1.1.167. Updating the nvm installation put &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt;, Imagine, and the ZAP utilities under the same npm prefix. Older copies under &amp;lt;code&amp;gt;/usr/local/bin&amp;lt;/code&amp;gt; remained present but no longer took precedence.&lt;br /&gt;
&lt;br /&gt;
== Repositories ==&lt;br /&gt;
&lt;br /&gt;
The two repositories have different purposes:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;~/gitm204&amp;lt;/code&amp;gt; contains the build tools, assembler, linker, emulator, and their tests.&lt;br /&gt;
* &amp;lt;code&amp;gt;~/m204-80&amp;lt;/code&amp;gt; contains the ZAP-maintained Model 204 8.0 source.&lt;br /&gt;
* &amp;lt;code&amp;gt;~/m204-81&amp;lt;/code&amp;gt; contains the Model 204 8.1 development source.&lt;br /&gt;
&lt;br /&gt;
The Model 204 directory name matters. It must end in the two-digit release, such as &amp;lt;code&amp;gt;m204-80&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;m204-81&amp;lt;/code&amp;gt;, because the tools derive the release and CMS disk names from it.&lt;br /&gt;
&lt;br /&gt;
Before beginning a change:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
cd ~/m204-81&lt;br /&gt;
git status --short --branch&lt;br /&gt;
git switch master&lt;br /&gt;
git pull&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Do not discard uncommitted work. Resolve or preserve it before changing branches.&lt;br /&gt;
&lt;br /&gt;
== First build and CMS libraries ==&lt;br /&gt;
&lt;br /&gt;
From the Model 204 repository root:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
cd ~/m204-81&lt;br /&gt;
make204 --force&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For 8.0, use &amp;lt;code&amp;gt;make204 --no-zap&amp;lt;/code&amp;gt; to create the baseline instead. On the first build, &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt; downloads the macro and object libraries it needs from CMS. You need a CMS userid with FTP access. The userid defaults from &amp;lt;code&amp;gt;$USER&amp;lt;/code&amp;gt;, truncated to eight characters. If the workstation login name is not the CMS userid, set &amp;lt;code&amp;gt;M204_FTPVM_USERID&amp;lt;/code&amp;gt; in the shell.&lt;br /&gt;
&lt;br /&gt;
On WSL, the tools can offer to install and configure &amp;lt;code&amp;gt;gnome-keyring&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;libsecret-tools&amp;lt;/code&amp;gt; so the CMS password can be saved. If the keyring is not configured, the tools can still run but may ask for the password again. On macOS, they use the system Keychain.&lt;br /&gt;
&lt;br /&gt;
Library fetches are recorded in &amp;lt;code&amp;gt;.m204libs&amp;lt;/code&amp;gt;. If a fetch was interrupted, &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt; recognizes the half-fetched library and downloads it again. An older tree that already has populated libraries but no note is accepted as-is. A large number of unknown assembler operations usually means that the macro library is incomplete.&lt;br /&gt;
&lt;br /&gt;
== Building with make204 ==&lt;br /&gt;
&lt;br /&gt;
Model 204 assembler source, copy members, macros, and ZAP files are under &amp;lt;code&amp;gt;src/&amp;lt;/code&amp;gt;. Build outputs are ignored by Git:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Directory !! Contents&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;obj/&amp;lt;/code&amp;gt; || Baseline object decks and linked modules&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;lst/&amp;lt;/code&amp;gt; || Baseline assembly listings&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ref/&amp;lt;/code&amp;gt; || Baseline dependency information&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;zapobj/&amp;lt;/code&amp;gt; || ZAP-build objects, per-module ZAPs, and linked modules&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;zaplst/&amp;lt;/code&amp;gt; || ZAP-build listings&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;zapref/&amp;lt;/code&amp;gt; || ZAP-build dependency information&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
A typical edit/build loop is:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
cd ~/m204-81&lt;br /&gt;
&lt;br /&gt;
# Edit src/MODULE.ASSEMBLE, a COPY member, or a MACRO.&lt;br /&gt;
&lt;br /&gt;
make204 MODULE       # assemble the named source and link if needed&lt;br /&gt;
make204              # assemble everything that changed and link if needed&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Useful options:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Option !! Meaning&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;--force&amp;lt;/code&amp;gt; || Reassemble everything, ignoring dependency timestamps&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;--link&amp;lt;/code&amp;gt; || Force a link even when no object appears to have changed&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;--no-link&amp;lt;/code&amp;gt; || Assemble without linking&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;--stdout&amp;lt;/code&amp;gt; || Show assembler output&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;--errLines=N&amp;lt;/code&amp;gt; || Show the first N diagnostic lines for each failed module&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;--errMax=0&amp;lt;/code&amp;gt; || Continue after assembly failures instead of stopping at the first one&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;--clear&amp;lt;/code&amp;gt; || Empty the selected build directories before building&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;make204 MODULE&amp;lt;/code&amp;gt; names an input source, not necessarily an output object. For example, one input may produce more than one output module.&lt;br /&gt;
&lt;br /&gt;
Review the corresponding listing after an assembly:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
less lst/MODULE.LST80&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The default is controlled by &amp;lt;code&amp;gt;m204.jsonc&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
* 8.0 has &amp;lt;code&amp;gt;&amp;quot;zap&amp;quot;: true&amp;lt;/code&amp;gt;. A bare &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt; builds under &amp;lt;code&amp;gt;zapobj/&amp;lt;/code&amp;gt;; use &amp;lt;code&amp;gt;--no-zap&amp;lt;/code&amp;gt; for the baseline.&lt;br /&gt;
* 8.1 has &amp;lt;code&amp;gt;&amp;quot;zap&amp;quot;: false&amp;lt;/code&amp;gt;. A bare &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt; builds normally under &amp;lt;code&amp;gt;obj/&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
On the WSL test machine, &amp;lt;code&amp;gt;make204 --force&amp;lt;/code&amp;gt; for 8.1 assembled the complete tree with no assembler warnings or errors and linked both &amp;lt;code&amp;gt;M204ONLN.MODULE&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;M204ONLN.ZOSMOD&amp;lt;/code&amp;gt;. A second bare &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt; correctly reported every module up to date and skipped the link.&lt;br /&gt;
&lt;br /&gt;
The current 8.1 link prints warnings that no object was found for EVCP and that RSQL was not found in the search path. The link still succeeds. Treat additional missing objects or unresolved externals as errors rather than assuming every linker warning is expected.&lt;br /&gt;
&lt;br /&gt;
== Running and testing under emu204 ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; runs the real z/OS Model 204 module locally. It is not a source-level reimplementation of Model 204.&lt;br /&gt;
&lt;br /&gt;
=== Automated smoke test with testM204Qa ===&lt;br /&gt;
&lt;br /&gt;
The simplest supported baseline smoke test is:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
cd ~/m204-81&lt;br /&gt;
make204&lt;br /&gt;
testM204Qa --tree=&amp;quot;$HOME/m204-81&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt; starts &amp;lt;code&amp;gt;obj/M204ONLN.MODULE&amp;lt;/code&amp;gt; under &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; and runs the &amp;lt;code&amp;gt;UL*&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;REGEX*&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;CMD*&amp;lt;/code&amp;gt; QA patterns. It takes roughly half a minute. Results are written under &amp;lt;code&amp;gt;m204qa/out/&amp;lt;/code&amp;gt; beside the Model 204 tree.&lt;br /&gt;
&lt;br /&gt;
For 8.0, substitute &amp;lt;code&amp;gt;m204-80&amp;lt;/code&amp;gt; and build the unmodified baseline with &amp;lt;code&amp;gt;make204 --no-zap&amp;lt;/code&amp;gt;. Do not run &amp;lt;code&amp;gt;--no-zap&amp;lt;/code&amp;gt; on an 8.0 ZAP branch: it would replace the baseline objects with changed source and destroy the comparison that generates the ZAP.&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;Do not judge this run by the emulator return code.&#039;&#039;&#039; Tests deliberately provoke Model 204 errors, so a successful run can have a nonzero Model 204 return code. &amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt; reads QARUN&#039;s output and checks that every pattern finished, ran tests, reported no failures, and produced no SNAP.&lt;br /&gt;
&lt;br /&gt;
The 8.1 run on 5 November 2026 completed successfully with 647 tests reported passed. Model 204 ended with return code 32, which &amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt; correctly identified as expected.&lt;br /&gt;
&lt;br /&gt;
Two messages from that run were informational:&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;MSIR.1097&amp;lt;/code&amp;gt; reported that DFLTCC hardware compression was unavailable under the emulator.&lt;br /&gt;
* Two &amp;lt;code&amp;gt;m204proc&amp;lt;/code&amp;gt; filenames differed only in case and both folded to procedure &amp;lt;code&amp;gt;CA_DIGICERTGLOBALROOTCA&amp;lt;/code&amp;gt;; &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; reported the collision and ignored the second.&lt;br /&gt;
&lt;br /&gt;
When run from an installed tool package, &amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt; creates &amp;lt;code&amp;gt;m204qa/out/&amp;lt;/code&amp;gt; beside the Model 204 tree. In the current 8.1 tree the containing &amp;lt;code&amp;gt;m204qa/&amp;lt;/code&amp;gt; directory is not ignored, so &amp;lt;code&amp;gt;git status&amp;lt;/code&amp;gt; shows it as untracked after the test. Remove it after preserving any print, audit, or SNAP files needed for diagnosis.&lt;br /&gt;
&lt;br /&gt;
=== Building an emu204 case ===&lt;br /&gt;
&lt;br /&gt;
For an interactive or specialized run, create a directory containing an &amp;lt;code&amp;gt;emu204.jsonc&amp;lt;/code&amp;gt; configuration, CCAIN, and any files used by the run:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
mkdir -p ~/em204-cases/mycase/{files,out}&lt;br /&gt;
cd ~/em204-cases/mycase&lt;br /&gt;
vi emu204.jsonc&lt;br /&gt;
vi ccain.txt&lt;br /&gt;
emu204&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
With no &amp;lt;code&amp;gt;--config&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; reads &amp;lt;code&amp;gt;emu204.jsonc&amp;lt;/code&amp;gt; in the current directory. Relative paths in the configuration are resolved against the directory containing the configuration, not against the shell&#039;s current directory. This makes the case directory movable.&lt;br /&gt;
&lt;br /&gt;
If &amp;lt;code&amp;gt;emu204.jsonc&amp;lt;/code&amp;gt; is not present but &amp;lt;code&amp;gt;em204.jsonc&amp;lt;/code&amp;gt; is, &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; reads &amp;lt;code&amp;gt;em204.jsonc&amp;lt;/code&amp;gt;, so case directories written against the old name still load.&lt;br /&gt;
&lt;br /&gt;
The complete reference is:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
emu204 --help&lt;br /&gt;
emu204 --help=config&lt;br /&gt;
emu204 --help=em&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
A useful starting configuration is:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;module&amp;quot;: &amp;quot;/home/user/m204-81/obj/M204ONLN.MODULE&amp;quot;,&lt;br /&gt;
  &amp;quot;lst&amp;quot;: &amp;quot;/home/user/m204-81/lst&amp;quot;,&lt;br /&gt;
  &amp;quot;cpuid&amp;quot;: &amp;quot;FF379B789175&amp;quot;,&lt;br /&gt;
  &amp;quot;jobName&amp;quot;: &amp;quot;EMU204ON&amp;quot;,&lt;br /&gt;
  &amp;quot;parm&amp;quot;: &amp;quot;SYSOPT=X&#039;A0&#039;,LIBUFF=3072,LOBUFF=7168,SIRFUNC=X&#039;01&#039;,SIRTUNE=0&amp;quot;,&lt;br /&gt;
  &amp;quot;storage&amp;quot;: &amp;quot;2G&amp;quot;,&lt;br /&gt;
&lt;br /&gt;
  &amp;quot;dd&amp;quot;: {&lt;br /&gt;
    &amp;quot;SITEPARM&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;siteparm.txt&amp;quot;},&lt;br /&gt;
    &amp;quot;CCAIN&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;ccain.txt&amp;quot;},&lt;br /&gt;
    &amp;quot;CCAPRINT&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;out/ccaprint.txt&amp;quot;},&lt;br /&gt;
    &amp;quot;CCAAUDIT&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;out/ccaaudit.txt&amp;quot;},&lt;br /&gt;
    &amp;quot;CCASNAP&amp;quot;: {&lt;br /&gt;
      &amp;quot;path&amp;quot;: &amp;quot;out/ccasnap.txt&amp;quot;,&lt;br /&gt;
      &amp;quot;sequence&amp;quot;: true,&lt;br /&gt;
      &amp;quot;cc&amp;quot;: true&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;CCASTAT&amp;quot;: {&lt;br /&gt;
      &amp;quot;path&amp;quot;: &amp;quot;files/M204.CCASTAT.binary&amp;quot;,&lt;br /&gt;
      &amp;quot;blocked&amp;quot;: true&lt;br /&gt;
    }&lt;br /&gt;
  },&lt;br /&gt;
&lt;br /&gt;
  &amp;quot;ddDirs&amp;quot;: [&lt;br /&gt;
    {&amp;quot;path&amp;quot;: &amp;quot;files&amp;quot;, &amp;quot;suffix&amp;quot;: &amp;quot;M204FILE&amp;quot;, &amp;quot;m204file&amp;quot;: true}&lt;br /&gt;
  ]&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Change the module path to &amp;lt;code&amp;gt;zapobj/M204ONLN.MODULE&amp;lt;/code&amp;gt; when the purpose of the case is to test a ZAP-linked module.&lt;br /&gt;
&lt;br /&gt;
=== Identity and authorization ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;cpuid&amp;lt;/code&amp;gt; is the twelve hexadecimal digits reported by the emulated machine. Model 204 checks it against the authorization in the module, so it must be a CPU ID authorized by the development key.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;jobName&amp;lt;/code&amp;gt; becomes the name in the TIOT header. A bare &amp;lt;code&amp;gt;LOGIN&amp;lt;/code&amp;gt; is trusted as this user, so the name must exist in CCASTAT. If the configured CCASTAT path does not exist, &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; creates a minimal table containing the configured job name. This is normally simpler than copying a password table from a mainframe.&lt;br /&gt;
&lt;br /&gt;
If a real CCASTAT is used, download it with FTP block-mode framing intact and specify &amp;lt;code&amp;gt;&amp;quot;blocked&amp;quot;: true&amp;lt;/code&amp;gt;. A plain binary byte stream cannot preserve the record boundaries of its undefined-format records.&lt;br /&gt;
&lt;br /&gt;
=== EXEC PARM, SYSOPT, and CCAIN ===&lt;br /&gt;
&lt;br /&gt;
The configuration&#039;s &amp;lt;code&amp;gt;parm&amp;lt;/code&amp;gt; value is the EXEC PARM presented when Model 204 is entered. It is where user-zero parameters such as SYSOPT, LIBUFF, and LOBUFF are normally supplied:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;parm&amp;quot;: &amp;quot;SYSOPT=X&#039;A0&#039;,LIBUFF=3072,LOBUFF=7168,SIRFUNC=X&#039;01&#039;,SIRTUNE=0&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For the development cases:&lt;br /&gt;
&lt;br /&gt;
* SYSOPT &amp;lt;code&amp;gt;X&#039;80&#039;&amp;lt;/code&amp;gt; enables the audit trail.&lt;br /&gt;
* SYSOPT &amp;lt;code&amp;gt;X&#039;20&#039;&amp;lt;/code&amp;gt; includes RK lines in the audit trail.&lt;br /&gt;
* &amp;lt;code&amp;gt;X&#039;A0&#039;&amp;lt;/code&amp;gt; enables both.&lt;br /&gt;
* Do not add &amp;lt;code&amp;gt;X&#039;02&#039;&amp;lt;/code&amp;gt; unless CCAGRP is allocated.&lt;br /&gt;
* Do not add &amp;lt;code&amp;gt;X&#039;01&#039;&amp;lt;/code&amp;gt; unless CCASYS is already available during initialization.&lt;br /&gt;
* A security configuration requiring login must agree with the supplied CCASTAT and CCAIN login commands.&lt;br /&gt;
&lt;br /&gt;
CCAIN is ordinary workstation text. &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; translates it to EBCDIC and pads it to 80-byte card images. Model 204 reads only through column 72; a continued parameter line ends with a dash &#039;&#039;&#039;in column 72&#039;&#039;&#039;, after padding with blanks. A dash that follows the last comma directly, or that sits earlier in the line, is not recognized as a continuation: Model 204 fails with &amp;lt;code&amp;gt;M204.1122: Invalid parameter = -&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
A small CCAIN might be (each line ending in a dash is padded so that the dash is in column 72):&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
HDRCTL=3,LVTBL=60000,LNTBL=18000,LSTBL=480000,                         -&lt;br /&gt;
LFTBL=400000,LGTBL=400000,                                             -&lt;br /&gt;
NFILES=200,NDCBS=200,NDIR=200,PAGESZ=6184,SPCORE=120000,               -&lt;br /&gt;
TEMPPAGE=20000,OUTMRL=80,NSERVS=8,SERVSIZE=5000000&lt;br /&gt;
LOGIN&lt;br /&gt;
OPEN M204PROC&lt;br /&gt;
OPEN QAPROC&lt;br /&gt;
I QARUN MYTEST*&lt;br /&gt;
EOJ&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Use &amp;lt;code&amp;gt;TEMPPAGE&amp;lt;/code&amp;gt; when an in-memory CCATEMP is sufficient. If the test specifically needs a disk-backed CCATEMP, allocate it as an &amp;lt;code&amp;gt;m204file&amp;lt;/code&amp;gt; with &amp;lt;code&amp;gt;new&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;pages&amp;lt;/code&amp;gt; instead.&lt;br /&gt;
&lt;br /&gt;
=== Allocating existing Model 204 files ===&lt;br /&gt;
&lt;br /&gt;
An &amp;lt;code&amp;gt;m204file&amp;lt;/code&amp;gt; is a flat, untranslated sequence of 6184-byte Model 204 pages. For one file:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;PAYROLL&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/PAYROLL.M204FILE&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The DDNAME is the JSON key (&amp;lt;code&amp;gt;PAYROLL&amp;lt;/code&amp;gt;). For an existing file, omit &amp;lt;code&amp;gt;pages&amp;lt;/code&amp;gt;; the allocated size is inferred from the number of pages in the host file.&lt;br /&gt;
&lt;br /&gt;
To allocate every appropriately named file in a directory:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;ddDirs&amp;quot;: [&lt;br /&gt;
  {&lt;br /&gt;
    &amp;quot;path&amp;quot;: &amp;quot;files&amp;quot;,&lt;br /&gt;
    &amp;quot;suffix&amp;quot;: &amp;quot;M204FILE&amp;quot;,&lt;br /&gt;
    &amp;quot;m204file&amp;quot;: true&lt;br /&gt;
  }&lt;br /&gt;
]&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
With this form, &amp;lt;code&amp;gt;files/PAYROLL.M204FILE&amp;lt;/code&amp;gt; becomes DDNAME &amp;lt;code&amp;gt;PAYROLL&amp;lt;/code&amp;gt;. The portion before the suffix must be a valid one-to-eight-character DDNAME. Files with the wrong suffix case or invalid DDNAMEs are reported rather than silently used.&lt;br /&gt;
&lt;br /&gt;
The maximum number of pages available to an existing file is its host-file size divided by 6184. Verify a transferred page image before running:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
bytes=$(wc -c &amp;amp;lt; files/PAYROLL.M204FILE)&lt;br /&gt;
test $((bytes % 6184)) -eq 0 &amp;amp;amp;&amp;amp;amp; echo &amp;quot;$((bytes / 6184)) pages&amp;quot; ||&lt;br /&gt;
  echo &amp;quot;not a whole number of Model 204 pages&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Creating a new or scratch Model 204 file ===&lt;br /&gt;
&lt;br /&gt;
For a persistent file that does not exist yet, provide its extent with &amp;lt;code&amp;gt;pages&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;NEWDATA&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/NEWDATA.M204FILE&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true,&lt;br /&gt;
  &amp;quot;pages&amp;quot;: 1000&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The host file is created when Model 204 opens it. CCAIN must still issue the normal Model 204 CREATE, OPEN, and INITIALIZE commands. Do not specify &amp;lt;code&amp;gt;new&amp;lt;/code&amp;gt; for a persistent database file: &amp;lt;code&amp;gt;new&amp;lt;/code&amp;gt; empties the host file at the first open of every emulator run.&lt;br /&gt;
&lt;br /&gt;
For deliberately disposable storage:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;CCATEMP&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;out/ccatemp.pages&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true,&lt;br /&gt;
  &amp;quot;new&amp;quot;: true,&lt;br /&gt;
  &amp;quot;pages&amp;quot;: 5000&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
This is suitable for CCATEMP or a test file that must start empty on every run.&lt;br /&gt;
&lt;br /&gt;
=== Getting files from CMS or z/OS ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; does not log on to CMS or z/OS and fetch database files itself. Put the required files in the case directory before starting it.&lt;br /&gt;
&lt;br /&gt;
For a physical z/OS Model 204 data set, download it in binary mode with no character translation. The resulting workstation file must be only the concatenated 6184-byte pages:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
ftp zos-host&lt;br /&gt;
binary&lt;br /&gt;
get &#039;HLQ.PAYROLL&#039; files/PAYROLL.M204FILE&lt;br /&gt;
quit&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
FTP command syntax and quoting vary by client. After the transfer, verify that the byte count is a multiple of 6184. Do not mark a page image &amp;lt;code&amp;gt;blocked&amp;lt;/code&amp;gt;; &amp;lt;code&amp;gt;blocked&amp;lt;/code&amp;gt; is for record-oriented files transferred with FTP block-mode framing, not Model 204 database pages.&lt;br /&gt;
&lt;br /&gt;
For example, the following was tested with &amp;lt;code&amp;gt;TOM.PROCFILE&amp;lt;/code&amp;gt; on &amp;lt;code&amp;gt;rss1&amp;lt;/code&amp;gt;. Transfer the data set in binary and save it under the local Online case:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
mkdir -p ~/em204-cases/m204-81-tnserv/files&lt;br /&gt;
ftp rss1.rocketsoftware.com&lt;br /&gt;
binary&lt;br /&gt;
get &#039;TOM.PROCFILE&#039; /home/user/em204-cases/m204-81-tnserv/files/TOM.PROCFILE.m204file&lt;br /&gt;
quit&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The downloaded file was 111,312,000 bytes, exactly 18,000 6184-byte pages. Allocate it to the Online as DD &amp;lt;code&amp;gt;TOMPROC&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;TOMPROC&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/TOM.PROCFILE.m204file&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The z/OS data set name is &amp;lt;code&amp;gt;TOM.PROCFILE&amp;lt;/code&amp;gt;, but the Model 204 file and DD name are &amp;lt;code&amp;gt;TOMPROC&amp;lt;/code&amp;gt;. No &amp;lt;code&amp;gt;DEFINE DATASET PROCFILE&amp;lt;/code&amp;gt; command is needed. After restarting the Online:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
OPEN TOMPROC&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The tested open reported &amp;lt;code&amp;gt;M204.0620: File TOMPROC opened&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
The same binary-transfer and DD-allocation process was tested for the release 8.1 procedure files and CCASYS:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! z/OS data set !! Local DD/file name !! Pages&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ULSPFTOM.V81.QAPROC&amp;lt;/code&amp;gt; || &amp;lt;code&amp;gt;QAPROC&amp;lt;/code&amp;gt; || 18,000&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ULSPFTOM.V81.M204PROC&amp;lt;/code&amp;gt; || &amp;lt;code&amp;gt;M204PROC&amp;lt;/code&amp;gt; || 4,800&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ULSPFTOM.CCASYS&amp;lt;/code&amp;gt; || &amp;lt;code&amp;gt;CCASYS&amp;lt;/code&amp;gt; || 2,400&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ULSPFTOM.CCAGRP&amp;lt;/code&amp;gt; || &amp;lt;code&amp;gt;CCAGRP&amp;lt;/code&amp;gt; || 120&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ULSPFTOM.SIRLOCAL&amp;lt;/code&amp;gt; || &amp;lt;code&amp;gt;SIRLOCAL&amp;lt;/code&amp;gt; || 1,080&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Add the downloaded page images to &amp;lt;code&amp;gt;emu204.jsonc&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;QAPROC&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.V81.QAPROC.m204file&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true&lt;br /&gt;
},&lt;br /&gt;
&amp;quot;M204PROC&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.V81.M204PROC.m204file&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true&lt;br /&gt;
},&lt;br /&gt;
&amp;quot;CCASYS&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.CCASYS.m204file&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true&lt;br /&gt;
},&lt;br /&gt;
&amp;quot;CCAGRP&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.CCAGRP.m204file&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true&lt;br /&gt;
},&lt;br /&gt;
&amp;quot;SIRLOCAL&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.SIRLOCAL.m204file&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
A file copied while another Online has it open can retain that Online&#039;s shared-DASD enqueue entry. Display the entries in the &#039;&#039;&#039;local copy&#039;&#039;&#039; before forcing anything:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
ENQCTL M204PROC&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The tested M204PROC copy contained one exclusive &amp;lt;code&amp;gt;CMS ULSPFTOM&amp;lt;/code&amp;gt; entry. After confirming that this was only the copied source entry, it was removed locally with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
ENQCTL M204PROC CMS ULSPFTOM&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Do not use a broad &amp;lt;code&amp;gt;ENQCTL&amp;lt;/code&amp;gt; against a shared production file. This command was safe here because it modified an isolated workstation copy.&lt;br /&gt;
&lt;br /&gt;
To make Model 204 open CCASYS and CCAGRP during initialization, include both DDs and set the two low-order SYSOPT bits:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;parm&amp;quot;: &amp;quot;SYSOPT=X&#039;A3&#039;,...&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The tested Online initialized successfully with &amp;lt;code&amp;gt;SYSOPT X&#039;A3&#039;&amp;lt;/code&amp;gt;. After startup, &amp;lt;code&amp;gt;OPEN QAPROC&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;OPEN M204PROC&amp;lt;/code&amp;gt; succeeded; CCASYS was available for subsystem processing and CCAGRP supplied the &amp;lt;code&amp;gt;SIRSYS&amp;lt;/code&amp;gt; group.&lt;br /&gt;
&lt;br /&gt;
SIRPRO also requires &amp;lt;code&amp;gt;SIRLOCAL&amp;lt;/code&amp;gt;. Without that DD, subsystem scanning succeeds but startup ends with &amp;lt;code&amp;gt;M204.1521: SIRLOCAL does not exist&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;M204.0473: Unable to initialize SIRPRO&amp;lt;/code&amp;gt;. With &amp;lt;code&amp;gt;LFSCB=20000&amp;lt;/code&amp;gt; and SIRLOCAL allocated, the tested startup completed with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
M204.0430: Subsystem SIRPRO started&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
CMS Model 204 files may be on direct-access minidisks rather than represented as ordinary CMS files. Such a file cannot simply be fetched by CMS filename. Use the site&#039;s normal utility to make either:&lt;br /&gt;
&lt;br /&gt;
* a physical sequential page image that can be downloaded without translation; or&lt;br /&gt;
* a Model 204 DUMP data set, which can be restored into a newly allocated local &amp;lt;code&amp;gt;m204file&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
The same dump-and-restore method works when direct access to a z/OS data set is unavailable.&lt;br /&gt;
&lt;br /&gt;
If the dump data set was downloaded with FTP &amp;lt;code&amp;gt;MODE B&amp;lt;/code&amp;gt;, preserve its record framing:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;PAYDUMP&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/PAYROLL.DUMP&amp;quot;,&lt;br /&gt;
  &amp;quot;blocked&amp;quot;: true&lt;br /&gt;
},&lt;br /&gt;
&amp;quot;PAYROLL&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/PAYROLL.M204FILE&amp;quot;,&lt;br /&gt;
  &amp;quot;m204file&amp;quot;: true,&lt;br /&gt;
  &amp;quot;pages&amp;quot;: 10000&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The target extent must be large enough for the restored file. The CCAIN stream can then create and initialize the target and restore the dump DD:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
CREATE FILE (NOFORMAT) PAYROLL&lt;br /&gt;
END&lt;br /&gt;
OPEN FILE PAYROLL&lt;br /&gt;
IN FILE PAYROLL INITIALIZE&lt;br /&gt;
OPEN PAYROLL&lt;br /&gt;
IN FILE PAYROLL RESTORE 192 FROM PAYDUMP&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Use the site&#039;s established DUMP options and restore page size; &amp;lt;code&amp;gt;192&amp;lt;/code&amp;gt; above is the value used by current Model 204 QA restore procedures, not a universal replacement for the source environment&#039;s dump procedure.&lt;br /&gt;
&lt;br /&gt;
=== Using procedure directories ===&lt;br /&gt;
&lt;br /&gt;
Source-controlled procedure directories can be presented as read-only Model 204 procedure files without exporting a binary procedure file:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;M204PROC&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;/home/user/m204-81/m204proc&amp;quot;,&lt;br /&gt;
  &amp;quot;procDir&amp;quot;: true&lt;br /&gt;
},&lt;br /&gt;
&amp;quot;QAPROC&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;/home/user/m204-81/qaproc&amp;quot;,&lt;br /&gt;
  &amp;quot;procDir&amp;quot;: true&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Each host file becomes one procedure, with its filename folded to upper case. Subdirectories are searched and flattened. Duplicate procedure names are reported. The procedure image is rebuilt when Model 204 opens the file, so host edits are seen after every user has closed the procedure file and it is opened again.&lt;br /&gt;
&lt;br /&gt;
=== Output files and interactive control ===&lt;br /&gt;
&lt;br /&gt;
Text DDs such as CCAPRINT and CCAAUDIT are written as readable workstation text. Use &amp;lt;code&amp;gt;&amp;quot;sequence&amp;quot;: true&amp;lt;/code&amp;gt; for CCASNAP so that each open produces &amp;lt;code&amp;gt;ccasnap1.txt&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;ccasnap2.txt&amp;lt;/code&amp;gt;, and so on instead of replacing the preceding dump.&lt;br /&gt;
&lt;br /&gt;
While Model 204 runs, a console line beginning with &amp;lt;code&amp;gt;#&amp;lt;/code&amp;gt; is an emulator command. A bare &amp;lt;code&amp;gt;#&amp;lt;/code&amp;gt; stops the guest at the &amp;lt;code&amp;gt;EM&amp;amp;gt;&amp;lt;/code&amp;gt; prompt; &amp;lt;code&amp;gt;BEGIN&amp;lt;/code&amp;gt; resumes it. Use &amp;lt;code&amp;gt;#HELP&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;emu204 --help=em&amp;lt;/code&amp;gt; for display, traceback, trap, trace, and profiling commands.&lt;br /&gt;
&lt;br /&gt;
== ZAP-maintenance workflow ==&lt;br /&gt;
&lt;br /&gt;
=== Refresh the unmodified baseline ===&lt;br /&gt;
&lt;br /&gt;
Every generated ZAP is a comparison against the baseline objects in &amp;lt;code&amp;gt;obj/&amp;lt;/code&amp;gt;. Build those objects from current, unmodified master:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
cd ~/m204-80&lt;br /&gt;
git switch master&lt;br /&gt;
git pull&lt;br /&gt;
make204 --no-zap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
This step is mandatory. A stale baseline can produce ZAPs for modules that were not changed. Rebuild it after master moves or after a change to the assembler, pinned build date, version settings, or other build configuration.&lt;br /&gt;
&lt;br /&gt;
=== Create the maintenance branch with prezap ===&lt;br /&gt;
&lt;br /&gt;
The branch name must match &amp;lt;code&amp;gt;&amp;amp;lt;release&amp;amp;gt;Z&amp;amp;lt;PDS-number&amp;amp;gt;&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
git switch -c 80Z9206&lt;br /&gt;
prezap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;prezap&amp;lt;/code&amp;gt; creates &amp;lt;code&amp;gt;src/80Z9206.ZAP&amp;lt;/code&amp;gt;. Edit its header to describe the symptom, fix, prerequisites, and any genuinely necessary special instructions. Leave the &amp;lt;code&amp;gt;80Zxxx&amp;lt;/code&amp;gt; placeholder in the header; the distribution build assigns the sequence.&lt;br /&gt;
&lt;br /&gt;
=== Check whether the target can be generated automatically ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;SIRE2&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;EWDP&amp;lt;/code&amp;gt; are excluded from automatic object comparison in the current 8.0 configuration. A source change in either module can assemble and link successfully while being absent from the branch ZAP. Such a fix must be cut by hand on CMS or shipped in a relinked module.&lt;br /&gt;
&lt;br /&gt;
Check the target module before doing the implementation.&lt;br /&gt;
&lt;br /&gt;
=== Find patch space with scanzap ===&lt;br /&gt;
&lt;br /&gt;
For a change that uses a module&#039;s local patch area or &amp;lt;code&amp;gt;PTCH$&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
scanzap SCOMP&lt;br /&gt;
scanzap SCOMP OTHERMOD&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The output reports the next &amp;lt;code&amp;gt;PTCH&amp;lt;/code&amp;gt; offset and the next local offset for each named module. Then edit the source under &amp;lt;code&amp;gt;src/&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Build the ZAP with make204 and bldzap ===&lt;br /&gt;
&lt;br /&gt;
Use a clean ZAP directory for the first build:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
make204 --clear&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Subsequent builds can be incremental:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
make204&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
In ZAP mode, &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
# assembles into &amp;lt;code&amp;gt;zapobj/&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;zaplst/&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;zapref/&amp;lt;/code&amp;gt;;&lt;br /&gt;
# compares each changed object with the baseline object in &amp;lt;code&amp;gt;obj/&amp;lt;/code&amp;gt;;&lt;br /&gt;
# invokes &amp;lt;code&amp;gt;bldzap&amp;lt;/code&amp;gt; to create per-module NAME/VER/REP statements;&lt;br /&gt;
# links &amp;lt;code&amp;gt;zapobj/M204ONLN.MODULE&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;zapobj/M204ONLN.ZOSMOD&amp;lt;/code&amp;gt;; and&lt;br /&gt;
# appends the generated statements to &amp;lt;code&amp;gt;src/&amp;amp;lt;branch&amp;amp;gt;.ZAP&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
A successful run reports a header and one or more generated ZAPs. &#039;&#039;Header only (no ZAPs)&#039;&#039; means that no object difference was found. The usual causes are an unchanged source, a baseline that already contains the fix, or a target excluded by &amp;lt;code&amp;gt;m204.jsonc&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Review all three forms of the result:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
less src/80Z9206.ZAP&lt;br /&gt;
less zaplst/MODULE.LST80&lt;br /&gt;
git diff -- src/80Z9206.ZAP src/MODULE.ASSEMBLE&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Prove the test and test the patched module ===&lt;br /&gt;
&lt;br /&gt;
First prove that the test exposes the bug in the unpatched baseline:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
putmod --no-zap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Recycle the CMS Online and run the test. It should fail or reproduce the reported BUG/SNAP.&lt;br /&gt;
&lt;br /&gt;
Then upload the ZAP-applied build:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
make204 --zap&lt;br /&gt;
putmod --zap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For z/OS, upload the ZAP-build object deck:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
putmodzos --zap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Run the z/OS bind described below, recycle the Online, and run the same test. To switch back:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
putmod --no-zap&lt;br /&gt;
putmodzos --no-zap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The standard &amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt; command reads the normal object directory from &amp;lt;code&amp;gt;hlasm.jsonc&amp;lt;/code&amp;gt; and therefore tests &amp;lt;code&amp;gt;obj/M204ONLN.MODULE&amp;lt;/code&amp;gt;, not &amp;lt;code&amp;gt;zapobj/M204ONLN.MODULE&amp;lt;/code&amp;gt;. Do not cite that smoke test as evidence that the generated ZAP was applied. Test the ZAP build explicitly on CMS/z/OS, or create a separate &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; configuration whose &amp;lt;code&amp;gt;module&amp;lt;/code&amp;gt; names the ZAP-linked module.&lt;br /&gt;
&lt;br /&gt;
=== Final review ===&lt;br /&gt;
&lt;br /&gt;
Before committing:&lt;br /&gt;
&lt;br /&gt;
* Verify that the branch ZAP names only the modules expected for the fix.&lt;br /&gt;
* Verify every VER and REP block and the correct patch offsets.&lt;br /&gt;
* Check the prerequisite ZAP line; remove it if there is no prerequisite.&lt;br /&gt;
* Remove the template&#039;s special-instructions block unless it is required.&lt;br /&gt;
* Make sure the instructions name every load module that must be patched.&lt;br /&gt;
* Run &amp;lt;code&amp;gt;git status --short&amp;lt;/code&amp;gt; and stage source paths explicitly. Do not stage build output or unrelated files.&lt;br /&gt;
&lt;br /&gt;
== Testing on CMS with putmod ==&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;putmod&amp;lt;/code&amp;gt; uploads the linked CMS MODULE and map to the build disk derived from the release and userid. In the Online&#039;s &amp;lt;code&amp;gt;SETUP NAMES&amp;lt;/code&amp;gt;, set &amp;lt;code&amp;gt;:tester.&amp;lt;/code&amp;gt; to the builder userid so the Online loads that user&#039;s module.&lt;br /&gt;
&lt;br /&gt;
The normal recycle is:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
EOJ&lt;br /&gt;
IPL CMS&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
At the CMS Ready prompt, PROFILE EXEC normally starts the Online. Run the reproducing QA procedure after the Online is ready.&lt;br /&gt;
&lt;br /&gt;
Procedure changes are separate from the module upload. Push modified procedure directories with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
gitproc push qaproc&lt;br /&gt;
gitproc push m204proc&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Testing on z/OS with putmodzos and gitzosl ==&lt;br /&gt;
&lt;br /&gt;
The workstation linker produces a concatenated, fixed-80-byte z/OS object deck:&lt;br /&gt;
&lt;br /&gt;
* baseline: &amp;lt;code&amp;gt;obj/M204ONLN.ZOSMOD&amp;lt;/code&amp;gt;&lt;br /&gt;
* ZAP build: &amp;lt;code&amp;gt;zapobj/M204ONLN.ZOSMOD&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;putmodzos&amp;lt;/code&amp;gt; uploads that object deck to the PDSE member named by &amp;lt;code&amp;gt;zos.jsonc&amp;lt;/code&amp;gt;. It does &#039;&#039;&#039;not&#039;&#039;&#039; create the executable z/OS load module by itself. The &amp;lt;code&amp;gt;gitzosl&amp;lt;/code&amp;gt; job on the Builder runs the z/OS binder and creates the test load module.&lt;br /&gt;
&lt;br /&gt;
=== Configuration ===&lt;br /&gt;
&lt;br /&gt;
The Model 204 tree needs &amp;lt;code&amp;gt;zos.jsonc&amp;lt;/code&amp;gt; containing the z/OS FTP host, userid, object library, and member:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;host&amp;quot;: &amp;quot;...&amp;quot;,&lt;br /&gt;
  &amp;quot;user&amp;quot;: &amp;quot;...&amp;quot;,&lt;br /&gt;
  &amp;quot;objlib&amp;quot;: &amp;quot;...&amp;quot;,&lt;br /&gt;
  &amp;quot;member&amp;quot;: &amp;quot;...&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Do not put the password in this file. &amp;lt;code&amp;gt;putmodzos&amp;lt;/code&amp;gt; obtains it from the workstation credential store, prompting on first use.&lt;br /&gt;
&lt;br /&gt;
=== Build and upload ===&lt;br /&gt;
&lt;br /&gt;
For an unpatched baseline test:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
cd ~/m204-80&lt;br /&gt;
make204 --no-zap&lt;br /&gt;
putmodzos --no-zap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
For a ZAP-maintenance test:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
make204 --zap&lt;br /&gt;
putmodzos --zap&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The upload is binary into an FB 80 PDSE member. If &amp;lt;code&amp;gt;putmodzos&amp;lt;/code&amp;gt; says the object deck is missing, run &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt; first and confirm that the selected &amp;lt;code&amp;gt;obj/&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;zapobj/&amp;lt;/code&amp;gt; directory contains &amp;lt;code&amp;gt;M204ONLN.ZOSMOD&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Bind on z/OS ===&lt;br /&gt;
&lt;br /&gt;
On the Builder, run:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
gitzosl&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The submitted job deletes the prior test load module, compresses the test load library, binds &amp;lt;code&amp;gt;M204ONLN&amp;lt;/code&amp;gt; with IEWL, and applies the required ZAPs. Its output returns to the Builder&#039;s virtual reader through RSCS/NJE.&lt;br /&gt;
&lt;br /&gt;
Use &amp;lt;code&amp;gt;rl&amp;lt;/code&amp;gt; (RDRLIST), then PF11 to inspect the job output. A successful bind includes:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
$HASP395 ONLINE ENDED - RC=0000&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Do not start the test Online if the bind failed or if the expected object deck was not used.&lt;br /&gt;
&lt;br /&gt;
=== Select the z/OS Online ===&lt;br /&gt;
&lt;br /&gt;
On the Online&#039;s CMS console:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
EOJ&lt;br /&gt;
xedit setup names a&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Change:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
:opsys.CMS&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
to:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
:opsys.MVS&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The XEDIT command is:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
c/:opsys.CMS/:opsys.MVS/ *&lt;br /&gt;
file&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Leave &amp;lt;code&amp;gt;:tester.&amp;lt;/code&amp;gt; set to the builder userid. It still selects the test version of &amp;lt;code&amp;gt;M204ONLN&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Start and test ===&lt;br /&gt;
&lt;br /&gt;
Start with either a full CMS IPL or the configuration nickname:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
IPL CMS&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
PROFILE EXEC builds and submits the startup JCL. The JES messages include receipt of the job and completion of the submission step with &amp;lt;code&amp;gt;MAXCC=0000&amp;lt;/code&amp;gt;. Unlike a CMS Online, Model 204 is now running as a z/OS batch job; the CMS console returns to VM read instead of displaying the local &amp;lt;code&amp;gt;ONLINE&amp;lt;/code&amp;gt; message.&lt;br /&gt;
&lt;br /&gt;
Connect from the normal user session:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
M204F suffix&lt;br /&gt;
LOGIN&lt;br /&gt;
OPEN QAPROC&lt;br /&gt;
I QARUN pattern&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Run the same reproducer used for the baseline. For a ZAP fix, keep evidence that the baseline failed and the ZAP build passed.&lt;br /&gt;
&lt;br /&gt;
=== Return to CMS testing ===&lt;br /&gt;
&lt;br /&gt;
Shut down the z/OS Online, edit &amp;lt;code&amp;gt;SETUP NAMES&amp;lt;/code&amp;gt;, and change:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
c/:opsys.MVS/:opsys.CMS/ *&lt;br /&gt;
file&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Then IPL CMS or start the configuration nickname again.&lt;br /&gt;
&lt;br /&gt;
== Running a local Online with Janus TNSERV ==&lt;br /&gt;
&lt;br /&gt;
A Janus port of type &amp;lt;code&amp;gt;TNSERV&amp;lt;/code&amp;gt; supplies direct TN3270 access to a Model 204 Online. It does not use OMNI, SDS, OPENSERV, VTAM, or &amp;lt;code&amp;gt;IODEV=7&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
c3270 or s3270&lt;br /&gt;
        |&lt;br /&gt;
        v&lt;br /&gt;
localhost:7777&lt;br /&gt;
        |&lt;br /&gt;
        v&lt;br /&gt;
Janus TNSERV in Model 204 under emu204&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The emulator&#039;s IUCV TCP/IP service turns the guest listener into a real workstation socket. The test described below was run successfully against the 8.1 module: &amp;lt;code&amp;gt;s3270&amp;lt;/code&amp;gt; connected to port 7777, logged in, and &amp;lt;code&amp;gt;VIEW TNDEV&amp;lt;/code&amp;gt; returned &amp;lt;code&amp;gt;TNDEV 21&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Install a TN3270 client ===&lt;br /&gt;
&lt;br /&gt;
For normal interactive use, the most common client is &#039;&#039;&#039;Rocket Terminal Emulator&#039;&#039;&#039; on Windows. &#039;&#039;&#039;ZOC&#039;&#039;&#039; is also commonly used and is available on both Windows and macOS. Configure either product for TN3270 and connect to host &amp;lt;code&amp;gt;127.0.0.1&amp;lt;/code&amp;gt;, port &amp;lt;code&amp;gt;7777&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
The open-source x3270 family is useful when a command-line or scriptable client is needed:&lt;br /&gt;
&lt;br /&gt;
On Ubuntu or WSL:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
sudo apt update&lt;br /&gt;
sudo apt install c3270 s3270&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
On macOS:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
brew install x3270&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Homebrew itself must be installed first; the macOS command-line tools do not provide it.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;c3270&amp;lt;/code&amp;gt; is interactive. &amp;lt;code&amp;gt;s3270&amp;lt;/code&amp;gt; accepts commands on standard input and is useful for repeatable tests. Rocket Terminal Emulator, ZOC, &amp;lt;code&amp;gt;c3270&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;s3270&amp;lt;/code&amp;gt; all provide the required TN3270 support. A plain line-oriented &amp;lt;code&amp;gt;telnet&amp;lt;/code&amp;gt; client is not sufficient.&lt;br /&gt;
&lt;br /&gt;
=== Build the local case ===&lt;br /&gt;
&lt;br /&gt;
Create the case directory. It is not part of the repository or the npm package, so the files below are the complete case:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
mkdir -p ~/em204-cases/m204-81-tnserv/{files,out}&lt;br /&gt;
cd ~/em204-cases/m204-81-tnserv&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Its &amp;lt;code&amp;gt;emu204.jsonc&amp;lt;/code&amp;gt; names the 8.1 module, sets &amp;lt;code&amp;gt;tcpVm&amp;lt;/code&amp;gt; to the same &amp;lt;code&amp;gt;TCPIP&amp;lt;/code&amp;gt; service-machine name used by Model 204, and supplies the tested CCAIN, CCASTAT, output, procedure-file, CCASYS, and SIRLOCAL DDs:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;module&amp;quot;: &amp;quot;/home/user/m204-81/obj/M204ONLN.MODULE&amp;quot;,&lt;br /&gt;
  &amp;quot;lst&amp;quot;: &amp;quot;/home/user/m204-81/lst&amp;quot;,&lt;br /&gt;
  &amp;quot;cpuid&amp;quot;: &amp;quot;FF379B789175&amp;quot;,&lt;br /&gt;
  &amp;quot;jobName&amp;quot;: &amp;quot;ULSPFQA&amp;quot;,&lt;br /&gt;
  &amp;quot;tcpVm&amp;quot;: &amp;quot;TCPIP&amp;quot;,&lt;br /&gt;
  &amp;quot;parm&amp;quot;: &amp;quot;SYSOPT=X&#039;A3&#039;,LIBUFF=3072,LOBUFF=7168,SIRFUNC=X&#039;01&#039;,SIRPRMPT=1,SIRTUNE=0&amp;quot;,&lt;br /&gt;
  &amp;quot;storage&amp;quot;: &amp;quot;2G&amp;quot;,&lt;br /&gt;
  &amp;quot;dd&amp;quot;: {&lt;br /&gt;
    &amp;quot;CCAIN&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;ccain.txt&amp;quot;},&lt;br /&gt;
    &amp;quot;CCAPRINT&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;out/ccaprint.txt&amp;quot;},&lt;br /&gt;
    &amp;quot;CCAAUDIT&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;out/ccaaudit.txt&amp;quot;},&lt;br /&gt;
    &amp;quot;CCASTAT&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;files/M204.CCASTAT.binary&amp;quot;, &amp;quot;blocked&amp;quot;: true},&lt;br /&gt;
    &amp;quot;CCASNAP&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;out/ccasnap.txt&amp;quot;, &amp;quot;sequence&amp;quot;: true},&lt;br /&gt;
    &amp;quot;TOMPROC&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;files/TOM.PROCFILE.m204file&amp;quot;, &amp;quot;m204file&amp;quot;: true},&lt;br /&gt;
    &amp;quot;QAPROC&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.V81.QAPROC.m204file&amp;quot;, &amp;quot;m204file&amp;quot;: true},&lt;br /&gt;
    &amp;quot;M204PROC&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.V81.M204PROC.m204file&amp;quot;, &amp;quot;m204file&amp;quot;: true},&lt;br /&gt;
    &amp;quot;CCASYS&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.CCASYS.m204file&amp;quot;, &amp;quot;m204file&amp;quot;: true},&lt;br /&gt;
    &amp;quot;CCAGRP&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.CCAGRP.m204file&amp;quot;, &amp;quot;m204file&amp;quot;: true},&lt;br /&gt;
    &amp;quot;SIRLOCAL&amp;quot;: {&amp;quot;path&amp;quot;: &amp;quot;files/ULSPFTOM.SIRLOCAL.m204file&amp;quot;, &amp;quot;m204file&amp;quot;: true}&lt;br /&gt;
  }&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The local filenames shown above preserve the source z/OS data set names for clarity. Qualifiers such as &amp;lt;code&amp;gt;TOM&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;ULSPFTOM&amp;lt;/code&amp;gt; are specific to the user or account that owns the source files and will vary for another person running the Online. Substitute the names used for that user&#039;s downloaded copies throughout &amp;lt;code&amp;gt;emu204.jsonc&amp;lt;/code&amp;gt;. The DD names on the left, such as &amp;lt;code&amp;gt;QAPROC&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;M204PROC&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;CCASYS&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;CCAGRP&amp;lt;/code&amp;gt;, must still match the Model 204 file names expected by the procedures.&lt;br /&gt;
&lt;br /&gt;
On macOS use &amp;lt;code&amp;gt;/Users/&amp;lt;var&amp;gt;name&amp;lt;/var&amp;gt;/m204-81&amp;lt;/code&amp;gt; in the two paths. The &amp;lt;code&amp;gt;ccain.txt&amp;lt;/code&amp;gt; is below. Each line ending in a dash must have that dash in column 72 (see above):&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
HDRCTL=3,LOGADD=5,LVTBL=60000,LITBL=104,                               -&lt;br /&gt;
LTTBL=2000,LNTBL=18000,LOBUFF=26000,LQTBL=70000,LSTBL=480000,          -&lt;br /&gt;
LFTBL=400000,LGTBL=400000,                                             -&lt;br /&gt;
NFILES=100,NDCBS=100,NDIR=100,PAGESZ=6184,SEQOPT=1,SPCORE=120000,      -&lt;br /&gt;
UDDLPP=0,OUTMRL=80,NUSERS=8,SDAEMDEV=15,NSUBTKS=12,                    -&lt;br /&gt;
ALOCPRIV=7,NSERVS=8,TEMPPAGE=40000,SIRFACT=X&#039;F9&#039;,MSGCTL=0,             -&lt;br /&gt;
OUTLPP=0,LANGUSER=US,SIRTERM=3,LOUTPB=16000,SCRNSTBL=20000,            -&lt;br /&gt;
LFSCB=20000,TNDEV=21,SERVSIZE=5000000,MAXDAEM=5,NCMPBUF=2,LECHO=0,     -&lt;br /&gt;
SESNPRV=400,SESNPUB=400,SESUMAX=100,SESDEFOW=2,NUMBUFG=1000&lt;br /&gt;
IODEV=15,NOTERM=7,DUPTERM=6,LINEND=X&#039;0D&#039;&lt;br /&gt;
LOGIN&lt;br /&gt;
JANUS DEFINE TNSERV 7777 TNSERV 5 WSFQUERY TCPKEEPALIVE -&lt;br /&gt;
 BINDADDR 127.0.0.1&lt;br /&gt;
JANUS START TNSERV&lt;br /&gt;
HALT 48,MODEL 204 JANUS TELNET SERVER READY ON PORT 7777,3,EOD&lt;br /&gt;
EOD&lt;br /&gt;
HALT 33,ON-LINE USERS REQUESTED TO LOGOFF,3,EOJ&lt;br /&gt;
EOJ&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;SYSOPT=X&#039;A3&#039;&amp;lt;/code&amp;gt; enables the audit options and causes both CCASYS and CCAGRP to open during initialization. CCAGRP supplies the &amp;lt;code&amp;gt;SIRSYS&amp;lt;/code&amp;gt; group used by SIRMON. &amp;lt;code&amp;gt;TNDEV=21&amp;lt;/code&amp;gt; enables Janus Telnet sessions. &amp;lt;code&amp;gt;SIRTERM&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;WSFQUERY&amp;lt;/code&amp;gt; support terminal screen geometry. &amp;lt;code&amp;gt;LFSCB=20000&amp;lt;/code&amp;gt; gives CCASYS subsystem procedures enough file-group select-list space; the default value of 8 causes &amp;lt;code&amp;gt;M204.1342: FSCB full&amp;lt;/code&amp;gt; followed by &amp;lt;code&amp;gt;M204.1457&amp;lt;/code&amp;gt;. &amp;lt;code&amp;gt;LGTBL=400000&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;LFTBL=400000&amp;lt;/code&amp;gt; provide the global and file table space needed by the subsystem-definition procedures; the default &amp;lt;code&amp;gt;LGTBL=288&amp;lt;/code&amp;gt; caused &amp;lt;code&amp;gt;M204.0562: Request too long - GTBL&amp;lt;/code&amp;gt;, again followed by &amp;lt;code&amp;gt;M204.1457&amp;lt;/code&amp;gt;. &amp;lt;code&amp;gt;SESNPUB=400&amp;lt;/code&amp;gt; permits SIRMON to create its public &amp;lt;code&amp;gt;sirmonMenu&amp;lt;/code&amp;gt; session; the default value of zero makes &amp;lt;code&amp;gt;$SESSION_CREATE&amp;lt;/code&amp;gt; return code 2 and ultimately causes &amp;lt;code&amp;gt;MSIR.0491&amp;lt;/code&amp;gt;. The other session values match the proven QA configuration. With these settings, the tested startup created and opened &amp;lt;code&amp;gt;sirmonMenu&amp;lt;/code&amp;gt; and reported &amp;lt;code&amp;gt;M204.0430: Subsystem SIRMON started&amp;lt;/code&amp;gt;. Notices for statistics unavailable in this Online were nonfatal. &amp;lt;code&amp;gt;NCMPBUF=2&amp;lt;/code&amp;gt; supplies compression buffers required by the compression tests. &amp;lt;code&amp;gt;TCPKEEPALIVE&amp;lt;/code&amp;gt; is appropriate for long-lived terminal connections. &amp;lt;code&amp;gt;BINDADDR 127.0.0.1&amp;lt;/code&amp;gt; keeps the development port local to the workstation.&lt;br /&gt;
&lt;br /&gt;
The tested case uses a copy of the development CCASTAT rather than a generated account. CCASTAT is an undefined-format, record-oriented data set, so a plain binary stream is not sufficient. Download it with EBCDIC block-mode framing preserved:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
ftp rss1.rocketsoftware.com&lt;br /&gt;
binary&lt;br /&gt;
quote type e&lt;br /&gt;
quote mode b&lt;br /&gt;
get &#039;M204.CCASTAT&#039; /home/user/em204-cases/m204-81-tnserv/files/M204.CCASTAT.binary&lt;br /&gt;
quit&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Allocate it with &amp;lt;code&amp;gt;&amp;quot;blocked&amp;quot;: true&amp;lt;/code&amp;gt;, not &amp;lt;code&amp;gt;&amp;quot;m204file&amp;quot;: true&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
&amp;quot;CCASTAT&amp;quot;: {&lt;br /&gt;
  &amp;quot;path&amp;quot;: &amp;quot;files/M204.CCASTAT.binary&amp;quot;,&lt;br /&gt;
  &amp;quot;blocked&amp;quot;: true&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The &amp;lt;code&amp;gt;TYPE E MODE B&amp;lt;/code&amp;gt; transfer preserves the descriptor byte and two-byte count preceding each record. The tested copy was 13,841 bytes in three framed records. Users log in with their existing development CCASTAT user IDs and passwords.&lt;br /&gt;
&lt;br /&gt;
The numbers before the two HALT messages are exact message lengths, not timeouts. An incorrect count causes User 0 to continue reading CCAIN and can immediately reach &amp;lt;code&amp;gt;EOJ&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
=== Start the Online ===&lt;br /&gt;
&lt;br /&gt;
Start the case with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
#!/usr/bin/env bash&lt;br /&gt;
set -euo pipefail&lt;br /&gt;
cd &amp;quot;$(dirname &amp;quot;$0&amp;quot;)&amp;quot;&lt;br /&gt;
exec emu204&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
chmod +x run.sh&lt;br /&gt;
./run.sh&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Keep standard input attached to the terminal: the operator replies to the HALT messages (see below) are read from it. Without a terminal, for example under &amp;lt;code&amp;gt;nohup&amp;lt;/code&amp;gt;, give it a pipe that stays open, such as &amp;lt;code&amp;gt;sleep 600 | ./run.sh&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Wait for:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
MODEL 204 JANUS TELNET SERVER READY ON PORT 7777&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
From another terminal, confirm that the listener exists:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
nc -vz 127.0.0.1 7777&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Connect and test ===&lt;br /&gt;
&lt;br /&gt;
For an interactive session:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
c3270 127.0.0.1:7777&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
At the Model 204 prompt, log in with an account from the copied development CCASTAT and run a test command:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
LOGIN userid&lt;br /&gt;
password&lt;br /&gt;
VIEW TNDEV&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
The password is entered in response to &amp;lt;code&amp;gt;M204.0347&amp;lt;/code&amp;gt; and is not displayed. The expected result includes:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
M204.0353: userid ... login&lt;br /&gt;
TNDEV     21          IODEV number for TNSERV threads&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To automate the same check, pipe &amp;lt;code&amp;gt;Connect&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;String&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Enter&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;Wait&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;Ascii&amp;lt;/code&amp;gt; actions to &amp;lt;code&amp;gt;s3270 -script&amp;lt;/code&amp;gt;. Do not put a real password in a committed script or shell history.&lt;br /&gt;
&lt;br /&gt;
=== Shut down cleanly ===&lt;br /&gt;
&lt;br /&gt;
For the quickest shutdown, issue &amp;lt;code&amp;gt;EOJ&amp;lt;/code&amp;gt; from a privileged session and answer &amp;lt;code&amp;gt;Y&amp;lt;/code&amp;gt; when Model 204 asks for confirmation. The TN3270 connection closes and &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; reports normal Online termination.&lt;br /&gt;
&lt;br /&gt;
Alternatively, log out and quit the TN3270 client. At the &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; operator terminal, reply to the first HALT with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
EOD&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
After users have disconnected, reply to the second HALT with:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
EOJ&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Model 204 should report that all users are logged out and begin normal Online termination.&lt;br /&gt;
&lt;br /&gt;
== Working on the tools themselves ==&lt;br /&gt;
&lt;br /&gt;
Use &amp;lt;code&amp;gt;~/gitm204&amp;lt;/code&amp;gt; only when changing &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt;, the assembler/linker, or another tool:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
cd ~/gitm204&lt;br /&gt;
npm install&lt;br /&gt;
npx make&lt;br /&gt;
npm test&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Useful narrower checks are:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
npm run testci&lt;br /&gt;
npm run testmake&lt;br /&gt;
npm run testm204&lt;br /&gt;
npm run testm204qa&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
To prove the working-tree tools can build and run Model 204:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
npx make&lt;br /&gt;
npx testM204Build --tree=&amp;quot;$HOME/m204-80&amp;quot;&lt;br /&gt;
npx testM204Qa --tree=&amp;quot;$HOME/m204-80&amp;quot;&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;testM204Build&amp;lt;/code&amp;gt; empties &amp;lt;code&amp;gt;obj/&amp;lt;/code&amp;gt; and &amp;lt;code&amp;gt;ref/&amp;lt;/code&amp;gt; in the tree it is given. Do not point it at a working tree whose current build output must be preserved.&lt;br /&gt;
&lt;br /&gt;
== Troubleshooting ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Symptom !! Action&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;make204&amp;lt;/code&amp;gt; is not found || Reinstall &amp;lt;code&amp;gt;@rocket/m204-tools&amp;lt;/code&amp;gt;, run &amp;lt;code&amp;gt;hash -r&amp;lt;/code&amp;gt;, and inspect &amp;lt;code&amp;gt;type -a make204&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;emu204&amp;lt;/code&amp;gt; says its platform package is missing || Reinstall without &amp;lt;code&amp;gt;--no-optional&amp;lt;/code&amp;gt; or &amp;lt;code&amp;gt;--ignore-scripts&amp;lt;/code&amp;gt;; check for an older command earlier on PATH. Published binaries support x86-64 Linux and Apple-silicon macOS.&lt;br /&gt;
|-&lt;br /&gt;
| Hundreds of unknown assembler operations || The macro libraries are probably absent or half-fetched. Run &amp;lt;code&amp;gt;getmaclib --direct&amp;lt;/code&amp;gt;, then rebuild.&lt;br /&gt;
|-&lt;br /&gt;
| Linker reports unresolved LE symbols || Fetch the required object library with &amp;lt;code&amp;gt;getobjlib --direct&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| ZAP file has only its header || Confirm the source really differs from the baseline, refresh the baseline from unmodified master, and check whether the module is excluded from automatic ZAP generation.&lt;br /&gt;
|-&lt;br /&gt;
| ZAP unexpectedly contains many modules || The baseline or a pinned build setting is stale. Return to master and rebuild with &amp;lt;code&amp;gt;make204 --no-zap&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| QA run has a nonzero return code || Read the &amp;lt;code&amp;gt;testM204Qa&amp;lt;/code&amp;gt; verdict. The Model 204 return code is not the pass/fail result.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;m204qa/&amp;lt;/code&amp;gt; appears as untracked after a test || The installed QA driver writes its case and output beside the Model 204 tree. Preserve anything needed from &amp;lt;code&amp;gt;m204qa/out/&amp;lt;/code&amp;gt;, then remove the generated directory.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;MSIR.1097&amp;lt;/code&amp;gt; says hardware compression is unavailable || Expected under the current emulator; it does not by itself fail the QA run.&lt;br /&gt;
|-&lt;br /&gt;
| Need more emulator detail || Use &amp;lt;code&amp;gt;emu204 --help&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;emu204 --help=config&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;emu204 --help=em&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;M204.1122: Invalid parameter = -&amp;lt;/code&amp;gt; at startup || A continuation dash is not in column 72. Pad the line with blanks so that the dash is the 72nd character.&lt;br /&gt;
|-&lt;br /&gt;
| Port 7777 closes immediately after startup || Check the HALT message lengths in CCAIN. They must exactly match the message text or User 0 can continue to &amp;lt;code&amp;gt;EOJ&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| A copied CCASTAT cannot be read or logins fail unexpectedly || Download it with &amp;lt;code&amp;gt;binary&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;quote type e&amp;lt;/code&amp;gt;, and &amp;lt;code&amp;gt;quote mode b&amp;lt;/code&amp;gt;, then configure it with &amp;lt;code&amp;gt;&amp;quot;blocked&amp;quot;: true&amp;lt;/code&amp;gt;.&lt;br /&gt;
|-&lt;br /&gt;
| A plain &amp;lt;code&amp;gt;telnet&amp;lt;/code&amp;gt; client connects but does not produce a usable screen || Use a TN3270 client such as &amp;lt;code&amp;gt;c3270&amp;lt;/code&amp;gt;; TNSERV requires TN3270 negotiation.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Source references ==&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;code&amp;gt;gitm204/BUILD.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;gitm204/em204/README.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;m204-80/DEVELOPMENT.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;m204-80/ZAP-WORKFLOW.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;m204-80/.github/skills/building.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;m204-80/.github/skills/testing.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;m204-80/.github/skills/zos-crossbuild.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;m204-81/DEVELOPMENT.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;m204-81/.github/skills/building.md&amp;lt;/code&amp;gt;&lt;br /&gt;
* &amp;lt;code&amp;gt;m204-81/.github/skills/testing.md&amp;lt;/code&amp;gt;&lt;/div&gt;</summary>
		<author><name>Tthoresen</name></author>
	</entry>
</feed>