On Sun, Mar 30, 2025 at 10:35 PM, René Ferland wrote:
?
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.
Wow!! This is so cool! I will definitely try it out!
?
Thanks, Rene!
|
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 h390-vm@groups.io 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 h390-vm@groups.io 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"
? }
]
```
|
René Ferland
Ken Dreger
Stefan A. Haubenthal