Debian Codegraph @

cmsmvs/README.MVS.LE

raw
1 Notes on Zip under MVS Language Environment (LE).
2
3 First see README.MVS. This note describes just one beta test on OS/390
4 V2R5 using IBM's C compiler (5647A01), V2R4. The major difference is
5 the use of LE on the beta site, together with some MVS native mode
6 fixes. Changes have not been tested on CMS.
7
8 Some of the notes are to clarify things that were not clear from the
9 MANUAL or README.MVS.
10
11 1. By default, IBM C generates the same csect name for each input
12 source. The prelink stage does not rename them and the linkage
13 editor throws away all but the first occurrence of each duplicate.
14 Oops, my code just disappeared :(.
15
16 To get around this "feature", compile with the CSECT option to
17 force sensible names on the code and data sections of each csect.
18 The name of the static data csect defaults to the source name in
19 lower case, the code csect defaults to the source name in upper
20 case. These csect names still have to be unique, they cannot be
21 the same as function names. Of course, several csects have a
22 function which is the same name as the source in lower case, not
23 exactly an unusual occurrence. Therefore to make the csect name
24 unique, some of the sources have
25
26 #ifdef MVS
27 # pragma csect(STATIC,xxxx_s)
28 #endif
29
30 Where xxxx is an abbreviation of the source name. There has to be
31 a better way!
32
33 2. The prelink step always gets cond code 4. It complains about
34 unresolved references, ignore it unless the linker also complains.
35 Prelink also complains about duplicate @@PPA2 sections and so does
36 the linker, but it seems to do no harm. Compile and link steps
37 should get 0, just prelink gets 4. See JCL at the bottom.
38
39 3. Under MVS native mode (not Open Edition), tmpnam() returns a quoted
40 name of 5 qualifiers. The first is a HLQ chosen according to the
41 MVS LE algorithm (see below), the other qualifiers are time stamps.
42 If running on MVS and tmpnam() returns a quoted name with at leat
43 one '.', it is only safe to let the user change the high level
44 qualifier. Therefore -b insists on a single qualifier without '.'
45 in the MVS native environment.
46
47 4. In Open Edition (OE) mode, the manual says that tmpnam() returns a
48 fully qualified name in directory TMPDIR or /tmp if TMPDIR is not
49 set. There is no point in zip trying to override that name so -b
50 is ignored in MVS OE mode (untested). The user should specify
51 environment variable TMPDIR instead.
52
53 5. The MVS LE algorithm for choosing the high level qualifier for
54 native filenames is interesting, as in "May you live in interesting
55 times". The HLQ varies according to the environment the program is
56 running in, sometimes it is userid, sometimes it is TSO prefix.
57 See OS/390 C/C++ Programming Guide, Using a Data Set Name,
58 somewhere around section 2.9.
59
60 If in doubt, use fully qualified and quoted names. Instead of
61 archive.zip, use 'prefix.archive.zip'. For input files, instead of
62 filename, use 'prefix.filename'. For PARM= in JCL, double up the
63 quotes. You even have to quote filenames in stdin.
64
65 6. If your PARM includes any '/', make sure the PARM starts with '/'.
66 LE assumes anything before the first '/' is LE run time parameters.
67 It does no harm to always code a leading '/' for LE parms.
68
69 7. JCL limits a PARM= to 100 characters total with approx. 65 on a
70 single line. Alas the syntax for continuing PARM= always embeds an
71 extra ',' somewhere in the parameters that the program finally
72 gets. No workaround, limit your PARM to a single line. With the
73 extra quotes around filenames, that does not leave much room. In
74 most cases, you will have to use '-@' to read the list of filenames
75 from SYSIN (stdin), it will not fit on a single PARM line.
76
77 8. Filenames can be dataset names or you can refer to a ddname with
78 'DD:name', case insensitive for external files, case sensitive for
79 OE files. You can even specify 'dd:name(mem)'. No wildcards, to
80 zip a complete pds you have to specify each member individually.
81 Directory recursion in OE does not appear to work at the moment.
82
83 9. Zip attempts to map MVS filenames to Unix style names. It did not
84 work correctly for quoted names, fixed. Although you can pick up
85 an external (non-OE) file with a name using any case, be aware that
86 the mapping to a Unix style name faithfully follows the case you
87 supply.
88
89 10. The archive file was being created with recfm=V and lrecl=32760.
90 32760 is not valid for recfm=V under MVS, I originally changed it
91 to lrecl=32756. Then zip broke trying to fseek() over a record
92 boundary, I do not know whether this was a zip or LE bug. Trial
93 and error showed that recfm=U with byteseek seems to work on MVS.
94 No BDW or RDW, just a byte stream. The blocksize is always 6144.
95
96 NOTE: This is an incompatible change from the previous beta,
97 archive files used to be recfm=V. That should not matter
98 because we just transfer the data, ignoring BDW and RDW
99 anyway.
100
101 11. Zip used to complain about preallocated but empty archives, wrong
102 length records, no signature etc. The usual IBM/360 problem of no
103 end of file marker in a new, unopened dataset. Fixed, see routine
104 readzipfile in zipfile.c for the gory details. PARM= works fine.
105
106 12. Several source files have records that are more than 80 bytes long.
107 It works if you transfer to mainframe datasets with a larger lrecl,
108 I used recfm=fb,lrecl=120 for the .C and .H files. To compile with
109 anything longer than 72 bytes, you need MVS C options NOMARGINS and
110 NOSEQUENCE (NOMAR,NOSEQ).
111
112 13. cmsmvs was still using zname instead of name for open. Fixed.
113
114 14. zip has to jump through a lot of hoops to see if an existing
115 zipfile actually contains data. A side effect of this is that
116 creating a zipfile with the RLSE parameter is a waste of time.
117
118 Keith Owens <[email protected]>. Not a maintainer, just a beta tester.
119 Mon Sep 14 19:31:30 EST 1998
120
121
122 Sample JCL to compile Zip under MVS LE. You might need a large region,
123 I used REGION=128M on the job card. Also watch the output lines,
124 75,000 with OPT(2), 100,000+ with OPT(2) replaced with DEF(DEBUG). You
125 need to allocate prefix.ZIP.C.OBJ (recfm=FB, lrecl=80) and
126 prefix.ZIP.LOAD (recfm=U, blksize is site defined).
127
128 //CBC JCLLIB ORDER=CBC.SCBCPRC
129 //ZIP EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
130 // INFILE='prefix.ZIP.C(ZIP)',
131 // OUTFILE='prefix.ZIP.C.OBJ(ZIP),DISP=SHR',
132 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
133 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
134 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
135 //CRYPT EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
136 // INFILE='prefix.ZIP.C(CRYPT)',
137 // OUTFILE='prefix.ZIP.C.OBJ(CRYPT),DISP=SHR',
138 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
139 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
140 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
141 //TTYIO EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
142 // INFILE='prefix.ZIP.C(TTYIO)',
143 // OUTFILE='prefix.ZIP.C.OBJ(TTYIO),DISP=SHR',
144 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
145 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
146 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
147 //TREES EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
148 // INFILE='prefix.ZIP.C(TREES)',
149 // OUTFILE='prefix.ZIP.C.OBJ(TREES),DISP=SHR',
150 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
151 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
152 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
153 //DEFLATE EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
154 // INFILE='prefix.ZIP.C(DEFLATE)',
155 // OUTFILE='prefix.ZIP.C.OBJ(DEFLATE),DISP=SHR',
156 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
157 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
158 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
159 //FILEIO EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
160 // INFILE='prefix.ZIP.C(FILEIO)',
161 // OUTFILE='prefix.ZIP.C.OBJ(FILEIO),DISP=SHR',
162 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
163 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
164 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
165 //GLOBALS EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
166 // INFILE='prefix.ZIP.C(GLOBALS)',
167 // OUTFILE='prefix.ZIP.C.OBJ(GLOBALS),DISP=SHR',
168 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
169 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
170 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
171 //UTIL EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
172 // INFILE='prefix.ZIP.C(UTIL)',
173 // OUTFILE='prefix.ZIP.C.OBJ(UTIL),DISP=SHR',
174 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
175 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
176 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
177 //CRC32 EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
178 // INFILE='prefix.ZIP.C(CRC32)',
179 // OUTFILE='prefix.ZIP.C.OBJ(CRC32),DISP=SHR',
180 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
181 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
182 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
183 //CRCTAB EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
184 // INFILE='prefix.ZIP.C(CRCTAB)',
185 // OUTFILE='prefix.ZIP.C.OBJ(CRCTAB),DISP=SHR',
186 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
187 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
188 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
189 //ZIPFILE EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
190 // INFILE='prefix.ZIP.C(ZIPFILE)',
191 // OUTFILE='prefix.ZIP.C.OBJ(ZIPFILE),DISP=SHR',
192 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
193 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
194 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
195 //ZIPUP EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
196 // INFILE='prefix.ZIP.C(ZIPUP)',
197 // OUTFILE='prefix.ZIP.C.OBJ(ZIPUP),DISP=SHR',
198 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
199 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
200 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
201 //CMSMVS EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
202 // INFILE='prefix.ZIP.C(CMSMVS)',
203 // OUTFILE='prefix.ZIP.C.OBJ(CMSMVS),DISP=SHR',
204 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
205 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
206 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
207 //MVS EXEC EDCC,COND=(0,NE),CREGSIZ='4M',
208 // INFILE='prefix.ZIP.C(MVS)',
209 // OUTFILE='prefix.ZIP.C.OBJ(MVS),DISP=SHR',
210 // CPARM='LONG,NOTERM,LIST,XREF,SOURCE',
211 // CPARM2='OPT(2),DEF(MVS),NOMAR,NOSEQ,CSECT'
212 //COMPILE.USERLIB DD DSN=prefix.ZIP.H,DISP=SHR
213 //PLINK EXEC PROC=EDCPL,
214 // OUTFILE='prefix.ZIP.LOAD(ZIP),DISP=SHR',
215 // PREGSIZ=6M,
216 // PPARM='NONCAL,MAP,MEMORY',
217 // LPARM='LIST,MAP,XREF'
218 //PLKED.SYSIN DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(ZIP)
219 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(CRYPT)
220 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(TREES)
221 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(DEFLATE)
222 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(FILEIO)
223 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(GLOBALS)
224 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(UTIL)
225 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(CRC32)
226 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(CRCTAB)
227 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(ZIPFILE)
228 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(ZIPUP)
229 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(MVS)
230 // DD DISP=SHR,DSN=prefix.ZIP.C.OBJ(CMSMVS)
231 //LKED.SYSLIB DD DISP=SHR,DSN=CEE.SCEELKED
232 //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(2,2))
233 //
234
235 Sample JCL to zip the mainframe .C and .H files as ASCII (-a). Delete
236 any existing archive first, point the temporary file at a particular
237 prefix (-b), use 'prefix.ARCHIVE.ZIP' for the archive file, read the
238 list of files to zip from stdin (SYSIN).
239
240 //DELETE EXEC PGM=IDCAMS
241 //SYSPRINT DD SYSOUT=*
242 //SYSIN DD *
243 DELETE prefix.ARCHIVE.ZIP
244 SET MAXCC = 0
245 //ZIP EXEC PGM=ZIP,
246 // PARM='/-a -v -b temppref ''prefix.ARCHIVE.ZIP'' -@'
247 //STEPLIB DD DSN=prefix.ZIP.LOAD,DISP=SHR
248 //SYSPRINT DD SYSOUT=*
249 //SYSOUT DD SYSOUT=*
250 //CEEDUMP DD SYSOUT=*
251 //ZIPC DD DISP=SHR,DSN=prefix.ZIP.C
252 //ZIPH DD DISP=SHR,DSN=prefix.ZIP.H
253 //SYSIN DD *
254 dd:zipc(api)
255 dd:zipc(cms)
256 dd:zipc(cmsmvs)
257 dd:zipc(crctab)
258 dd:zipc(crc32)
259 dd:zipc(crypt)
260 dd:zipc(deflate)
261 dd:zipc(fileio)
262 dd:zipc(globals)
263 dd:zipc(mktime)
264 dd:zipc(mvs)
265 dd:zipc(trees)
266 dd:zipc(ttyio)
267 dd:zipc(util)
268 dd:zipc(zip)
269 dd:zipc(zipcloak)
270 dd:zipc(zipfile)
271 dd:zipc(zipnote)
272 dd:zipc(zipsplit)
273 dd:zipc(zipup)
274 dd:ziph(api)
275 dd:ziph(cmsmvs)
276 dd:ziph(crypt)
277 dd:ziph(cstat)
278 dd:ziph(ebcdic)
279 dd:ziph(mvs)
280 dd:ziph(revision)
281 dd:ziph(stat)
282 dd:ziph(tailor)
283 dd:ziph(ttyio)
284 dd:ziph(zip)
285 dd:ziph(ziperr)
286 dd:ziph(zipup)