Re: z/Architecture Principles of Operation pdf

2021-12-03 Thread Ian Worthington
I'm not familiar with zd, I'm afraid. My involvement with zPDT and its 
predecessors/alternatives was using the z/os CD image which, iirc, gave you a 
turnkey system without a lot of futzing around.
If you want to test IMS txs though, I imagine you'd need to bring over your IMS 
environment configuration and libraries, so yes, some systems work is probably 
inevitable, but not as much as you fear.
i
Sent from Yahoo Mail on Android 
 
  On Thu, 2 Dec 2021 at 17:33, Schmitt, Michael wrote: 
  Would "running a zPDT" system mean running z System Development and Test 
Environment (ZD)? I thought that was only for development and testing.


Also, I have a hard time understanding ZD

I need to test IMS online transactions, but I don't want them to run in the 
real IMS environment.  I think there are few options for this:

- Micro Focus Enterprise Developer (MFED)
- ZD

IBM Developer for z/OS (IDz) is out because it runs the tests on the real z/OS 
system, which would interfere with other users not to mention corrupt the 
databases.

But the problem with ZD, as far as I can tell, is:

- Requires Linux
- Costs twice as much as MFED
- Since it is an emulation of z Systems, doesn't that mean that you have to be 
a z Systems system programmer/administrator to install and manage it?

I mean, I know how to assemble, link, and execute HLASM programs on z/OS. I 
don't know how to install the assembler, binder, or JES on z/OS nor any of the 
other myriad things the IT department is doing.

Is the only purpose of ZD to be used to test z/OS images as an alternative to 
testing on an actual LPAR (or in VM)? Meaning, you're someone that can install 
z/OS on an LPAR, but you're going to put it on a Linux machine instead.


-Original Message-
From: IBM Mainframe Assembler List  On Behalf 
Of Ian Worthington
Sent: Monday, November 15, 2021 11:16 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

Have you considered running a zPDT system, or getting a cloud system just for 
that?  That's got to be cheaper than sysplex licensing, surely?
> IBM has a free BookMaster to HTML converter, which in theory could be used to 
> convert our system BookMaster documentation to HTML, but in practice it is 
> too buggy. I've tried fixing some of the bugs but get bogged down in trying 
> to figure out what CSS to generate.
What about converting to XML and pushing the formatting issue into the style 
sheet?

Best wishes,

Ian ...

    On Monday, November 15, 2021, 11:53:41 AM GMT-5, Schmitt, Michael 
 wrote:

 I miss BookMaster too, because all of my system documentation is written in 
it, and we can't format documentation updates anymore. (The problem is that the 
sysplex licensing for SCRIPT/VS is prohibitively expensive. No SCRIPT means no 
BookMaster.)

I also have a system that creates both printed documentation and ISPF help from 
the same BookMaster source, by replacing the ISPF help engine with its own 
system (for help in the application, not across all ISPF). Now I have to 
maintain the help source by hand.

IBM has a free BookMaster to HTML converter, which in theory could be used to 
convert our system BookMaster documentation to HTML, but in practice it is too 
buggy. I've tried fixing some of the bugs but get bogged down in trying to 
figure out what CSS to generate.

> (though the script underpinnings, not so much)

Agree. SCRIPT/VS macros are the hardest programs I've worked in. The macros 
look like a cat walked across the punctuation keys, and every single character 
is critical



  


Re: z/Architecture Principles of Operation pdf

2021-12-02 Thread Schmitt, Michael
Would "running a zPDT" system mean running z System Development and Test 
Environment (ZD)? I thought that was only for development and testing.


Also, I have a hard time understanding ZD

I need to test IMS online transactions, but I don't want them to run in the 
real IMS environment.  I think there are few options for this:

- Micro Focus Enterprise Developer (MFED)
- ZD

IBM Developer for z/OS (IDz) is out because it runs the tests on the real z/OS 
system, which would interfere with other users not to mention corrupt the 
databases.

But the problem with ZD, as far as I can tell, is:

- Requires Linux
- Costs twice as much as MFED
- Since it is an emulation of z Systems, doesn't that mean that you have to be 
a z Systems system programmer/administrator to install and manage it?

I mean, I know how to assemble, link, and execute HLASM programs on z/OS. I 
don't know how to install the assembler, binder, or JES on z/OS nor any of the 
other myriad things the IT department is doing.

Is the only purpose of ZD to be used to test z/OS images as an alternative to 
testing on an actual LPAR (or in VM)? Meaning, you're someone that can install 
z/OS on an LPAR, but you're going to put it on a Linux machine instead.


