On Sun, Mar 30, 2025 at 12:30 PM, Andre wrote:
Is there SCRIPT/VS foreground processor for MVS 3.8 or VM/370 by any chance?
?
?
Waterloo SCRIPT is available on VM/370 CE, type "help script". The manual is in SCRIPT LISTING U.
?
Cheers,
?
Rene FERLAND, Montreal
?
P.S. -- I remember using SCRIPT on MUSIC/SP for course material when I taught Fortran and SAS back in 1982.
|
Thank you, Ross! Very interesting info.
Is there SCRIPT/VS foreground processor for MVS 3.8 or VM/370 by any chance?
?
Best wishes,
Andre
|
What program IBM used in 1970s and 1980s to prepare, format and typeset those docs??
I know that UNIX crowd usually used something like TROFF or NROFF, then TeX.
But I doubt that IBM didn't have their own software for this task.
IBM did indeed have its own software for this task.? And it made it available to their customers, for a fee, of course.? The core was the IBM "SCRIPT" product,?sold under several names,?but most-lately "Document Composition Facility" (DCF).??
SCRIPT was inspired by the ur-formatter, RUNOFF[1], which ran on MIT's Compatible Time Sharing System (CTSS), and goes back to the late 1960s.? Soon afterward, some IBM'ers built a set of SCRIPT macros and a pre-processor to support writing documents in Generalized Markup Language[2].? IBM released that work as the "GML Starter Set" for SCRIPT/VS.? Internally, it continued to develop the markup language and came up with what was eventually?released to customers as "BookMaster", a fully-fledged book composition and formatting system.? The ".BOO" files that we've been discussing were produced as one form of BookManager output (it could also do text-only, fully-typeset, etc.).? IBM also released a set of programs that read those files, called "BookManager", and even a free version called "IBM Library Reader" for OS/2 and Windows, that could read documents specially "stamped" for it.
In the 1990s, as HTML[3] took off, Gary Richtmeyer, of IBM and later AT&T, wrote "B2H", a BookMaster-to-HTML converter that did a great job of putting BookMaster books on the web (from the source form, not the .BOO files).? That code was released freely and runs today just fine on VM/SP and later (I haven't tried it on VM/370 yet), OS/2, Windows, Linux (and other unices), and MVS (and presumably z/OS).
Ross
[1] RUNOFF was also the inspiration for roff,?the original Unix formatter. [2] GML was the inspiration for XML. [3] GML was also the inspiration for HTML.
|
I have a strange question, but maybe someone here knows the answer.
What program IBM used in 1970s and 1980s to prepare, format and typeset those docs??
I know that UNIX crowd usually used something like TROFF or NROFF, then TeX.
But I doubt that IBM didn't have their own software for this task.
?
Best wishes,
Andre
|
[...] By: René Ferland <ferland.rene@...>
Description:
Yet another program (by Jean-Pierre Cabanié) that convert the JSON file of
Jon Templin to a HTML file. The HTML output is included in the ZIP. PERFECT! THANK YOU, René! -- "Fish" (David B. Trout) Software Development Laboratories mail: fish@...
|
The following items have been added to the Files area of the [email protected] group.
By: René Ferland <ferland.rene@...>
Description:
Yet another program (by Jean-Pierre Cabanié) that convert the JSON file of Jon Templin to a HTML file. The HTML output is included in the ZIP.
|
Re: IBM Documentation Hidden At IBM
On Sat, Mar 29, 2025 at 07:41 AM, Ken Dreger wrote:
Would you mind posting the code for your JSON effort here? Maybe some of us can take a look at it and figure a way to make it work different??
?
The code is a .NET 8 console app written in C# and developed with Visual Studio 2022 under Windows. It makes use of the PdfPig NuGet package to parse the PDFs.
?
The input file with the list of URLs is included with the project. The longest time taken by the app is fetching each PDF off the internet. On my i5-8400 dev box, it takes about 40 minutes to run all the files.
?
Take what's useful "as-is".
?
Jon T.
|
Re: IBM Documentation Hidden At IBM
Hi Ken,
?
thank you. I wrote a little JavaScript program for the transformation. You need NodeJs to run it.
?
Here is the source code (it includes Jon's JSON data):
?
You run it (e.g. on the Windows command line) with: node generate_docu.js >ibm_documentation.html
?
As I wrote, it is quick and dirty and no example of elegant JavaScript coding. It generates the ouptput just with console.log statements.
?
Maybe it even runs on a modern IBM mainframe :-). As far as I know, NodeJS is available for z/OS.
?
Feel free to adapt it to your needs.
?
Best regards
?
Norbert
|
Re: IBM Documentation Hidden At IBM
Would you mind posting the code for your JSON effort here? Maybe some of us can take a look at it and figure a way to make it work different??
?
BTW, thank you for your fine effort.
|
Re: IBM Documentation Hidden At IBM
On Fri, Mar 28, 2025 at 10:48 PM, Fish Fish wrote:
Not to look a gift horse in the mouth (because I very much do appreciate your effort, Jon!), but I was kind of looking for something like simple HTML
?
You're welcome.
?
My thinking: JSON is so ubiquitous nowadays, you can shape it into anything you want. Or even have Chat-GPT do it for you.?
I was in a hurry, and in C#, I could serialize JSON with one or two statements.
?
Jon T.
|
Re: IBM Documentation Hidden At IBM
Hi Jon,
?
thanks. This is really great. I made a very quick and dirty conversion of your JSON to HTML.
?
You find it here:
?
Greetings
?
Norbert
|
Re: IBM Documentation Hidden At IBM
Hello guys!
?
Please find attached excel database. I made it from JSON for myself, but decided to share. Hope it helps.
https://docs.google.com/spreadsheets/d/14gY-ZKwfgf_srx0lY0aRQQZ-Wf1ltV2d/edit?usp=sharing&ouid=111879433608677265990&rtpof=true&sd=true
?
Best wishes,
Andre
|
Re: IBM Documentation Hidden At IBM
Jon Templin wrote: {
"Url": ",
"Title": "ID6TUMST",
"Author": "",
"Subject": "",
"Keywords": [],
"DocumentNumber": "GA22-1030-03",
"FirstPage": "S/390\uF6DAParallel Enterprise Server - Generation 6IBM
System Overview Level 03a, February 8, 2001 GA22-1030-03"
}, [...] Not to look a gift horse in the mouth (because I very much do appreciate your effort, Jon!), but I was kind of looking for something like simple HTML, such as: <ul> <li><a href=">GA22-1030-03 ID6TUMST</a> <li><a href=">SA22-7832-04 Principles of Operation</a> <li><a href=">SA22-7832-05 IBM z/Architecture Principles of Operation</a> ...etc... </ul> That is to say, a simple html unordered list of hyperlinks, whose name consists of your "DocumentNumber" value followed by tour "Title" value (with a space in between), which RESOLVES to your "Url" value, so that when published on a web page, allows one to simply click on the link to obtain the actual document. To find the document they want, they can just do a simple search of the web page in question (i.e. ctrl+f in most browsers). Maybe someone could take the data that Jon extracted and throw together a simple script to do that? And then publish the results somewhere? But THANK YOU for doing the hard part for us, Jon! MUCH appreciated! Enjoy your vacation! -- "Fish" (David B. Trout) Software Development Laboratories mail: fish@...
|
Re: IBM Documentation Hidden At IBM
On Fri, Mar 28, 2025 at 03:19 PM, Jon Templin wrote:
I've uploaded the file ibm_pubs_pdf_metadata.zip which contains the data from the full run of all the files.
A small sample is elsewhere in this thread.
?
I wrote the code quickly today because I'm leaving town on vacation and I may or may not have access to this forum while away.
?
I forgot to add that I dropped "Keywords" from the final JSON because there was no such data in the vast majority of the files. The few that did duplicated the "DocumentNumber" data, so I didn't deem it useful.
|
The following items have been added to the Files area of the [email protected] group.
By: Jon Templin <jon@...>
Description:
Metadata extracted from IBM PDF publications at https://publibz.boulder.ibm.com/epubs/pdf/*
|
Re: IBM Documentation Hidden At IBM
I've uploaded the file ibm_pubs_pdf_metadata.zip which contains the data from the full run of all the files.
A small sample is elsewhere in this thread.
?
I wrote the code quickly today because I'm leaving town on vacation and I may or may not have access to this forum while away.
|
Re: IBM Documentation Hidden At IBM
Maybe it should be saved in our wiki?
--
VM/370 CE V1R1.2, Hercules 3.13 on macOS
|
Re: IBM Documentation Hidden At IBM
Hi Jon,
?
This looks very useful to me.
?
Best regards,
?
Steen
|
Re: IBM Documentation Hidden At IBM
Been playing with this for the last hour or two. Something like this?
I included an excerpt of the first page because sometimes the metadata didn't include the actual title like in the first file.
I may take out subject and keyword if none appear when I run the entire set of files.
```
[
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a2210303.pdf",
? ? "Title": "ID6TUMST",
? ? "Author": "",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "GA22-1030-03",
? ? "FirstPage": "S/390\uF6DAParallel Enterprise Server - Generation 6IBM System Overview ?Level 03a, February 8, 2001 GA22-1030-03"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a2278324.pdf",
? ? "Title": "Principles of Operation",
? ? "Author": "IBM",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "SA22-7832-04",
? ? "FirstPage": "z/Architecture\u0001\u0002\u0003\u00AEPrinciples of OperationSA22-7832-04"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a2278325.pdf",
? ? "Title": "IBM z/Architecture Principles of Operation",
? ? "Author": "IBM Corporation",
? ? "Subject": "This publication provides, for reference purposes, a detailed description of z/Architecture.\u2122",
? ? "Keywords": [],
? ? "DocumentNumber": "SA22-7832-05",
? ? "FirstPage": "z/Architecture\u0002\u0003\u0004\u00AEPrinciples of OperationSA22-7832-05"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a2278712.pdf",
? ? "Title": "Reference Summary",
? ? "Author": "IBM",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "SA22-7871-02",
? ? "FirstPage": "SA22-7871-02z/ArchitectureIBMrReference Summary"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a2314520.pdf",
? ? "Title": "GPFS: Administration and Programming Reference",
? ? "Author": "IBM",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "SA23-1452-00",
? ? "FirstPage": "GeneralParallelFileSystemVersion4Release1AdministrationandProgrammingReferenceSA23-1452-00\u0001\u0002\u0003"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a2322320.pdf",
? ? "Title": "Preliminary Decimal-Floating-Point Architecture",
? ? "Author": "Lundvall",
? ? "Subject": "Preliminary Decimal-Floating-Point Architecture",
? ? "Keywords": [],
? ? "DocumentNumber": "SA23-2232-00",
? ? "FirstPage": "SA23-2232-00z/Architecture\u0002\u0003\u0004\u00AEPreliminary Decimal-Floating-Point ArchitectureNovember, 2006"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a2322738.pdf",
? ? "Title": "IBM PE for Linux: PAMI Prog. Guide",
? ? "Author": "IBM",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "SA23-2273-08",
? ? "FirstPage": "ParallelEnvironmentRuntimeEditionforLinuxVersion1Release3PAMIProgrammingGuideSA23-2273-08\u0001\u0002\u0003"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a7604060.pdf",
? ? "Title": "Word Pro - A7604060.lwp",
? ? "Author": "jacarson",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "GA76-0406-00",
? ? "FirstPage": "Installation ProcedureStep 1. Plan for Installation1.First-level Installation requirements: - Exclusive access to ?your "
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a7604061.pdf",
? ? "Title": "z/VM V5R3.0 Summary for Automated Installation and Service (DVD Installation)",
? ? "Author": "IBM",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "GA76-0406-00",
? ? "FirstPage": "\u00A9 Copyright International Business Machines Corporation 1991, 2007. ?All rights reserved. This edition replaces GA76-040"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a7604062.pdf",
? ? "Title": "z/VM V5R4.0 Summary for Automated Installation and Service (DVD Installation)",
? ? "Author": "IBM",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "GA76-0406-01",
? ? "FirstPage": "\u00A9 Copyright International Business Machines Corporation 1991, 2008. ?All rights reserved. This edition replaces GA76-040"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a7604070.pdf",
? ? "Title": "Word Pro - A7604070.lwp",
? ? "Author": "jacarson",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "GA76-0407-00",
? ? "FirstPage": "Installation ProcedureStep 1. Plan for Installation1.Second-level installation- The installation userid on ?your first-l"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/a7604072.pdf",
? ? "Title": "z/VM V5R4.0 Summary for Automated Installation and Service (Tape Installation)",
? ? "Author": "IBM",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "GA76-0407-01",
? ? "FirstPage": "Installation Procedure Important: This document contains summarized steps for installing and servicing version 5 release"
? },
? {
? ? "Url": "https://publibz.boulder.ibm.com/epubs/pdf/ab0in022.pdf",
? ? "Title": "Installing, Managing, and Using the Online Library",
? ? "Author": "IBM",
? ? "Subject": "",
? ? "Keywords": [],
? ? "DocumentNumber": "GC31-8311-47",
? ? "FirstPage": "IBMOnlineLibraryInstalling,Managing,andUsingtheOnlineLibraryGC31-8311-47\u0001\u0002\u0003"
? }
]
```
|
Re: Current source for VM/ESA Manuals?
On Thu, 27 Mar 2025 at 11:03, Berry van Sleeuwen via groups.io <berry.vansleeuwen@...> wrote: You might want to look at the boo2pdf program by Kevin Bowling at . Well that was exciting for a few moments. But it's really just a front end that invokes the IBM machine code (SOs/DLLs) that actually implements the .BOO (BookManager) file processing. If *that* was in Java then it could be trivially decompiled and understood. But to my knowledge IBM has never released code or even documentation for any part of this format. Tony H.
|
René Ferland
Ken Dreger
Stefan A. Haubenthal