Discussion:
[hercules-390] New to Hercules
rasakereh@yahoo.com [hercules-390]
2017-12-09 21:22:09 UTC
Permalink
Hi all,
I am new to Hercules and really confused by a pile of Hercules configuration instruction
Since its very basic steps, how can I run a binary file for IBM S/370?
And does Hercules contain a built-in assembler for S/370 assembly language?
Thanks all!
Ivan Warren ivan@vmfacility.fr [hercules-390]
2017-12-09 21:36:06 UTC
Permalink
Post by ***@yahoo.com [hercules-390]
Hi all,
I am new to Hercules and really confused by a pile of Hercules
configuration instruction
Since its very basic steps, how can I run a binary file for IBM S/370?
And does Hercules contain a built-in assembler for S/370 assembly language?
Thanks all!
Hello,

hercules is a software implementation of the S/370 (and beyond) hardware
(CPU & I/O). So just like for a personnal computer, you're going to need
to install an operating system of some sort.
There are various operating systems available that you can legally run
and instructions on how to install them (MVS 3.8j, VM/370, DOS/VS 34)
including some ready to run (aka "turnkey") systems which are dasd
images of already customized environments.
Assemblers are usually provided in those environments (Either F or XF
assembler).
You also have the possibility to install z/Linux (Debian, Ubuntu, SuSe,
RedHat, etc..) but these require a bit of fidling around. (z/Linux
contains the appropriate assembler (gas which is part of binutils) for
that environment).

--Ivan


[Non-text portions of this message have been removed]
kerravon86@yahoo.com.au [hercules-390]
2017-12-09 21:37:24 UTC
Permalink
Post by ***@yahoo.com [hercules-390]
I am new to Hercules and really confused by
a pile of Hercules configuration instruction
Go here:

http://wotho.ethz.ch/tk4-/

Download this:

http://wotho.ethz.ch/tk4-/tk4-_v1.00_current.zip

And if you are not up and running in 10
minutes, post a message here:

https://groups.yahoo.com/neo/groups/H390-MVS

describing what happened so that the
problem can be diagnosed.
Post by ***@yahoo.com [hercules-390]
Since its very basic steps, how can I run a
binary file for IBM S/370?
I don't understand this question. Do you have
something already? If so, what is it? A zip
file? An xmit? An AWS tape? Do a "dir" or
"ls" of the file so that we can see its name
and size, and if you can, also do a hex
display of the first 50 or whatever bytes.
Post by ***@yahoo.com [hercules-390]
And does Hercules contain a built-in
assembler for S/370 assembly language?
TK4- does, yes. It is TK4- that has the
assembler, not Hercules. Hercules is
part of the TK4- distribution.

BFN. Paul.
'Dave Wade' dave.g4ugm@gmail.com [hercules-390]
2017-12-09 21:52:34 UTC
Permalink
Hercules is a “bare metal” emulator, the question “how can I run a binary file” is equivalent to asking “how can I run a program on a PC without installing an operating system” such as Linux, Windows, BSD etc.

In order to install an operating system you need to define the S/370 devices the operating system will use, so you need a config file. Most of the downloadable operating systems include a config file so its not too hard.

Hercules does not contain an assembler




Dave

G4UGM



(NOTE;- it is possible to load some standalone programs, but as these need to contain some features of an operating system, writing them isn’t something for a beginner to try. You still need config file.)



From: hercules-***@yahoogroups.com [mailto:hercules-***@yahoogroups.com]
Sent: 09 December 2017 21:22
To: hercules-***@yahoogroups.com
Subject: [hercules-390] New to Hercules





Hi all,
I am new to Hercules and really confused by a pile of Hercules configuration instruction
Since its very basic steps, how can I run a binary file for IBM S/370?
And does Hercules contain a built-in assembler for S/370 assembly language?
Thanks all!
gah@ugcs.caltech.edu [hercules-390]
2017-12-10 20:41:46 UTC
Permalink
Yes you can run programs without an OS. This is traditionally done with the "three card loader" which will read in S/360 style object programs into the assembled addresses. That is, there is no relocation, so the appropriate ORG must be used. For the 360/20, there is a one card loader, and no OS, so that is pretty much the only way. Also, IPL programs are written similarly, with appropriate ORG and no relocation.

The P/370 has the ability to load such without using the three card loader, as it, more or less, has it built in.
'Dave Wade' dave.g4ugm@gmail.com [hercules-390]
2017-12-10 21:23:05 UTC
Permalink
Does this avoid the need for a Hercules config?

Do you have to understand how to handle interrupts?

How do you assemble the code without an OS in which to run an assembler?

There are some standalone games you can download and run here:-



http://perso.wanadoo.es/rptv2005/saPROGS/en/index.html