-Original Message-
From: IBM Mainframe Assembler List  On Behalf 
Of Ian Worthington
Sent: Monday, November 15, 2021 11:16 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

Have you considered running a zPDT system, or getting a cloud system just for 
that?  That's got to be cheaper than sysplex licensing, surely?
> IBM has a free BookMaster to HTML converter, which in theory could be used to 
> convert our system BookMaster documentation to HTML, but in practice it is 
> too buggy. I've tried fixing some of the bugs but get bogged down in trying 
> to figure out what CSS to generate.
What about converting to XML and pushing the formatting issue into the style 
sheet?

Best wishes,

Ian ...

On Monday, November 15, 2021, 11:53:41 AM GMT-5, Schmitt, Michael 
 wrote:

 I miss BookMaster too, because all of my system documentation is written in 
it, and we can't format documentation updates anymore. (The problem is that the 
sysplex licensing for SCRIPT/VS is prohibitively expensive. No SCRIPT means no 
BookMaster.)

I also have a system that creates both printed documentation and ISPF help from 
the same BookMaster source, by replacing the ISPF help engine with its own 
system (for help in the application, not across all ISPF). Now I have to 
maintain the help source by hand.

IBM has a free BookMaster to HTML converter, which in theory could be used to 
convert our system BookMaster documentation to HTML, but in practice it is too 
buggy. I've tried fixing some of the bugs but get bogged down in trying to 
figure out what CSS to generate.

> (though the script underpinnings, not so much)

Agree. SCRIPT/VS macros are the hardest programs I've worked in. The macros 
look like a cat walked across the punctuation keys, and every single character 
is critical





Re: z/Architecture Principles of Operation pdf

2021-11-23 Thread Seymour J Metz
Is there a URL for an index page?


From: IBM Mainframe Assembler List  on behalf 
of Peter Relson 
Sent: Tuesday, November 23, 2021 8:39 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

I don't know if this was responded to or not, but the following is likely
true, but not overly important, because it's not the "expected" way

It can be obtained by going through
https://www-01.ibm.com/servers/resourcelink, however, this requires
an IBM Resourcelink user ID and the pub seems to be in a machine
model specific library (for example, the "z15 Model T01 library").
:

The PoP can be found here:
http://publibfp.dhe.ibm.com/epubs/pdf/a227832c.pdf
It is within the hardware doc which is where it belongs. It does not
require a ResourceLink ID to access.
But, yes, it would be nice if there were a link to it from the z/OS doc.

And when a new version is posted, they append to assembler-list, providing
the link.

Peter Relson
z/OS Core Technology Design


Re: z/Architecture Principles of Operation pdf

2021-11-23 Thread Peter Relson
I don't know if this was responded to or not, but the following is likely 
true, but not overly important, because it's not the "expected" way

It can be obtained by going through
https://www-01.ibm.com/servers/resourcelink, however, this requires
an IBM Resourcelink user ID and the pub seems to be in a machine
model specific library (for example, the "z15 Model T01 library").
:

The PoP can be found here: 
http://publibfp.dhe.ibm.com/epubs/pdf/a227832c.pdf
It is within the hardware doc which is where it belongs. It does not 
require a ResourceLink ID to access.
But, yes, it would be nice if there were a link to it from the z/OS doc.

And when a new version is posted, they append to assembler-list, providing 
the link.

Peter Relson
z/OS Core Technology Design


Re: z/Architecture Principles of Operation pdf

2021-11-16 Thread Bob Raicer

I somewhat agree that z/Architecture is not "a feature of z/OS",
however, access to Principles of Operation is mandatory in order to
to write (or even study) assembler code.  Numerous other z/OS pubs
make many references to Principles of Operation.  For example, the
statements shown below extracted from page 65 within "z/OS Version 2
Release 4 MVS Programming:  Extended Addressability Guide"
(SA23-1394-40):

"The purpose of this section is to help you use the 64-bit GPR and
the 64-bit instructions as you want to save registers, perform
arithmetic operations, access data.  It is not a tutorial about how
to use the new instruction set.  Principles of Operation is the
definitive reference book for these instructions."

It appears that IBM is a bit inconsistent about how to obtain the
z/Architecture Principles of Operation.

I thought I would take peek at the z/VM library at:
https://www.vm.ibm.com/library/index.html

Down on the left hand side of the page is an item labeled "z/VM
Related PDFs" which gets you to:

https://www.vm.ibm.com/library/other.html

If you type "Principles" in the "Filter" box on the resultant page
you'll see the download links for SA22-7832-12 (z/Architecture
Principles of Operation) and SA22-7201-08 (Enterprise Systems
Architecture/390 Principles of Operation).  The links work and no
IBM user ID is required.

