¿ªÔÆÌåÓý


Re: IBM Documentation Hidden At IBM

 

On Tue, Mar 25, 2025 at 03:18 AM, Stefan A. Haubenthal wrote:
Maybe Bitsavers is a better place than Wayback Machine?
Maybe both? This is a copy from Wayback of IBM PDFs, with their confusing filenames.

?
?... Mark S.


Re: Current source for VM/ESA Manuals?

 

As a somewhat frustrated follow-up, I've discovered that my screen reader does not handle the IBM Softcopy utility at all, at least not without use of OCR, which is the very problem I was trying to avoid. :) So I'm either stuck using books in PDF or figuring out how to convert BOO files to another format, which appears to be non-trivial.

Thanks for the tip concernning versions of ZVM. The core concepts appear to be similar even if the details differ. I will continue the journey despite setbacks :)

Best,
Zack.

--?
? Zachary Kline


On Wed, Mar 26, 2025, at 4:24 PM, Zachary Kline via groups.io wrote:
Hi?Ren¨¦ and all,

Thanks for the quick and helpful responses. I am, as it happens, without sight of any kind, hence why I prefer documents in original electronic format whenever possible to spare me from having to figure out what the sometimes badly mangled OCR results are saying.

I've so far found the provided redbook invaluable. I'm at the point of running MVS/ESA under VM using pre-provided directory entries, which is a decent step :)

I particularly appreciate the block-oriented nature of the 3270, as the screen reader program handles it in some ways far better than more typical character-by-character UI on, say, Linx.

I will reach out off-list regarding the larger manual collections, as I don't want to clutter up the traffic :)
Best,
Zack.

--?
? Zachary Kline


On Wed, Mar 26, 2025, at 9:08 AM, Ren¨¦ Ferland via groups.io wrote:
On Tue, Mar 25, 2025 at 09:32 PM, Zachary Kline wrote:
The latter is particularly helpful for me as a totally blind user.
I am not sure what you mean here, no previous knowledge or no sight? :-/
?
Anyway, if it is the first, I would recommend reading this:
?

?
It introduces to the basics of z/VM (actually z/VM 5.3) but most of the material there applies to VM/ESA as well (since it covers the basics).
?
Cheers,
?
Rene FERLAND, Montreal
?
P.S. -- I have a fairly complete documentation of z/VM 5.3 in PDF format (81 books for 288M). If you are interested, just tell me, I will send it to you.
?



Re: Current source for VM/ESA Manuals?

 

Hi?Ren¨¦ and all,

Thanks for the quick and helpful responses. I am, as it happens, without sight of any kind, hence why I prefer documents in original electronic format whenever possible to spare me from having to figure out what the sometimes badly mangled OCR results are saying.

I've so far found the provided redbook invaluable. I'm at the point of running MVS/ESA under VM using pre-provided directory entries, which is a decent step :)

I particularly appreciate the block-oriented nature of the 3270, as the screen reader program handles it in some ways far better than more typical character-by-character UI on, say, Linx.

I will reach out off-list regarding the larger manual collections, as I don't want to clutter up the traffic :)
Best,
Zack.

--?
? Zachary Kline


On Wed, Mar 26, 2025, at 9:08 AM, Ren¨¦ Ferland via groups.io wrote:
On Tue, Mar 25, 2025 at 09:32 PM, Zachary Kline wrote:
The latter is particularly helpful for me as a totally blind user.
I am not sure what you mean here, no previous knowledge or no sight? :-/
?
Anyway, if it is the first, I would recommend reading this:
?

?
It introduces to the basics of z/VM (actually z/VM 5.3) but most of the material there applies to VM/ESA as well (since it covers the basics).
?
Cheers,
?
Rene FERLAND, Montreal
?
P.S. -- I have a fairly complete documentation of z/VM 5.3 in PDF format (81 books for 288M). If you are interested, just tell me, I will send it to you.
?


Re: Current source for VM/ESA Manuals?

 

On Tue, Mar 25, 2025 at 11:32 PM, Zachary Kline wrote:
I wondered if anyone had a good source for VM/ESA era manuals they could point me to? I've looked on Bitsavers but there doesn't seem to be much.
I've stumbled on this collection, in BookManager format.
?
?
?... Mark S.


