Peter, the issue is moot because -- and I assume you saw my other post -- the code is now all working.
Secondly, I am only responding because you asked: my intention is NOT to turn this thread into one of those "how dare you say one bad word about IBM documentation; MS is MUCH worse" flame rants. I'm taking time out of a busy day in an attempt to help you make IBM documentation better. My confusion was twofold: First, as you correctly infer, I was a little fuzzy on the precise definition of major name. I recalled the general idea, but the specific definition was not at the front of my brain. (Note I am not alone; someone posted asking if CSVQUERY would return the CSECT name associated with an assembler ENTRY statement.) It came back to me as I worked, and you could argue that someone has no business using CSVQUERY if they do not know the exact definition of major name, but the fact is I work in a lot of areas and the precise relationship of member names and alias names was not at the top of my stack. It is obvious from the terms that major name is the "big deal name" and minor names are "child names," but I had forgotten that the major name was specifically the member name, and not for example some name assigned by the binder that would stick with the loadmodule even if the member were renamed. My specific concern that led to this query was because I read the statement "When you specify OUTEPNM with INADDR, CSVQUERY returns the module's major entry point name in entryname." The ABSENCE then of a specific statement "When you specify OUTMJNM with INEPNAME, CSVQUERY returns the module's major entry point name in entryname" caused me concern that perhaps I was falling into that programmer trap of assuming the OS function did what you wished it did, rather than what it was documented as doing. In addition, the CSVQUERY documentation suffers horribly from the lack of a single example, or any significant discussion in the A/S Guide. In the Reference, the description of the specific parameters is pretty good but there is very little big picture. The doc does a good job of saying "you must specify one and only one of these inputs" but fails to say explicitly "you may specify any one or more of these outputs (except that X and Y are mutually exclusive" and "the following parameters (SEARCHMINOR, etc.) OTOH modify CSVQUERY's behavior with regard to the above inputs and outputs." What little overview there is is not helped by the following statement, which is IMHO wrong at worst and not very helpful or misleading at best: "CSVQUERY returns information for the following types of entry points: ... Minor entry points specified on a LOAD, LINK(X), ATTACH(X), or XCTL(X) invocation the system is processing while CSVQUERY is running." Thanks for listening, thanks for z/OS, and thanks for your help over the years. Charles -----Original Message----- From: IBM Mainframe Discussion List [mailto:[email protected]] On Behalf Of Peter Relson Sent: Thursday, December 06, 2012 4:38 AM To: [email protected] Subject: Re: Specific CSVQUERY question >CSVQUERY INEPNAME=INNAME,SEARCH=JPALPA,OUTMJNM=OUTNAME What is not clear about OUTMJNM being (from the CSVQUERY macro) the "the major (member) name" or (from the book) "the major name (which is not an alias name) of the module"? If the confusion lies with "what is a major name", then I can understand, a bit. I think the macro description is a bit more to the point. To contents supervision, the "major name" is the member name, and aliases are "minor names". If you use ISPF member list, you've undoubtedly seen the "Alias-of" column. The "Alias-of" information identifies the major name (member name) associated with that alis (minor name) Regarding CSVINFO vs CSVQUERY: CSVQUERY is a far better interface to use than CSVINFO if you are trying to find information about a specific thing. CSVINFO is for use if you are interested in information about lots of things (such as all modules on the job pack queue). ---------------------------------------------------------------------- For IBM-MAIN subscribe / signoff / archive access instructions, send email to [email protected] with the message: INFO IBM-MAIN