Also, on the z/VM Indexed PDF page
(https://www.vm.ibm.com/library/pdfzip.html) there is this
statement:

"Note:  Starting with the 2019 April Refresh Collection the z/VM
Related PDFs will no longer be included.  Please see earlier
collections or see the Related PDFs page."

Hopefully the "Related PDFs page" will continue to be available.

To the IBMers:  Any chance on having a similar Related PDFs link
on the z/OS home page?

Bob


Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Farley, Peter x23353
No need for a resource link id - Thanks to Jim Elliot (retired IBMer) most PoOP 
manuals can be retrieved by starting here:

https://jlelliotton.blogspot.com/p/cmos-processor-table.html

HTH

Peter

-Original Message-
From: IBM Mainframe Assembler List  On Behalf 
Of Laddie Hanus
Sent: Monday, November 15, 2021 2:51 PM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

How does one get a resource link id? I contracting at a larger software house 
(not an employee, try to get a full time position in your early 60’s). I’m 
there because I have done assembler for 40 years. Guess I’ll have to stay at 
the z14 level for a while

Laddie Hanus

Sent from whatever device I am using.

> On Nov 14, 2021, at 3:18 PM, Bob Raicer  wrote:
> 
> I am curious to know why z/Architecture Principles of Operation
> (SA22-7832) is not included in the z/OS 2.5 documentation collection 
> (ZOSV2R5-PDFKIT_GA2021.zip), nor is it in the z/OS 2.4 documentation 
> collection (zOSV2R4Library.zip), nor is it in the z/OS 2.3 
> documentation collection (zOSV2R3Library.zip).
> 
> SA22-7832-10 WAS included in the z/OS 2.2 collection (C27843006.zip) 
> and a current-at-the-time version was included in all prior 
> collections (as best as I can tell).
> 
> It can be obtained by going through
> https://urldefense.com/v3/__https://www-01.ibm.com/servers/resourcelin
> k__;!!Ebr-cpPeAnfNniQ8HSAI-g_K5b7VKg!b2f3DVZgLtemzOuGB3S85OEh97GG6xBxN
> WhUNIgzPY2lFpEzawkDKr2s3-T0Bhtg0aSg5Q$ , however, this requires an IBM 
> Resourcelink user ID and the pub seems to be in a machine model specific 
> library (for example, the "z15 Model T01 library").
> 
> Is there some (sensible) reason for this?
> 
> Thanks.
> 
> Bob Raicer

This message and any attachments are intended only for the use of the addressee 
and may contain information that is privileged and confidential. If the reader 
of the message is not the intended recipient or an authorized representative of 
the intended recipient, you are hereby notified that any dissemination of this 
communication is strictly prohibited. If you have received this communication 
in error, please notify us immediately by e-mail and delete the message and any 
attachments from your system.


Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Laddie Hanus
How does one get a resource link id? I contracting at a larger software house 
(not an employee, try to get a full time position in your early 60’s). I’m 
there because I have done assembler for 40 years. Guess I’ll have to stay at 
the z14 level for a while

Laddie Hanus



 

Sent from whatever device I am using.

> On Nov 14, 2021, at 3:18 PM, Bob Raicer  wrote:
> 
> I am curious to know why z/Architecture Principles of Operation
> (SA22-7832) is not included in the z/OS 2.5 documentation collection
> (ZOSV2R5-PDFKIT_GA2021.zip), nor is it in the z/OS 2.4 documentation
> collection (zOSV2R4Library.zip), nor is it in the z/OS 2.3
> documentation collection (zOSV2R3Library.zip).
> 
> SA22-7832-10 WAS included in the z/OS 2.2 collection (C27843006.zip)
> and a current-at-the-time version was included in all prior collections
> (as best as I can tell).
> 
> It can be obtained by going through
> https://www-01.ibm.com/servers/resourcelink, however, this requires
> an IBM Resourcelink user ID and the pub seems to be in a machine
> model specific library (for example, the "z15 Model T01 library").
> 
> Is there some (sensible) reason for this?
> 
> Thanks.
> 
> Bob Raicer


Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Seymour J Metz
There are a lot of things that can be done in DCF/BM/BM BUILD that cannot be 
done in CSS.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Assembler List [ASSEMBLER-LIST@LISTSERV.UGA.EDU] on behalf 
of Ian Worthington [0c9b78d54aea-dmarc-requ...@listserv.uga.edu]
Sent: Monday, November 15, 2021 12:15 PM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

Have you considered running a zPDT system, or getting a cloud system just for 
that?  That's got to be cheaper than sysplex licensing, surely?
> IBM has a free BookMaster to HTML converter, which in theory could be used to 
>convert our system BookMaster documentation to HTML, but in practice it is too 
>buggy. I've tried fixing some of the bugs but get bogged down in trying to 
>figure out what CSS to generate.
What about converting to XML and pushing the formatting issue into the style 
sheet?

Best wishes,

Ian ...

On Monday, November 15, 2021, 11:53:41 AM GMT-5, Schmitt, Michael 
 wrote:

 I miss BookMaster too, because all of my system documentation is written in 
it, and we can't format documentation updates anymore. (The problem is that the 
sysplex licensing for SCRIPT/VS is prohibitively expensive. No SCRIPT means no 
BookMaster.)