Re: Current source for VM/ESA Manuals?

 

Before IBM took down a very handy publication website, I was able to get some of VM/ESA 2.4 documentation.? I use SoftCopy Reader to access my manuals and the folder for VM/ESA 2.4 pubs is about 263mb consisting of 125 files that are PDF and BOO.
?
Let me know if you are interested.


Re: Current source for VM/ESA Manuals?

 

On Tue, Mar 25, 2025 at 09:32 PM, Zachary Kline wrote:
The latter is particularly helpful for me as a totally blind user.
I am not sure what you mean here, no previous knowledge or no sight? :-/
?
Anyway, if it is the first, I would recommend reading this:
?
?
It introduces to the basics of z/VM (actually z/VM 5.3) but most of the material there applies to VM/ESA as well (since it covers the basics).
?
Cheers,
?
Rene FERLAND, Montreal
?
P.S. -- I have a fairly complete documentation of z/VM 5.3 in PDF format (81 books for 288M). If you are interested, just tell me, I will send it to you.
?


Re: Current source for VM/ESA Manuals?

 

On Wed, Mar 26, 2025 at 10:49 AM, Berry van Sleeuwen wrote:

There are some manuals at but to reach them you need to know the exact filename (pdf) to get access. When you go to this exact url you get an error, and certainly no listing of all available files. So it's hard to say if the VM/ESA manuals are in there.

?
I think all the ESA documents have been removed.. Following the link from the product announcement page gives a 404
?

A few years ago there was a website that provided an active bookmanager but he got a take-down request from IBM, IBM stated that it's proprietary content was available on the IBM website. Well, maybe back then, but certainly not anymore. All IBM Bookmanager websites have been shutdown in recent years, or at least the bookmanager application is no longer available. Publibz used to host such environment. At least I'm glad I still have my old bookmanager files available, that includes all VM/ESA 2.x manuals. If you manage to get hold of an old documention CD that will include the bookmanager files. PDF versions of the publications is more recent, I have some PDF versions of VM/ESA 2.4 but not from earlier versions, that's all .BOO.

I know of at least one site with .BOO files. The Library Reader for Windows and later Softcopy Reader which reads these is still downloadable from the IBM web site
?
?
https://www.ibm.com/support/pages/ibm-softcopy-reader-windows-v40-0

Apart from Bitsavers I don't know if there is any easy accessable material available.

There once was an IBM utility to manage these, but it seems to have vanished. The book files seem to have vanished.

For general VM manuals you might take a look at the official IBM VM Libarary page. In Indexed pdf's at there is a zip file with the old z/VM 5.4 documentation. Indeed while not ideal, most of it is also applicable for VM/ESA. Obviously z/VM has a lot of new features that is not included in VM/ESA but it does help.

Regards, Berry.

Op 26-03-2025 om 05:31 schreef Zachary Kline via groups.io:
Hi All,

I guess this question probably comes up a lot, but here we go again. :)

I wondered if anyone had a good source for VM/ESA era manuals they could point me to? I've looked on Bitsavers but there doesn't seem to be much. 

I'm mostly interested in ESA because it seems both relatively easy to run on Hercules and likely to have manuals in original electronic format. The latter is particularly helpful for me as a totally blind user. OCR is not ideal.

I know a lot of things used to be available from IBM, but they seem to move around a lot or vanishh without much fanfare.

I'm particularly looking for electronic copies of any tutorial material, the general information manuals, concepts, and so on. I'm very new to mainframes as a hobby, though have a slight acquaintance with MVS and its ilk.

Thanks much :)
Best,
Zack.
P.S. I did find a thread earlier which linked to a giant Internet Archive directory, but that interface is absurd and I have no idea how to find anything in particular using the big table.



Re: Current source for VM/ESA Manuals?

 

¿ªÔÆÌåÓý

There are some manuals at but to reach them you need to know the exact filename (pdf) to get access. When you go to this exact url you get an error, and certainly no listing of all available files. So it's hard to say if the VM/ESA manuals are in there.