and there is instructions on there for creating an IPL from file system


..but it does it help learn 370 assembler from scratch. I think not




Dave

p.s. the 360/20 is generally not considered to be a 360. Hercules can’t emulate it (or any 360)




From: hercules-***@yahoogroups.com [mailto:hercules-***@yahoogroups.com]
Sent: 10 December 2017 20:42
To: hercules-***@yahoogroups.com
Subject: RE: [hercules-390] New to Hercules





Yes you can run programs without an OS. This is traditionally done with the "three card loader" which will read in S/360 style object programs into the assembled addresses. That is, there is no relocation, so the appropriate ORG must be used. For the 360/20, there is a one card loader, and no OS, so that is pretty much the only way. Also, IPL programs are written similarly, with appropriate ORG and no relocation.

The P/370 has the ability to load such without using the three card loader, as it, more or less, has it built in.
'\'Fish\' (David B. Trout)' david.b.trout@gmail.com [hercules-390]
2017-12-10 22:31:20 UTC
Permalink
This post might be inappropriate. Click to display it.
'Dave Wade' dave.g4ugm@gmail.com [hercules-390]
2017-12-10 23:14:34 UTC
Permalink
-----Original Message-----
Sent: 10 December 2017 22:31
Subject: RE: [hercules-390] New to Hercules
Post by 'Dave Wade' ***@gmail.com [hercules-390]
Does this avoid the need for a Hercules config?
Do you have to understand how to handle interrupts?
How do you assemble the code without an OS in which to run an assembler?
[...]
Post by 'Dave Wade' ***@gmail.com [hercules-390]
..but it does it help learn 370 assembler from scratch. I think not...
https://github.com/s390guy/SATK
It comes with a nice assembler that runs on your personal computer (PC)
called ASMA ("A Small Mainframe Assembler") that uses python to assemble
ASMA source code into IBM mainframe machine code. It can create list
directed IPL files, object text decks or binary image files, which can be used
directly by Hercules to IPL or load and start your program.
The list directed IPL files can be IPLed by Hercules via the "ipl <filename>" or
"iplc <filename>" commands.
The object code text decks and binary image files are loaded into guest
storage by Hercules via the "loadtext <filename>" and "loadcore <filename>"
commands respectively. Once loaded they can then be started via either the
"start" or "restart" commands depending on how you designed your
program.
The ASMA assembler is close to IBM's assembler but has special
commands/statements designed specifically for writing stand-alone IPLable
mainframe programs. Hence the name: "SATK" (Stand-Alone Took Kit).
ASMA also comes with an extensive set of helper macros too that handle
initializing the Channel I/O Subsystem and starting I/Os and waiting for their
completion, allowing you to concentrate on the non-I/O related part of your
program (which is usually what you're most interested in).
MANY of Hercules's quality control "runtest" tests were created using it. See
for example the "tape.asm", "tape.core", "tape.list", "tape.pdf" and
"tape.tst" files in the 'tests' subdirectory of the Hercules source code
distribution. It and many other of Hercules's "runtest" integrity tests were
built using SATK/ASMA.
Harold Grovesteen (who I'm sure will eventually respond) can provide you
with much more detail since he is after all the author (and currently one of
the Hercules development team's head honchos).
It's great! :)
--
"Fish" (David B. Trout)
Software Development Laboratories
http://www.softdevlabs.com
I had forgotten about that, its sounds great, but the original complaint was that loading an OS and generating a config file was complex.
So whilst SATK exists IMHO it’s a tad more complex than writing an OS program using QSAM macros..

Dave
------------------------------------
------------------------------------
http://groups.yahoo.com/group/hercules-390
http://www.hercules-390.org
------------------------------------
Yahoo Groups Links
Harold Grovesteen h.grovsteen@tx.rr.com [hercules-390]
2017-12-11 16:39:57 UTC
Permalink
Hi all, 
Post by ***@yahoo.com [hercules-390]
I am new to Hercules and really confused by a pile of Hercules configuration instruction
Since its very basic steps, how can I run a binary file for IBM S/370?
And does Hercules contain a built-in assembler for S/370 assembly language?
Thanks all!
      
  
    
    
         
As Fish' post suggests, take a look at SATK.  Documentation exists in
the tool kit.  It was expressly designed to provide an assembler for
S/370 through to the modern 64-bit capable programs.  It is
specifically designed to run with Hercules.  It does not eliminate the
Hercules configuration file, but they are usually quite simple.  I can
help.  Feel free to email me off list directly.  Fish provided the link
to the github repository.  Pay particular attention to the "Getting
Started" section of the ASMA.pdf manual.

Yes, Fish, I finally saw the posts.  Thanks for the plug.

Harold Grovesteen

Loading...