I also have a system that creates both printed documentation and ISPF help from 
the same BookMaster source, by replacing the ISPF help engine with its own 
system (for help in the application, not across all ISPF). Now I have to 
maintain the help source by hand.

IBM has a free BookMaster to HTML converter, which in theory could be used to 
convert our system BookMaster documentation to HTML, but in practice it is too 
buggy. I've tried fixing some of the bugs but get bogged down in trying to 
figure out what CSS to generate.

> (though the script underpinnings, not so much)

Agree. SCRIPT/VS macros are the hardest programs I've worked in. The macros 
look like a cat walked across the punctuation keys, and every single character 
is critical.



-Original Message-
From: IBM Mainframe Assembler List  On Behalf 
Of Paul Gilmartin
Sent: Monday, November 15, 2021 10:34 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

On Nov 15, 2021, at 08:38:32, Ian Worthington wrote:
>
> I loved bookmaster back in the day (though the script underpinnings, not so 
> much), never really found an adequate tool to replace it.  Tried lyx for a 
> bit and was finally persuaded to use latex, but it's still not as productive 
> as bm was.
> Anyone know what IBM uses these days?
>
For an arbitrarily selected PDF manual:

543 $ pdfinfo .../ZOS24PDFKIT-1Q21/ZOSV2R4-\!Q2021/Links/z⧸OS\ MVS/z⧸OS\ MVS\ 
JCL\ Reference
Title:  z/OS: z/OS MVS JCL Reference
Creator:AH XSL Formatter V6.6 MR8 for Linux64 : 6.6.10.40521 
(2019-09-24T09:58+09)
Producer:Antenna House PDF Output Library 6.6.1502 (Linux64)
CreationDate:Sun Dec 13 19:29:01 2020 MST
ModDate:Sun Dec 13 19:29:01 2020 MST
Custom Metadata: no
Metadata Stream: no
Tagged:  no
UserProperties:  no
Suspects:no
Form:none
JavaScript:  no
Pages:  760
Encrypted:  no
Page size:  612 x 792 pts (letter)
Page rot:0
File size:  3650343 bytes
Optimized:  yes
PDF version:1.6
544 $

-- gil






Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Seymour J Metz
Well, the Script plumbing allowed you to write a document that you could format 
differently for different contexts and audiences. I found it a great time saver.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Assembler List [ASSEMBLER-LIST@LISTSERV.UGA.EDU] on behalf 
of Ian Worthington [0c9b78d54aea-dmarc-requ...@listserv.uga.edu]
Sent: Monday, November 15, 2021 10:38 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

I loved bookmaster back in the day (though the script underpinnings, not so 
much), never really found an adequate tool to replace it.  Tried lyx for a bit 
and was finally persuaded to use latex, but it's still not as productive as bm 
was.
Anyone know what IBM uses these days?

Best wishes,

Ian ...

On Monday, November 15, 2021, 07:21:08 AM GMT-5, Seymour J Metz 
 wrote:

 Back when IBM used BookMaster and BookManager BUILD (MVS or VM), it was 
trivial to write a manual that could be printed for different envirenments with 
message ids, etc., automatically tailored for the selected environment. I wish 
that they hadn't switched to WYSIAYG.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Assembler List [ASSEMBLER-LIST@LISTSERV.UGA.EDU] on behalf 
of Paul Gilmartin [0014e0e4a59b-dmarc-requ...@listserv.uga.edu]
Sent: Sunday, November 14, 2021 6:02 PM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

On Nov 14, 2021, at 14:52:12, Charles Mills wrote:
>
> Well, not sure it's sensible but "z Architecture" is not a "feature of z/OS."
>
Yes, but still a hyperlink would be useful.