A few years ago there was a website that provided an active bookmanager but he got a take-down request from IBM, IBM stated that it's proprietary content was available on the IBM website. Well, maybe back then, but certainly not anymore. All IBM Bookmanager websites have been shutdown in recent years, or at least the bookmanager application is no longer available. Publibz used to host such environment. At least I'm glad I still have my old bookmanager files available, that includes all VM/ESA 2.x manuals. If you manage to get hold of an old documention CD that will include the bookmanager files. PDF versions of the publications is more recent, I have some PDF versions of VM/ESA 2.4 but not from earlier versions, that's all .BOO.

Apart from Bitsavers I don't know if there is any easy accessable material available.

For general VM manuals you might take a look at the official IBM VM Libarary page. In Indexed pdf's at there is a zip file with the old z/VM 5.4 documentation. Indeed while not ideal, most of it is also applicable for VM/ESA. Obviously z/VM has a lot of new features that is not included in VM/ESA but it does help.

Regards, Berry.

Op 26-03-2025 om 05:31 schreef Zachary Kline via groups.io:

Hi All,

I guess this question probably comes up a lot, but here we go again. :)

I wondered if anyone had a good source for VM/ESA era manuals they could point me to? I've looked on Bitsavers but there doesn't seem to be much. 

I'm mostly interested in ESA because it seems both relatively easy to run on Hercules and likely to have manuals in original electronic format. The latter is particularly helpful for me as a totally blind user. OCR is not ideal.

I know a lot of things used to be available from IBM, but they seem to move around a lot or vanishh without much fanfare.

I'm particularly looking for electronic copies of any tutorial material, the general information manuals, concepts, and so on. I'm very new to mainframes as a hobby, though have a slight acquaintance with MVS and its ilk.

Thanks much :)
Best,
Zack.
P.S. I did find a thread earlier which linked to a giant Internet Archive directory, but that interface is absurd and I have no idea how to find anything in particular using the big table.



Current source for VM/ESA Manuals?

 

Hi All,

I guess this question probably comes up a lot, but here we go again. :)

I wondered if anyone had a good source for VM/ESA era manuals they could point me to? I've looked on Bitsavers but there doesn't seem to be much.

I'm mostly interested in ESA because it seems both relatively easy to run on Hercules and likely to have manuals in original electronic format. The latter is particularly helpful for me as a totally blind user. OCR is not ideal.

I know a lot of things used to be available from IBM, but they seem to move around a lot or vanishh without much fanfare.

I'm particularly looking for electronic copies of any tutorial material, the general information manuals, concepts, and so on. I'm very new to mainframes as a hobby, though have a slight acquaintance with MVS and its ilk.

Thanks much :)
Best,
Zack.
P.S. I did find a thread earlier which linked to a giant Internet Archive directory, but that interface is absurd and I have no idea how to find anything in particular using the big table.


--
Zachary Kline
zkline@...


Re: IBM Documentation Hidden At IBM

 

Maybe Bitsavers is a better place than Wayback Machine?
?
--
VM/370 CE V1R1.2, Hercules on macOS


Re: Which Hercules and which host?

 

On Wed, Mar 19, 2025 at 05:27 PM, Fish Fish wrote:

As far as I know, Jay's Aethra is supposed to be identical to a current SDL 4.x Hyperion version of Hercules, but without many of the modern more advanced z/Architectural features that newer more modern "z" operating systems need/require, but which older legacy operating systems such as VM/370 R6 have no need for, thus making it slightly faster than SDL 4.x Hyperion. (How much faster, I have no idea. I've never bothered to try measuring it.)

All these responses are useful. Thanks! As I don't have any need for "z" operating systems, nor licenses, I'll probably go Aethra. Speed isn't really an issue for me, but I always lean toward lighter weight systems if I have a choice.

My old shop was a 370/148 when I started, and a 4300 series when I left.

Excellent hosting and configuration advice, I wasn't aware of the helper.

Thanks again all,

Troy.


Re: IPCS? The Unwanted/Unneeded Application

 

On Fri, Mar 21, 2025 at 20:39 Thomas Kern via <TLK_sysprog=[email protected]> wrote:
On 3/21/2025 8:18 PM, Mark A. Stevens via wrote:

