Article View: bit.listserv.asm370
Article #291Re: Assembly coding guidelines (SMP/E packaging)
From: David Cole
Date: Sun, 04 Sep 2005 14:39
Date: Sun, 04 Sep 2005 14:39
88 lines
5755 bytes
5755 bytes
>AKornelis wrote:
>>You also mentioned SMP/E packaging. As far as I know there are no
>>coding standards at the assembler or macro source level for
>>packaging. I would mainly say to avoid collisions of names for
>>modules or macros. [snip]
>
>CCraddock wrote:
>You're correct that the main consideration is naming. You cannot
>have two elements with the same name in the same zone.
>
>The main way to avoid this is to select a three letter acronym (TLA)
>prefix for the elements you plan to distribute and then use that as
>the first three characters of each element (member) name. IBM
>provides a service for vendors to register product TLAs, which means
>you can be fairly sure your names won't collide with other vendors
>names - and can therefore be installed in the same zone.
With z/XDC, I take a different approach (to the names conflict
problem) that allows me to disregard having to use a unique "TLA".
One of the main purposes of SMP/E is to maintain an inventory of all
of a product's elements, and then use that inventory information to
manage the application of updates and fixes. I find this to be very beneficial.
Another major purpose of SMP/E is to manage the resolution of system
release dependencies at product installation time, such that
different elements are installed depending upon the system (and
product) release level.
Well, z/XDC development takes the approach of resolving system
dependencies at execution time, not at installation time. A major
benefit of this is that there remains little reason for XDC to be
managed by the same SMP/E that manages the MVS system.
Consequently:
- Because I do find SMP/E inventory management capabilities
to be of significant benefit for maintenance management,
I do distribute z/XDC with SMP/E packaging.
- On the other hand, because I do NOT need SMP/E to manage
dependencies between z/XDC and MVS, I require my customers
to create a *private* set of z/XDC SMP/E control libraries
(CSI etc.), entirely separate from their other SMP/E
libraries.
For me (and my customers), the benefits are significant:
- First, I don't need to worry about name conflicts.
Example, part of the z/XDC distribution includes a MACLIB
containing 194 macros having names that are mnemonically
meaningful. I would not want to have to burn 3 of a name's
available 8 characters to use as a "TLA".
- Second, I can impose my own SMP/E definition conventions
upon the installation process without concern for
conflicting with IBM's or someone else's conventions.
(Examples:
- Making RC=4 (instead of =0) from IEBCOPY and
AMASPZAP the highest acceptable completion code.
- Defining a default PARM for assemblies that is
specifically suitable for z/XDC assemblies.
- Defining PARM=IGNIDRFULL as the default for AMASPZAP.
(This, and permitting RC=4, are particularly important
to me because most of z/XDC's maintenance is
distributed as zaps.)
etc.)
Doing this helps standardize the z/XDC installation
process, and that results in a tremendous reduction in
tech calls at installation time!
- Third, because I can impose a standard installation
process, I can provide my customers with a "black box"
installation job stream that will always work without
requiring any SMP/E expertise whatsoever on my customers'
part.
Still, some people might think that having separate SMP libraries is
wasteful of disk space. It makes me sort of smile when I hear
that. (see:? [:)] )
Dave Cole REPLY TO: dbcole@colesoft.com
Cole Software WEB PAGE: http://www.colesoft.com
736 Fox Hollow Road VOICE: 540-456-8536
Afton, VA 22920 FAX: 540-456-6658
Technical Details
Message-ID:
<6.2.3.4.2.20050904095340.0503de58@mail.swcp.com>Path:
arc1-ca.pugleaf.net!g2news1.google.com!news4.google.com!news.glorb.com!sn-xit-04!sn-xit-12!sn-xit-09!sn-xit-14!supernews.com!149.173.6.116.MISMATCH!foggy!vm.sas.com!colesoft.com!dbcoleReferences:
<E9DE7963E5EA6546B42A979EC28B4D011565DCDF@hou-ex-02.adprod.bmc.com>Show Full Headers
Complete Article Headers
X-Google-Thread: fcdcb,b5f541d74f4633a6
X-Google-Attributes: gidfcdcb,public
X-Google-Language: ENGLISH,ASCII-7-bit
Path: arc1-ca.pugleaf.net!g2news1.google.com!news4.google.com!news.glorb.com!sn-xit-04!sn-xit-12!sn-xit-09!sn-xit-14!supernews.com!149.173.6.116.MISMATCH!foggy!vm.sas.com!colesoft.com!dbcole
From: David Cole <dbcole@colesoft.com>
Newsgroups: bit.listserv.asm370
Subject: Re: Assembly coding guidelines (SMP/E packaging)
Date: Sun, 4 Sep 2005 10:39:41 -0400
Organization: SAS Inc.
Lines: 88
Sender: IBM Mainframe Assembler List <ASSEMBLER-LIST@LISTSERV.UGA.EDU>
Message-ID: <6.2.3.4.2.20050904095340.0503de58@mail.swcp.com>
References: <E9DE7963E5EA6546B42A979EC28B4D011565DCDF@hou-ex-02.adprod.bmc.com>
NNTP-Posting-Host: mozart.unx.sas.com
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-Trace: foggy.unx.sas.com 1125845312 23220 10.19.150.41 (4 Sep 2005 14:48:32 GMT)
X-Complaints-To: usenet@unx.sas.com
NNTP-Posting-Date: Sun, 4 Sep 2005 14:48:32 +0000 (UTC)
Comments: Gated by NETNEWS@VM.SAS.COM
Return-Path: <owner-assembler-list@LISTSERV.UGA.EDU>
X-Mailer: QUALCOMM Windows Eudora Version 6.2.3.4
X-Virus-Scanned: ClamAV version 0.85.1,
clamav-milter version 0.85 on av2.swcp.com
X-Virus-Status: Clean
X-Spam-Checker-Version: SpamAssassin 3.0.4 (2005-06-05) on kaimen.swcp.com
X-Spam-Status: No,
hits=-2.4 required=10.0 tests=ALL_TRUSTED autolearn=failed
version=3.0.4
Approved-By: David Cole <dbcole@COLESOFT.COM>
In-Reply-To: <E9DE7963E5EA6546B42A979EC28B4D011565DCDF@hou-ex-02.adprod.
bmc.com>
Return-Path: owner-assembler-list@LISTSERV.UGA.EDU
X-OriginalArrivalTime: 04 Sep 2005 14:48:30.0619 (UTC)
FILETIME=[B75BE6B0:01C5B15F]
Originator: daemon@mozart.unx.sas.com