> Yes, yes, of course, not very sensible. z/OS only runs on one type of 
> hardware, and any assembler developer interested in z/OS is interested in how 
> the hardware works.
>
Even less sensible is that SuperC comes with either ISPF or HLASM TK
with separate manuals.  The M differ largely in messages prefixes
and degree of obsolescence.  When I suggested in these lists that
SuperC be made a single dependent FMID, applicable to either product,
with a uniform component prefix, an IBM representative replied that
Would be contrary to Company Policy.


Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Ian Worthington
Have you considered running a zPDT system, or getting a cloud system just for 
that?  That's got to be cheaper than sysplex licensing, surely? 
> IBM has a free BookMaster to HTML converter, which in theory could be used to 
>convert our system BookMaster documentation to HTML, but in practice it is too 
>buggy. I've tried fixing some of the bugs but get bogged down in trying to 
>figure out what CSS to generate.
What about converting to XML and pushing the formatting issue into the style 
sheet?

Best wishes,

Ian ... 

On Monday, November 15, 2021, 11:53:41 AM GMT-5, Schmitt, Michael 
 wrote:  
 
 I miss BookMaster too, because all of my system documentation is written in 
it, and we can't format documentation updates anymore. (The problem is that the 
sysplex licensing for SCRIPT/VS is prohibitively expensive. No SCRIPT means no 
BookMaster.)

I also have a system that creates both printed documentation and ISPF help from 
the same BookMaster source, by replacing the ISPF help engine with its own 
system (for help in the application, not across all ISPF). Now I have to 
maintain the help source by hand.

IBM has a free BookMaster to HTML converter, which in theory could be used to 
convert our system BookMaster documentation to HTML, but in practice it is too 
buggy. I've tried fixing some of the bugs but get bogged down in trying to 
figure out what CSS to generate.

> (though the script underpinnings, not so much)

Agree. SCRIPT/VS macros are the hardest programs I've worked in. The macros 
look like a cat walked across the punctuation keys, and every single character 
is critical.



-Original Message-
From: IBM Mainframe Assembler List  On Behalf 
Of Paul Gilmartin
Sent: Monday, November 15, 2021 10:34 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

On Nov 15, 2021, at 08:38:32, Ian Worthington wrote:
>
> I loved bookmaster back in the day (though the script underpinnings, not so 
> much), never really found an adequate tool to replace it.  Tried lyx for a 
> bit and was finally persuaded to use latex, but it's still not as productive 
> as bm was.
> Anyone know what IBM uses these days?
>
For an arbitrarily selected PDF manual:

543 $ pdfinfo .../ZOS24PDFKIT-1Q21/ZOSV2R4-\!Q2021/Links/z⧸OS\ MVS/z⧸OS\ MVS\ 
JCL\ Reference
Title:          z/OS: z/OS MVS JCL Reference
Creator:        AH XSL Formatter V6.6 MR8 for Linux64 : 6.6.10.40521 
(2019-09-24T09:58+09)
Producer:        Antenna House PDF Output Library 6.6.1502 (Linux64)
CreationDate:    Sun Dec 13 19:29:01 2020 MST
ModDate:        Sun Dec 13 19:29:01 2020 MST
Custom Metadata: no
Metadata Stream: no
Tagged:          no
UserProperties:  no
Suspects:        no
Form:            none
JavaScript:      no
Pages:          760
Encrypted:      no
Page size:      612 x 792 pts (letter)
Page rot:        0
File size:      3650343 bytes
Optimized:      yes
PDF version:    1.6
544 $

-- gil



  


Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Ian Worthington
Thanks, Paul.
XSL-FO, or something very similar, then, by the look of it?
I had a brief liaison with the XML-based tDocBook some years ago which 
initially looked promising and then proved to be more effort than I really 
wanted in a bookie replacement. 
Best wishes,

Ian ... 

On Monday, November 15, 2021, 11:34:14 AM GMT-5, Paul Gilmartin 
<0014e0e4a59b-dmarc-requ...@listserv.uga.edu> wrote:  
 
 On Nov 15, 2021, at 08:38:32, Ian Worthington wrote:
> 
> I loved bookmaster back in the day (though the script underpinnings, not so 
> much), never really found an adequate tool to replace it.  Tried lyx for a 
> bit and was finally persuaded to use latex, but it's still not as productive 
> as bm was.
> Anyone know what IBM uses these days?
>  
For an arbitrarily selected PDF manual:

543 $ pdfinfo .../ZOS24PDFKIT-1Q21/ZOSV2R4-\!Q2021/Links/z⧸OS\ MVS/z⧸OS\ MVS\ 
JCL\ Reference 
Title:          z/OS: z/OS MVS JCL Reference
Creator:        AH XSL Formatter V6.6 MR8 for Linux64 : 6.6.10.40521 
(2019-09-24T09:58+09)
Producer:        Antenna House PDF Output Library 6.6.1502 (Linux64)
CreationDate:    Sun Dec 13 19:29:01 2020 MST
ModDate:        Sun Dec 13 19:29:01 2020 MST
Custom Metadata: no
Metadata Stream: no
Tagged:          no
UserProperties:  no
Suspects:        no
Form:            none
JavaScript:      no
Pages:          760
Encrypted:      no
Page size:      612 x 792 pts (letter)
Page rot:        0
File size:      3650343 bytes
Optimized:      yes
PDF version:    1.6
544 $ 

-- gil
  


Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Schmitt, Michael
I miss BookMaster too, because all of my system documentation is written in it, 
and we can't format documentation updates anymore. (The problem is that the 
sysplex licensing for SCRIPT/VS is prohibitively expensive. No SCRIPT means no 
BookMaster.)

I also have a system that creates both printed documentation and ISPF help from 
the same BookMaster source, by replacing the ISPF help engine with its own 
system (for help in the application, not across all ISPF). Now I have to 
maintain the help source by hand.

IBM has a free BookMaster to HTML converter, which in theory could be used to 
convert our system BookMaster documentation to HTML, but in practice it is too 
buggy. I've tried fixing some of the bugs but get bogged down in trying to 
figure out what CSS to generate.

> (though the script underpinnings, not so much)

Agree. SCRIPT/VS macros are the hardest programs I've worked in. The macros 
look like a cat walked across the punctuation keys, and every single character 
is critical.



-Original Message-
From: IBM Mainframe Assembler List  On Behalf 
Of Paul Gilmartin
Sent: Monday, November 15, 2021 10:34 AM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

On Nov 15, 2021, at 08:38:32, Ian Worthington wrote:
>
> I loved bookmaster back in the day (though the script underpinnings, not so 
> much), never really found an adequate tool to replace it.  Tried lyx for a 
> bit and was finally persuaded to use latex, but it's still not as productive 
> as bm was.
> Anyone know what IBM uses these days?
>
For an arbitrarily selected PDF manual:

543 $ pdfinfo .../ZOS24PDFKIT-1Q21/ZOSV2R4-\!Q2021/Links/z⧸OS\ MVS/z⧸OS\ MVS\ 
JCL\ Reference
Title:   z/OS: z/OS MVS JCL Reference
Creator: AH XSL Formatter V6.6 MR8 for Linux64 : 6.6.10.40521 
(2019-09-24T09:58+09)
Producer:Antenna House PDF Output Library 6.6.1502 (Linux64)
CreationDate:Sun Dec 13 19:29:01 2020 MST
ModDate: Sun Dec 13 19:29:01 2020 MST
Custom Metadata: no
Metadata Stream: no
Tagged:  no
UserProperties:  no
Suspects:no
Form:none
JavaScript:  no
Pages:   760
Encrypted:   no
Page size:   612 x 792 pts (letter)
Page rot:0
File size:   3650343 bytes
Optimized:   yes
PDF version: 1.6
544 $

-- gil





Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Paul Gilmartin
On Nov 15, 2021, at 08:38:32, Ian Worthington wrote:
> 
> I loved bookmaster back in the day (though the script underpinnings, not so 
> much), never really found an adequate tool to replace it.  Tried lyx for a 
> bit and was finally persuaded to use latex, but it's still not as productive 
> as bm was.
> Anyone know what IBM uses these days?
>  
For an arbitrarily selected PDF manual:

543 $ pdfinfo .../ZOS24PDFKIT-1Q21/ZOSV2R4-\!Q2021/Links/z⧸OS\ MVS/z⧸OS\ MVS\ 
JCL\ Reference 
Title:   z/OS: z/OS MVS JCL Reference
Creator: AH XSL Formatter V6.6 MR8 for Linux64 : 6.6.10.40521 
(2019-09-24T09:58+09)
Producer:Antenna House PDF Output Library 6.6.1502 (Linux64)
CreationDate:Sun Dec 13 19:29:01 2020 MST
ModDate: Sun Dec 13 19:29:01 2020 MST
Custom Metadata: no
Metadata Stream: no
Tagged:  no
UserProperties:  no
Suspects:no
Form:none
JavaScript:  no
Pages:   760
Encrypted:   no
Page size:   612 x 792 pts (letter)
Page rot:0
File size:   3650343 bytes
Optimized:   yes
PDF version: 1.6
544 $ 