Do we need IPCS?
I think Amdahl had its own dump analysis program (ANALYZE ?). If that is available, I would look at that.

The best dump tool I've ever seen, bar none, ?was Kolinar's KPROBE, and I spent 20 years working on applications for VM, 12 of them developing and supporting VMBACKUP and its siblings.? I vaguely recall that Jim Bergstrom sold Kolinar to VM Systems Group, which later became Relay Technologies.? I can't remember whether we (Sterling Software) acquired KPROBE when Relay sold us some of its VM products, or whether it stayed behind.? Regardless, it's almost certainly lost to the sands of time now. ?

KPROBE was like XEDIT for dumps.? My colleagues and I wrote several hundred KPROBE macros to make analyzing dumps easier, in Rexx, of course.

Ross


Re: IPCS? The Unwanted/Unneeded Application

 

¿ªÔÆÌåÓý

On 3/21/2025 8:18 PM, Mark A. Stevens via groups.io wrote:
Hi folks!
If you don't know what it stands for, you are only an acronym behind me:? Interactive Problem Control System.
Did anyone ever use IPCS?
Yes, I did use IPCS when I was working on these systems.
Does anyone still use IPCS?
I don't WORK on them anymore. I might use IPCS if I start PLAYING with these systems again.
Do we need IPCS?
I think Amdahl had its own dump analysis program (ANALYZE ?). If that is available, I would look at that.
?... Mark S.

Tom Kern


IPCS? The Unwanted/Unneeded Application

 

Hi folks!
?
If you don't know what it stands for, you are only an acronym behind me:? Interactive Problem Control System.
?
Did anyone ever use IPCS?

Does anyone still use IPCS?
?
Do we need IPCS?
?
?... Mark S.
?
?


Re: Which Hercules and which host?

 

On 03.18.2025 10:50, Zane Healy via groups.io wrote:
My preference for running something like Hercules or SIMH is a Virtual Machine running on an older x86 box with Linux installed. Log in, start up ¡¯screen¡¯ and then start up the emulator. I¡¯ve used a Raspberry Pi for Multics and MVS in the past, but find Virtual Machines to be more convenient. I prefer to run OpenSUSE on the VM, but have also used Ubuntu and Red Hat.
100% agree. I always use Debian for servers and have switched to tmux
instead of screen, but yes, this is how I run all of my Hercules and
simh instances -- Debian VM on my VM server with tmux sessions for each
Hercules (MVS 3.8 / VM/370 / etc) listening on a different console port.

Question, has anyone looked at using Proxmox for this?? I¡¯m looking to migrate my home lab off of ESXI, due to the cost.
Yes. Early this year I made the switch to Proxmox on my VM servers after
a decade of ESXi. Very happy with it.

ONE IMPORTANT TIP, though: I always set the VM CPU to "host" instead of
the default (x86-64-v2-AES) when creating new VMs. I don't have a
cluster of Proxmox servers where I need to worry about live-migrating
VMs between hosts with different CPU models, so it always seemed like a
good idea to me to just pass through the real CPU to VMs instead of
having QEMU fake a specific CPU.

It turns out the *one* VM I accidentally forgot to set the CPU to "host"
when I created it was my mainframe VM that runs all of my Hercules
instances. I was having an intermittent problem where my MVS 3.8
instance wouldn't IPL -- it just hung forever shortly after the IPL
started. No Hercules crash, no errors...just stopped making forward
progress. After a lot of troubleshooting, I eventually realized the VM
CPU was set to x86-64-v2-AES, not "host". I changed the CPU model of
the VM to "host". Sure enough, the intermittent IPL problem went away!
Hercules has been reliable again after I made that change.

-Matthew


Re: Which Hercules and which host?

 

Dave Wade wrote:

[...]
To me this is more "bloatware" with feature such as IEEE
floating point, 31 & 64 bit code, various network interfaces
and pile of other stuff I don't use.
I understand perfectly. In fact, this so called "bloatware" issue that SDL 4.x Hyperion currently suffers from with respect to older legacy operating systems (which I honestly believe is a rather unfair characterization of the issue) is what I believe ultimately compelled Jay Maynard to create Aethra in the first place. (Jay? True?)

