Monday, December 2, 2019

PC/370 Assembler Object Code Translator Demo Files


Previous Post: PC/370 Assembler Object Code Translator

With regard to my previous PC/370 Object Code Translator post the components are now available to test on your own Windows machine. Later versions of Windows require DOSBOX to execute (Information below).

This was posted under the LinkedIn Group: Mainframe Assembler Programmers

TD021 Demonstration ZIP File: CLICK HERE

TD021 Demo - ZIP Contents:

TD021.COM       - PC/370 Executable COM File
E370R42.EXE     - PC/370 Runtime Execution Module
@TD021_demo.txt - Instructions


E370R42.EXE is the PC/370 Runtime Execution Module. It is part of the archived PC/370 R4.2 Package created by Donald Higgins. There are numerous sites where the package may be downloaded from (not required to run the demo).

Here's one of the Free Download sites: CLICK HERE


ABOVE: PC/370 Object Code Translator Application.

TD021 Function Keys:

KEY      FUNCTION
=======  ==============================
@K#ESC   EXIT PROGRAM
@K#PGDN  PGDN - Pg Down (16 lines)
@K#PGUP  PGUP - Pg Up   (16 lines)
@K#F1    F1 - Page Down (16 lines)
@K#F2    F2 - Page Up   (16 lines)
@K#F3    F3 - Page Down ( 1 line )
@K#F4    F4 - Page Up   ( 1 line )
@K#ARWD  DOWN - Pg Down ( 1 line )
@K#ARWU  UP - Pg Up   ( 1 line )
@K#TAB   TAB - Forward Half-Word 
@K#TABL  Shft-TAB - Back Half-Word
@K#ARWL  LEFT - Back Half-Word   
@K#F10   F10 - Step thru code (50)
@K#HOM   HOME - Top of Module    
@K#END   END - End of Module
=======  ==============================


OTHER KEYS will tab through each instruction (or a halfword if not a recognizable instruction).



DOSBOX can be downloaded for free at DOSBOX.COM


ABOVE: DOSBOX installed & running. MOUNT the C: drive, navigate to the demo folder (PC370X) & launch the TD021 process.

Running the Demo is very simple.

Unzip the demo files into a folder (I'm using C:\PC370X).

Install & Launch DOSBOX from your desktop

Perform the following line commands:

Z:\> MOUNT C C:\
Z:\> C:
C:\> CD PC370X
C:\> TD021


The process evaluates the opcode at the current offset pointer & displays the attributes along with the translated source code. If it is not a recognizable opcode it displays the hexadecimal values for a generic halfword. The pointer is recalculated based on the instruction length or the particular navigation key pressed.

NOTE - This is a simple translator based on the current pointer position - it is not a live "real-time" debugger tool. Using the TAB keys (TAB=Forward & Shift-TAB=Backward) the pointer is moved & evaluated in halfword increments - the resulting source code displayed is not an accurate representation of the actual module - it is indicative of the pointer position only.


Thanks for the positive feedback - hope someone finds this interesting & fun...

Previous 370 Assembler Posts:
https://tdxbits.blogspot.com/2019/03/pc370-assembler-object-code-translator.html
https://tdxbits.blogspot.com/2019/03/mvs370-assembler-like-building-with.html
https://tdxbits.blogspot.com/2019/03/pc370-assembler-creation-stars-stripes.html
https://tdxbits.blogspot.com/2019/04/resourceful-solution-using-ibm-dfsort.html
https://tdxbits.blogspot.com/2019/04/caroscoe-libi-interface-read-member.html
https://tdxbits.blogspot.com/2019/11/acsl-agram-card-game-pc370-version.html
https://tdxbits.blogspot.com/2019/11/acsl-agram-pc370-keyboard-input.html