-- gil


Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Ian Worthington
I loved bookmaster back in the day (though the script underpinnings, not so 
much), never really found an adequate tool to replace it.  Tried lyx for a bit 
and was finally persuaded to use latex, but it's still not as productive as bm 
was.
Anyone know what IBM uses these days?

Best wishes,

Ian ... 

On Monday, November 15, 2021, 07:21:08 AM GMT-5, Seymour J Metz 
 wrote:  
 
 Back when IBM used BookMaster and BookManager BUILD (MVS or VM), it was 
trivial to write a manual that could be printed for different envirenments with 
message ids, etc., automatically tailored for the selected environment. I wish 
that they hadn't switched to WYSIAYG.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Assembler List [ASSEMBLER-LIST@LISTSERV.UGA.EDU] on behalf 
of Paul Gilmartin [0014e0e4a59b-dmarc-requ...@listserv.uga.edu]
Sent: Sunday, November 14, 2021 6:02 PM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

On Nov 14, 2021, at 14:52:12, Charles Mills wrote:
>
> Well, not sure it's sensible but "z Architecture" is not a "feature of z/OS."
>
Yes, but still a hyperlink would be useful.

> Yes, yes, of course, not very sensible. z/OS only runs on one type of 
> hardware, and any assembler developer interested in z/OS is interested in how 
> the hardware works.
>
Even less sensible is that SuperC comes with either ISPF or HLASM TK
with separate manuals.  The M differ largely in messages prefixes
and degree of obsolescence.  When I suggested in these lists that
SuperC be made a single dependent FMID, applicable to either product,
with a uniform component prefix, an IBM representative replied that
Would be contrary to Company Policy.  


Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Seymour J Metz
Back when IBM used BookMaster and BookManager BUILD (MVS or VM), it was trivial 
to write a manual that could be printed for different envirenments with message 
ids, etc., automatically tailored for the selected environment. I wish that 
they hadn't switched to WYSIAYG.


--
Shmuel (Seymour J.) Metz
http://mason.gmu.edu/~smetz3


From: IBM Mainframe Assembler List [ASSEMBLER-LIST@LISTSERV.UGA.EDU] on behalf 
of Paul Gilmartin [0014e0e4a59b-dmarc-requ...@listserv.uga.edu]
Sent: Sunday, November 14, 2021 6:02 PM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: Re: z/Architecture Principles of Operation pdf

On Nov 14, 2021, at 14:52:12, Charles Mills wrote:
>
> Well, not sure it's sensible but "z Architecture" is not a "feature of z/OS."
>
Yes, but still a hyperlink would be useful.

> Yes, yes, of course, not very sensible. z/OS only runs on one type of 
> hardware, and any assembler developer interested in z/OS is interested in how 
> the hardware works.
>
Even less sensible is that SuperC comes with either ISPF or HLASM TK
with separate manuals.  The M differ largely in messages prefixes
and degree of obsolescence.  When I suggested in these lists that
SuperC be made a single dependent FMID, applicable to either product,
with a uniform component prefix, an IBM representative replied that
Would be contrary to Company Policy.

Re: z/Architecture Principles of Operation pdf

2021-11-15 Thread Jonathan Scott
Ref:  Your note of Sun, 14 Nov 2021 16:02:43 -0700

gil writes:
> Even less sensible is that SuperC comes with either ISPF or HLASM TK
> with separate manuals.  The M differ largely in messages prefixes
> and degree of obsolescence.  When I suggested in these lists that
> SuperC be made a single dependent FMID, applicable to either product,
> with a uniform component prefix, an IBM representative replied that
> Would be contrary to Company Policy.

SuperC is maintained as part of the HLASM Toolkit using common
source (including some conditional compilation) for MVS, VM and
VSE, as for the rest of the Toolkit.  The Toolkit version of the
documentation applies to all three platforms.

ISPF on MVS includes a copy of the current level of ASMFSUPC as
ISRSUPC, and also has its own front-end logic which provides
some ease-of-use support for search and compare processing.
The documentation is based on the Toolkit documentation but has
been modified to reflect that it is only for MVS and to focus
on use from ISPF.

When SuperC detects that it has been called by the name ISRSUPC,
it uses the ISPF conventions for headings and messages.
Whenever there is an APAR fix to the Toolkit version, the MVS
PTF version of the changed object modules is sent to ISPF to
repackage into an ISPF APAR and PTF.

This situation has arisen for historical reasons and does lead
to a few minor inconveniences for IBM, in that for example we
have to maintain two versions of the documentation and have to
convert every Toolkit SuperC fix into an ISPF SuperC Fix as
well.  However, the current scheme conforms to the standard IBM
rules for shipping code and fixes, but any attempt to common
up the copies would cause compatibility problems, for example by
violating the unique component prefix rules for one copy or the
other.