Jay wanted a more modern version of Hercules with the all of the known 3.x bugs fixed, but without all of the code necessary to support all of the features and functionality that legacy operating systems didn't really need. Essentially, he wanted a SDL Hercules 4.x Hyperion "Light" version of Hercules designed exclusively for older legacy operating systems (i.e. a "bloatware-free" version of SDL Hercules 4.x Hyperion). (Jay? Yes?)


I would really like a smaller lighter Hercules for use with
legacy operating systems..
Have you tried Jay's Aethra? Because I believe that was one of his goals -- if not his *primary* goal -- with creating Aethra.


Your choice.

(but I know which one *I* would personally prefer!)
Yes but you aren't running 370 code on a PI.
Correct.

And I'm also not running legacy operating systems either. I'm running modern "Z" operating systems, largely because there is a rather large non-insignificant demand for such a version of Hercules.

If I was an ordinary Hercules user instead of a Hercules developer, I would probably prefer the same version of Hercules that you are preferring, but without the bugs. In other words, I would probably be running Aethra for my heavily modified personally customized version of DOS/VS (and VM/SP 5 if I could ever find a copy).

p.s. You still haven't "irked" me yet, but you seem to be heading in that direction! ;-)

--
"Fish" (David B. Trout)
Software Development Laboratories

mail: fish@...


Re: Which Hercules and which host?

 

On 19/03/2025 21:27, Fish Fish via groups.io wrote:
Dave Wade wrote:
BlameTroi wrote:
[...]
I'm wanting to rebuild my first serious shop in my home:
VM hosting DOS/VS. I see that there are Hercules Aethra
and SDL Hercules versions. Is there any reason to prefer
one over the other for running VMCE?
I don't believe for any of the 370 based OSs such as VM/370 R6
which is the base for VM/CE there is any difference. In fact
at the risk of irking Jay and Fish I would say that on a PI
one of the 3.X releases might work better as they are a little
lighter.
While it's true that the older 3.x releases of Hercules are certainly faster than the SDL 4.x Hyperion releases, they are also buggier, failing to pass more than one of SDL Hyperion's Quality Assurance tests, producing either incorrect results or outright crashing. I would personally not recommend using it for that simple reason alone.

As far as I know, Jay's Aethra is supposed to be identical to a current SDL 4.x Hyperion version of Hercules, but without many of the modern more advanced z/Architectural features that newer more modern "z" operating systems need/require, but which older legacy operating systems such as VM/370 R6 have no need for, thus making it slightly faster than SDL 4.x Hyperion. (How much faster, I have no idea. I've never bothered to try measuring it.)


So, to summarize:


* 3.x: buggy. Not personally recommended.

* Aethra: same(?) as SDL 4.x but without the
unneeded modern z/Arch features, and thus
*possibly* faster than SDL 4.x Hyperion.
(But its speed advantage(?) -- if any --
has never been measured as far as I know.)

* SDL 4.x Hyperion: the most current up to date
and recommended version of Hercules designed
for BOTH modern z/Arch operating systems AND
older legacy operating systems as well, but
slower than Hercules 3.x. (Not sure about
Aethra as I never bothered to measure it.)


So you have to ask yourself: Which would you personally prefer?

To more quickly arrive at *possibly* the wrong answer? (3.x)
Is the 370 emulation really buggy if you disable the assists?

Or to more slowly and more confidently arrive at the right answer? (SDL and probably Aethra as well)
To me this is more "bloat ware" with feature such as IEEE floating point , 31 & 64 bit code, various network interfaces and pile of other stuff I don't use.
I would really like a smaller lighter Hercules for use with legacy operating systems..

Your choice.

(but I know which one *I* would personally prefer!)
Yes but you aren't running 370 code on a PI.
Dave


Re: Which Hercules and which host?

 

