开云体育

Updated Help


 

开云体育

Folks,

?

? I have attempted to clean up the GCC help files and to that end have uploaded some modified files to the groups file section.

?

/g/h390-vm/files/Help%20File%20Updates

?

there are two copies, one as a zip archive of ASCII files, the other as a VMFPLC2 AWS tape. If you would like to have a look and let me know what you think.

?

Dave

?


 

On Wed, Dec 15, 2021 at 03:52 PM, Dave Wade wrote:
there are two copies, one as a zip archive of ASCII files, the other as a VMFPLC2 AWS tape. If you would like to have a look and let me know what you think.
I downloaded the help.aws, then uploaded it to my VM system. I found the reference to GCCLIB, but I'm not finding a reference to PDPCLIB in the following.

FSVIEW GCC HELPCMD2 F
...
3.? The source code for the GCC compiler and runtime libraries is on the

??? GCCCMS userid disks.
?
4.? An alternate runtime library called GCCLIB is available for C programs.
??? This runtime library lets you code C programs that directly access CMS
??? system services.? Type HELP GCCLIB for more information.
?
Ready; T=0.01/0.02 02:06:54

Confused.
?... Mark S.


 

开云体育

Mark,

Thanks for looking. Why are you confused. It’s a draft so it will have inconsistencies. GCC HELPCMD points to the help for both libraries.

?

LIB fn?? specifies the runtime library with which the program is to be????????????

?????????compiled.? GCC will link and access the appropriate disk containing??????

?????????the C header files.? Two runtime libraries are available:????????????????

???????????????????????????????????????????????????????????????????????????????????

?????????GCCLIB? uses only "native" CMS functions for system services.? Using?????

?????????????????this library it is possible to write programs that may be????????

?????????????????loaded into resident memory as extensions of the CMS nucleus.????

???????????????????????????????????????????????????????????????????????????????????

?????????????????Ensure GCCLIB is in your list of GLOBAL TXTLIBs to run your??????

?????????????????compiled progam.? Type HELP GCCLIB for more information.?????????

???????????????????????????????????????????????????????????????????????????????????

?????????PDPCLIB uses simulated OS functions for system services.?????????????????

???????????????????????????????????????????????????????????????????????????????????

?????????????????Ensure PDPCLIB is in your list of GLOBAL TXTLIBs to run your?????

?????????????????compiled progam. Type "HELP PDPCLIB" for more information.???????

?