Jonathan Scott, HLASM
IBM Hursley, UK


Re: z/Architecture Principles of Operation pdf

2021-11-14 Thread Paul Gilmartin
On Nov 14, 2021, at 14:52:12, Charles Mills wrote:
> 
> Well, not sure it's sensible but "z Architecture" is not a "feature of z/OS."
>  
Yes, but still a hyperlink would be useful.

> Yes, yes, of course, not very sensible. z/OS only runs on one type of 
> hardware, and any assembler developer interested in z/OS is interested in how 
> the hardware works.
> 
Even less sensible is that SuperC comes with either ISPF or HLASM TK
with separate manuals.  The M differ largely in messages prefixes
and degree of obsolescence.  When I suggested in these lists that
SuperC be made a single dependent FMID, applicable to either product,
with a uniform component prefix, an IBM representative replied that
Would be contrary to Company Policy.

> -Original Message-
> From: IBM Mainframe Assembler List [mailto:ASSEMBLER-LIST@LISTSERV.UGA.EDU] 
> On Behalf Of Bob Raicer
> Sent: Sunday, November 14, 2021 1:18 PM
> 
> I am curious to know why z/Architecture Principles of Operation
> (SA22-7832) is not included in the z/OS 2.5 documentation collection
> (ZOSV2R5-PDFKIT_GA2021.zip), nor is it in the z/OS 2.4 documentation
> collection (zOSV2R4Library.zip), nor is it in the z/OS 2.3
> documentation collection (zOSV2R3Library.zip).
> 
> SA22-7832-10 WAS included in the z/OS 2.2 collection (C27843006.zip)
> and a current-at-the-time version was included in all prior collections
> (as best as I can tell).
> 
> It can be obtained by going through
> https://www-01.ibm.com/servers/resourcelink, however, this requires
> an IBM Resourcelink user ID and the pub seems to be in a machine
> model specific library (for example, the "z15 Model T01 library").
> 
> Is there some (sensible) reason for this?

-- gil


Re: z/Architecture Principles of Operation pdf

2021-11-14 Thread Charles Mills
Well, not sure it's sensible but "z Architecture" is not a "feature of z/OS."

Yes, yes, of course, not very sensible. z/OS only runs on one type of hardware, 
and any assembler developer interested in z/OS is interested in how the 
hardware works.

Charles


-Original Message-
From: IBM Mainframe Assembler List [mailto:ASSEMBLER-LIST@LISTSERV.UGA.EDU] On 
Behalf Of Bob Raicer
Sent: Sunday, November 14, 2021 1:18 PM
To: ASSEMBLER-LIST@LISTSERV.UGA.EDU
Subject: z/Architecture Principles of Operation pdf

I am curious to know why z/Architecture Principles of Operation
(SA22-7832) is not included in the z/OS 2.5 documentation collection
(ZOSV2R5-PDFKIT_GA2021.zip), nor is it in the z/OS 2.4 documentation
collection (zOSV2R4Library.zip), nor is it in the z/OS 2.3
documentation collection (zOSV2R3Library.zip).

SA22-7832-10 WAS included in the z/OS 2.2 collection (C27843006.zip)
and a current-at-the-time version was included in all prior collections
(as best as I can tell).

It can be obtained by going through
https://www-01.ibm.com/servers/resourcelink, however, this requires
an IBM Resourcelink user ID and the pub seems to be in a machine
model specific library (for example, the "z15 Model T01 library").

Is there some (sensible) reason for this?

Thanks.

Bob Raicer


z/Architecture Principles of Operation pdf

2021-11-14 Thread Bob Raicer

I am curious to know why z/Architecture Principles of Operation
(SA22-7832) is not included in the z/OS 2.5 documentation collection
(ZOSV2R5-PDFKIT_GA2021.zip), nor is it in the z/OS 2.4 documentation
collection (zOSV2R4Library.zip), nor is it in the z/OS 2.3
documentation collection (zOSV2R3Library.zip).

SA22-7832-10 WAS included in the z/OS 2.2 collection (C27843006.zip)
and a current-at-the-time version was included in all prior collections
(as best as I can tell).

It can be obtained by going through
https://www-01.ibm.com/servers/resourcelink, however, this requires
an IBM Resourcelink user ID and the pub seems to be in a machine
model specific library (for example, the "z15 Model T01 library").

Is there some (sensible) reason for this?

Thanks.

Bob Raicer