Dave Wade wrote:
BlameTroi wrote:
[...]
I'm wanting to rebuild my first serious shop in my home:
VM hosting DOS/VS. I see that there are Hercules Aethra
and SDL Hercules versions. Is there any reason to prefer
one over the other for running VMCE?
I don't believe for any of the 370 based OSs such as VM/370 R6
which is the base for VM/CE there is any difference. In fact
at the risk of irking Jay and Fish I would say that on a PI
one of the 3.X releases might work better as they are a little
lighter.
While it's true that the older 3.x releases of Hercules are certainly faster than the SDL 4.x Hyperion releases, they are also buggier, failing to pass more than one of SDL Hyperion's Quality Assurance tests, producing either incorrect results or outright crashing. I would personally not recommend using it for that simple reason alone.

As far as I know, Jay's Aethra is supposed to be identical to a current SDL 4.x Hyperion version of Hercules, but without many of the modern more advanced z/Architectural features that newer more modern "z" operating systems need/require, but which older legacy operating systems such as VM/370 R6 have no need for, thus making it slightly faster than SDL 4.x Hyperion. (How much faster, I have no idea. I've never bothered to try measuring it.)


So, to summarize:


* 3.x: buggy. Not personally recommended.

* Aethra: same(?) as SDL 4.x but without the
unneeded modern z/Arch features, and thus
*possibly* faster than SDL 4.x Hyperion.
(But its speed advantage(?) -- if any --
has never been measured as far as I know.)

* SDL 4.x Hyperion: the most current up to date
and recommended version of Hercules designed
for BOTH modern z/Arch operating systems AND
older legacy operating systems as well, but
slower than Hercules 3.x. (Not sure about
Aethra as I never bothered to measure it.)


So you have to ask yourself: Which would you personally prefer?

To more quickly arrive at *possibly* the wrong answer? (3.x)

Or to more slowly and more confidently arrive at the right answer? (SDL and probably Aethra as well)

Your choice.

(but I know which one *I* would personally prefer!)

--
"Fish" (David B. Trout)
Software Development Laboratories

mail: fish@...


Re: Which Hercules and which host?

 

¿ªÔÆÌåÓý

I am running 6 old OS'ses on a Raspberry Pi 5 with 8G - including Multics. All over Tmux and ssh tunnels. Working great.

There is no problem running on a Mac either, Hercules Helper (git clone?) makes building either of them very, very easy on macOS and Ubuntu (like in starting it and visiting the coffee machine easy.)

On modern Pi's I run the latest versions the helper decides to check out. I agree with Dave for the older PI's.

best regards,

¸é±ð²Ô¨¦.

On 18 Mar 2025, at 19:27, Dave Wade via groups.io <dave.g4ugm@...> wrote:



On 18/03/2025 16:36, BlameTroi via groups.io wrote:

This may be a dumb question, but I couldn't find anything helpful after searching here in groups and generally on the web.

I'm wanting to rebuild my first serious shop in my home: VM hosting DOS/VS. I see that there are Hercules Aethra and SDL Hercules versions. Is there any reason to prefer one over the other for running VMCE?

I don't believe for any of the 370 based OSs such as VM/370 R6 which is the base for VM/CE there is any difference. In fact at the risk of irking Jay and Fish I would say that on a PI one of the 3.X releases might work better as they are a little lighter.

From my reading a while back, MacOS security is a pain in the butt for Hercules and some other software.


I am not a Mac guy, but I think this is only a problem when running post 370 operating systems which have network interfaces....


While I'm a Mac guy these days, I have old but Windows 11 capable Intel boxes and a few of the various Pi boards, including a 4, available. Are Pis sufficient for VM and possibly DOSVS?

I haven't run Hercules on a PI for a while. Its slow, I believe it gives a similar performance to 4331/4341/4361 class machine. Give it a try..

Thanks.

Dave
G4UGM







Re: RSCS Assistant

 

Errors were found, so I will be posting an updated set of files soon.
?
Would it be a good idea to add sequence numbers to the COPY datasets?

I created HELP for the two EXECs.

Part of my idea is to modify VMSETUP EXEC to call the RSCSACC EXEC. Comments, questions, criticisms?
?
Would it be prudent to create a "Program Product" tape with a MEMO and an INSTALL EXEC?
?
?... Mark S.