Not really sure how to deal with this.? FSHELP combines both “HELP GCC” and “HELP GCC(MORE” so sometimes you get two references.

驰耻办…

?

Dave

?

?

From: [email protected] <[email protected]> On Behalf Of Mark A. Stevens via groups.io
Sent: 16 December 2021 02:15
To: [email protected]
Subject: Re: [h390-vm] Updated Help

?

On Wed, Dec 15, 2021 at 03:52 PM, Dave Wade wrote:

there are two copies, one as a zip archive of ASCII files, the other as a VMFPLC2 AWS tape. If you would like to have a look and let me know what you think.

I downloaded the help.aws, then uploaded it to my VM system. I found the reference to GCCLIB, but I'm not finding a reference to PDPCLIB in the following.

FSVIEW GCC HELPCMD2 F
...
3.? The source code for the GCC compiler and runtime libraries is on the

??? GCCCMS userid disks.
?
4.? An alternate runtime library called GCCLIB is available for C programs.
??? This runtime library lets you code C programs that directly access CMS
??? system services.? Type HELP GCCLIB for more information.
?
Ready; T=0.01/0.02 02:06:54

Confused.
?... Mark S.


 

On Thu, Dec 16, 2021 at 03:39 AM, Dave Wade wrote:
Thanks for looking. Why are you confused. It’s a draft so it will have inconsistencies. GCC HELPCMD points to the help for both libraries.
Thank you for putting this together.

I've had more coffee, so maybe I'll be better at explaining. Neither GCC HELPCMD, nor GCC HELPCMD2 point to HELP PDPCLIB, as in does Note 4. I would suggest adding a Note 5 to do that.


Another thing I noticed. and this might be because I've lived in *nix-land and IBM-land too long. In GCCLIB HELPCMD, under Notes: my two cents, less taxes; would be to indicate that a NULL is equivalent to x'00', just so people don't confuse it with void.

????? 7.? When writing a fixed-length binary file the buffer will be padded
????????? with NULLs if needed.

?... Mark S.


 

开云体育

I have done minor updates to the recent files and created a few more help files for the likes of BASIC, COBOL, FORTRAN, PL360, PLC and PLI

I also intend to add the manual for PL360. The are in the folder below as “helpfiles.aws” (vmfplc2) and “helpfiles.zip” (ascii zip)

If any one does read them can they let me know about typos etc.

?

Dave.

?

From: dave.g4ugm@... <dave.g4ugm@...>
Sent: 15 December 2021 21:53
To: [email protected]
Subject: Updated Help

?

Folks,

?

? I have attempted to clean up the GCC help files and to that end have uploaded some modified files to the groups file section.

?

/g/h390-vm/files/Help%20File%20Updates

?

there are two copies, one as a zip archive of ASCII files, the other as a VMFPLC2 AWS tape. If you would like to have a look and let me know what you think.

?

Dave

?


 

On Sun, Dec 19, 2021 at 05:01:23PM -0000, Dave Wade wrote:
I have done minor updates to the recent files and created a few more help
files for the likes of BASIC, COBOL, FORTRAN, PL360, PLC and PLI
Dave,

I have done a quick skim through your nice work, and have a couple of
nits for you.

In cobol.helpcommand: "downloadedfrom".

In fortran.helpcommand: "Then use the load and start to run the
programs." Perhaps "Then use the load and start commands ..." ??

Under "filename," "it must haveh fixed".

"NOPRint - Do not write a lising file."




I will make some more time later in the month to further peruse these
files. It's been a LONG time since I thought of PL/360!



Brian


 

Brian,
Thanks. Proofreading your own work is so hard and I really appreciate you
input. I am collecting errors and it will possibly be post-Christmas when I
fix them, but I will.
Dave

-----Original Message-----
From: [email protected] <[email protected]> On Behalf Of Brian
McCullough
Sent: 20 December 2021 18:06
To: [email protected]
Subject: Re: [h390-vm] Updated Help

On Sun, Dec 19, 2021 at 05:01:23PM -0000, Dave Wade wrote:
I have done minor updates to the recent files and created a few more
help files for the likes of BASIC, COBOL, FORTRAN, PL360, PLC and PLI
Dave,

I have done a quick skim through your nice work, and have a couple of nits
for you.

In cobol.helpcommand: "downloadedfrom".

In fortran.helpcommand: "Then use the load and start to run the programs."
Perhaps "Then use the load and start commands ..." ??

Under "filename," "it must haveh fixed".

"NOPRint - Do not write a lising file."




I will make some more time later in the month to further peruse these
files.
It's been a LONG time since I thought of PL/360!



Brian





 

On Mon, Dec 20, 2021 at 06:27:06PM -0000, Dave Wade wrote:
Brian,
Hi Dave,


Thanks. Proofreading your own work is so hard and I really appreciate you
input.
I know that too well.

Even e-mail messages, where I think that I am paying attention, have
errors appear after I have sent them!


I am collecting errors and it will possibly be post-Christmas when I
fix them, but I will.
No rush. These are a big help already.



Dave

Brian


 

On Wed, Dec 15, 2021 at 03:52 PM, Dave Wade wrote:

I have attempted to clean up the GCC help files and to that end have uploaded some modified files to the groups file section.

?

/g/h390-vm/files/Help%20File%20Updates

?

there are two copies, one as a zip archive of ASCII files, the other as a VMFPLC2 AWS tape. If you would like to have a look and let me know what you think.

I have read the GCC help files, and uploaded the suggested changes and the files updated with those changes.

[xmas@vm370dev tapes]$ vmfplc2 scan 2022-01-06.GCC.HELP.UPDATE.het
HHC02499I Hercules utility vmfplc2 - VM/CMS VMFPLC2/TAPE Utility - version 4.4.9999.0-SDL
HHC01414I (C) Copyright 1999-2021 by Roger Bowler, Jan Jaeger, and others
HHC01417I ** The SoftDevLabs version of Hercules **
HHC01415I Build date: Mar? 5 2021 at 16:26:42
HHC02637I Input tape format set to VMFPLC2
HHC02625I SCANNING...
HHC02626I >>> GCC????? HELPCMD? A1 V 79??? 1922-01-06 11:24:00 recs?? 82 blks 9
HHC02626I >>> GCC????? HELPCMD2 A1 V 76??? 1922-01-06 11:30:00 recs?? 52 blks 5
HHC02626I >>> GCCLIB?? HELPCMD? A1 V 79??? 1922-01-06 11:41:00 recs? 177 blks 18
HHC02626I >>> GCCHELP? UPDATES? A1 V 80??? 1922-01-06 11:49:00 recs?? 53 blks 6
HHC02633I???? @TM
HHC02633I???? @TM
HHC02631I SCAN complete
[xmas@vm370dev tapes]$

I can't seem to build an AWS tape file, but I can build an HET tape file. I only modified the VM files. If you want me to update the ASCII files, please let me know.
/g/h390-vm/files/Help%20File%20Updates/2022-01-06.GCC.HELP.UPDATE.het

?... Mark S.


 

Mark A. Stevens wrote:

[...]
I can't seem to build an AWS tape file,
but I can build an HET tape file.
Eh? Why not?

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

mail: fish@...


 

Mark A. Stevens wrote:

[...]
I have read the GCC help files, and uploaded the suggested
changes and the files updated with those changes.
[...]
HHC02637I Input tape format set to VMFPLC2
HHC02625I SCANNING...
<snip>

FYI: Since the tape you are creating is meant for VM/370 and not z/VM (true? yes?), you might want to create it in DUMP format instead. As far as I know, VM/370 cannot read VMFPLC2 formatted tapes. Refer to the -t option for more information.

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

mail: fish@...


 

-----Original Message-----
From: [email protected] <[email protected]> On Behalf Of Fish Fish
Sent: 06 January 2022 23:00
To: [email protected]
Subject: Re: [h390-vm] Updated Help

Mark A. Stevens wrote:

[...]
I have read the GCC help files, and uploaded the suggested changes and
the files updated with those changes.
[...]
HHC02637I Input tape format set to VMFPLC2 HHC02625I SCANNING...
<snip>

FYI: Since the tape you are creating is meant for VM/370 and not z/VM (true?
yes?), you might want to create it in DUMP format instead. As far as I know,
VM/370 cannot read VMFPLC2 formatted tapes. Refer to the -t option for
more information.
Oh yes it can...


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

mail: fish@...


 

Dave Wade wrote:
Fish wrote:
[...]
As far as I know, VM/370 cannot read VMFPLC2 formatted tapes. [...]
Oh yes it can...
Wow! Really? I didn't know that. COOL! Thanks! :)

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

mail: fish@...


 

On Thu, Jan 6, 2022 at 04:59 PM, Fish Fish wrote:
FYI: Since the tape you are creating is meant for VM/370 and not z/VM (true? yes?), you might want to create it in DUMP format instead. As far as I know, VM/370 cannot read VMFPLC2 formatted tapes. Refer to the -t option for more information.
The output from the earlier message, is from the vmfplc2 program on my Linux system,

[xmas@vm370dev tapes]$ vmfplc2 scan 2022-01-06.GCC.HELP.UPDATE.het

?it is reading the tape file created by VMFPLC2 on my VM/370 CE system.

?... Mark S.


 

On Thu, Jan 6, 2022 at 04:51 PM, Fish Fish wrote:
I can't seem to build an AWS tape file,
but I can build an HET tape file.
Eh? Why not?
I am not real sure. I need to play with DEVINIT and creating .aws and .het? files.? It seems that a new .aws file is created, then writing data to the .aws, rewinding and scanning it, there is nothing there, while similar commands using a .het file, this is not a problem. I need to ensure I am following the same procedure, and getting the necessary log files.

Most likely, the problem is me.

?... Mark S.


 

Mark A. Stevens wrote:
Fish wrote:

FYI: Since the tape you are creating is meant for VM/370
and not z/VM (true? yes?), you might want to create it in
DUMP format instead. As far as I know, VM/370 cannot read
VMFPLC2 formatted tapes. Refer to the -t option for more
information.
The output from the earlier message, is from the vmfplc2 program
on my Linux system,
[...]
it is reading the tape file created by VMFPLC2 on my VM/370 CE
system.
Yeah, Dave already indirectly informed me that VM/370 CE apparently now supports VMFPLC2 too. I wasn't aware of that. I guess I'm behind the times. Sorry.

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

mail: fish@...


 

Mark A. Stevens wrote:
Fish wrote:
Mark A. Stevens wrote:
I can't seem to build an AWS tape file,
but I can build an HET tape file.
Eh? Why not?
I am not real sure. I need to play with DEVINIT and creating
.aws and .het files. It seems that a new .aws file is created,
then writing data to the .aws, rewinding and scanning it,
there is nothing there, while similar commands using a .het file,
this is not a problem. I need to ensure I am following the
same procedure, and getting the necessary log files.
How was the tape file that you're DEVINIT'ing created? Because if you just did a default "hetinit" to create it (without the -d option), the default is to create it in compressed .het file format, *regardless* of whatever file extension you may have specified for the output file. That is to say, when you do:

hetinit fishtest.aws 000001

The file "fishtest.aws" that ends up being created is ACTUALLY a compressed ".het" format tape file, *not* an uncompressed .aws format tape file. (The format that the tape file is created in is NOT determined by the file extension that is specified in your output filename. It is determined by whether the -d option is specified or not.)

To create a regular uncompressed .aws format tape file, you need to specify the -d option:

hetinit -d fishtest.aws 000001

And of course you can also do:

hetinit -d fishtest.het 000001

to cause even more confusion, since file "fishtest.het" will end up being created in uncompressed .aws file format!

Just like dasdinit can create regular uncompressed CKD dasd image files as well as compressed CCKD dasd image files (each of which you can give whatever the heck illogical/confusing output filename.extension you want to give to them), the same is true of hetinit too.

So you need to be careful how you create your tape files. Whatever format they're created in, that's the format they STAY in.

I don't know why your writing to a (presumably) .aws format tape file fails to write anything. That is very weird. Unless maybe it has to do with the vmfplc2 program you are using on VM/370 CE? Maybe is has a bug? <shrug>

Because there is no rhyme or reason why Hercules would refuse to honor a guest's request to write data to a mounted .aws format tape file but allow doing so to a .het format tape file. That doesn't make any sense at all!

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

mail: fish@...


 

-----Original Message-----
From: [email protected] <[email protected]> On Behalf Of Fish Fish
Sent: 07 January 2022 03:03
To: [email protected]
Subject: Re: [h390-vm] Updated Help

Mark A. Stevens wrote:
Fish wrote:

FYI: Since the tape you are creating is meant for VM/370 and not
z/VM (true? yes?), you might want to create it in DUMP format
instead. As far as I know, VM/370 cannot read
VMFPLC2 formatted tapes. Refer to the -t option for more
information.
The output from the earlier message, is from the vmfplc2 program on my
Linux system,
[...]
it is reading the tape file created by VMFPLC2 on my VM/370 CE
system.
Yeah, Dave already indirectly informed me that VM/370 CE apparently now
supports VMFPLC2 too. I wasn't aware of that. I guess I'm behind the times.
Sorry.
The n-pack released by Bob Abeles has always had a VMFPLC2 but it doesn't always play well with very recent versions.
It does seem to work fine with the VMFPLC2 included with Hercules.



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

mail: fish@...
Dave


 

On Sun, Dec 19, 2021 at 11:01 AM, Dave Wade wrote:

I have done minor updates to the recent files and created a few more help files for the likes of BASIC, COBOL, FORTRAN, PL360, PLC and PLI

I also intend to add the manual for PL360. The are in the folder below as “helpfiles.aws” (vmfplc2) and “helpfiles.zip” (ascii zip)

If any one does read them can they let me know about typos etc.

Dave, I reviewed all but the GCC related help files, making changes to try to make them all more like VM/370 help files.
/g/h390-vm/files/Help%20File%20Updates/2022-01-07.HELP.FILES.UPDATED.het

vmfplc2 rew

Ready; T=0.01/0.01 20:52:32
vmfplc2 scan
?SCANNING....
?HELP???? UPDATES? A1
?WATFIV?? HELPCMD? A1
?BASIC??? HELPCMD? A1
?COBOL??? HELPCMD? A1
?EXECUTIL HELPCMD? A1
?FORTH??? HELPCMD? A1
?FORTRAN? HELPCMD? A1
?FORTRANG HELPCMD? A1
?FORTRANH HELPCMD? A1
?PASCAL?? HELPCMD? A1
?PASCOMP? HELPCMD? A1
?PASC370? HELPCMD? A1
?PASLINK? HELPCMD? A1
?PLCT???? HELPCMD? A1
?PLI????? HELPCMD? A1
?PL360??? HELPCMD? A1
?END-OF-FILE OR END-OF-TAPE
Ready; T=0.01/0.01 20:52:36

HELP UPDATES is XCOMPARE output from your version to mine.

I Hope This Helps.

?... Mark S.



 

开云体育

Thanks Mark

I’ll have a look at these. Perhaps we should store them in GITHUB then we could see and review changes..

Dave

?

From: [email protected] <[email protected]> On Behalf Of Mark A. Stevens via groups.io
Sent: 08 January 2022 03:05
To: [email protected]
Subject: Re: [h390-vm] Updated Help

?

On Sun, Dec 19, 2021 at 11:01 AM, Dave Wade wrote:

I have done minor updates to the recent files and created a few more help files for the likes of BASIC, COBOL, FORTRAN, PL360, PLC and PLI

I also intend to add the manual for PL360. The are in the folder below as “helpfiles.aws” (vmfplc2) and “helpfiles.zip” (ascii zip)

If any one does read them can they let me know about typos etc.

Dave, I reviewed all but the GCC related help files, making changes to try to make them all more like VM/370 help files.
/g/h390-vm/files/Help%20File%20Updates/2022-01-07.HELP.FILES.UPDATED.het

vmfplc2 rew

Ready; T=0.01/0.01 20:52:32
vmfplc2 scan
?SCANNING....
?HELP???? UPDATES? A1
?WATFIV?? HELPCMD? A1
?BASIC??? HELPCMD? A1
?COBOL??? HELPCMD? A1
?EXECUTIL HELPCMD? A1
?FORTH??? HELPCMD? A1
?FORTRAN? HELPCMD? A1
?FORTRANG HELPCMD? A1
?FORTRANH HELPCMD? A1
?PASCAL?? HELPCMD? A1
?PASCOMP? HELPCMD? A1
?PASC370? HELPCMD? A1
?PASLINK? HELPCMD? A1
?PLCT???? HELPCMD? A1
?PLI????? HELPCMD? A1
?PL360??? HELPCMD? A1
?END-OF-FILE OR END-OF-TAPE
Ready; T=0.01/0.01 20:52:36

HELP UPDATES is XCOMPARE output from your version to mine.

I Hope This Helps.

?... Mark S.