Re: AW: What is subsystem function code No. 39 and what does it do?

2017-01-12 Thread Tony Harminc
On 12 January 2017 at 04:10, Giliad Wilf
<00d50942efa9-dmarc-requ...@listserv.ua.edu> wrote:
> This macro only describes a layout of an extension to the SSOB for the 
> service requested.
> Yet, the "Using the Subsystem Interface" manual neither lists this function 
> with services you can request, nor does it list it with services you can 
> provide when writing your own subsystem.

This topic has come up a good handful of times on this list over the
last 20 years or so, and searching the archives will pay off.

Copies of GG66-3131 seem to be rarer than hen's teeth, but a few
people have one. (I don't.)

There is some closely related though fairly high-level doc in the
description of the Log Stream Subsystem Exit IXGSEXIT in the MVS
Installation Exits, currently SA23-1381-02. Unfortunately IBM does not
seem to provide source code for the default exit.

And Howard Gilbert's GPSAM in CBT file 290 from 1982(!), though it
implements only the Open and Close calls, should still work on current
systems with little or no modification. Its doc and code make
excellent reading even if you don't use the program itself.

This is just another thing that IBM has effectively de-documented over
the years. There used to be a manual OS/VS2 TSO Guide to Writing a
Terminal Monitor Program or a Command Processor, GC28-0648, and a
later XA edition, MVS/XA TSO Guide to Writing a Terminal Monitor
Program or a Command Processor, GC28-1295, that explained in detail
how to write a TMP. That was decommitted in the early ESA era, when
the TMP and the knowledge needed to write one went OCO. Similarly the
subsytem interface, once documented, has not been completely so for
many years.

The Using the Subsystem Interface book has for a long time not
documented even those very well known function codes like Open, Close,
Allocate; indeed it appears it is not possible to write your own JES
using this book alone.

This is the way we live.

Tony H.

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN


AW: What is subsystem function code No. 39 and what does it do?

2017-01-12 Thread Peter Hunkeler
>Is there any discussion per function code No. 39 somewhere?



>From an old "orange book" titles "The Subsystem Interface in MVS/SP Version 3" 
>(GG66-3131-00):


Function codes 7, 16, 17, 18, 19, 38, and 39 are the codes to build a subsystem 
that supports the SUBSYS= keyword in DD allocations. At conversion time, 
function 38 (Converter) is called once for each DD to verify the parameters on 
the SUBSYS= keyword. At step initiation, function 39 (Allocation Group) is 
called once for all DDs in the step specifying this subsystem on the SUBSYS= 
keyword. Functions 16 and 17 are the OPEN and CLOSE routines, resp. Function 7 
(Unallocation) is called once for each DD statement at unallocation. Functions 
18 and 19 support Checkpoint and Restart, resp.


I don't know where writing your own subsystem to suppport SUBSYS= allocations 
is documented these days. It is not in the z/OS MVS Using the Subsystem 
Interface manual for whatever reason.


--
Peter Hunkeler


--
Peter Hunkeler

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN


Re: AW: What is subsystem function code No. 39 and what does it do?

2017-01-12 Thread Giliad Wilf
On Wed, 11 Jan 2017 11:05:35 +0100, Roland Schiradin  
wrote:

>SYS1.MODGEN(IEFSSAG) is the related macro for this function code. HTH 
>

Thank you. 
This macro only describes a layout of an extension to the SSOB for the service 
requested.
Yet, the "Using the Subsystem Interface" manual neither lists this function 
with services you can request, nor does it list it with services you can 
provide when writing your own subsystem.
   
Is there any discussion per function code No. 39 somewhere?

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN


AW: What is subsystem function code No. 39 and what does it do?

2017-01-11 Thread Roland Schiradin
SYS1.MODGEN(IEFSSAG) is the related macro for this function code. HTH 

-Ursprüngliche Nachricht-
Von: IBM Mainframe Discussion List [mailto:IBM-MAIN@LISTSERV.UA.EDU] Im Auftrag 
von Giliad Wilf
Gesendet: Mittwoch, 11. Januar 2017 10:16
An: IBM-MAIN@LISTSERV.UA.EDU
Betreff: What is subsystem function code No. 39 and what does it do?

It is being described as "Alloc group subsystem requests", but the "Using the 
Subsystem Interface" manual, SA38-0679, does not say a word about it.

--
For IBM-MAIN subscribe / signoff / archive access instructions, send email to 
lists...@listserv.ua.edu with the message: INFO IBM-MAIN

--
For IBM-MAIN subscribe / signoff / archive access instructions,
send email to lists...@listserv.ua.edu with the message: INFO IBM-MAIN