1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
|
s390-tools (1.6.2)
Category operating system. Contains the source tree of a set of
user space utilities that should to be used together with the
zSeries (s390) Linux kernel and device drivers.
The package contains:
* dasdfmt:
Low-level format ECKD DASDs with the classical linux disk layout or the new
z/OS compatible disk layout.
* fdasd:
Create or modify partitions on ECKD DASDs formatted with the z/OS
compatible disk layout.
* dasdview:
Display DASD and VTOC information or dump the contents of a DASD to the
console.
* dasdinfo:
Display unique DASD ID, either uid or volser.
* 59-dasd.rules:
udev rules for unique DASD device nodes created in /dev/disk/.
* zipl:
Make DASDs or tapes bootable for system IPL or system dump.
* zgetdump:
Retrieve system dumps from either tapes or DASDs.
* qetharp:
Read and flush the ARP cache on OSA Express network cards.
* tape390_display:
Display information on the message display facility of a zSeries tape
device.
* tape390_crypt:
Control and query crypto settings for 3592 zSeries tape devices.
* osasnmpd:
UCD-SNMP/NET-SNMP subagent implementing MIBs provided by OSA-Express
features Fast Ethernet, Gigabit Ethernet, High Speed Token Ring and
ATM Ethernet LAN Emulation in QDIO mode.
Note: You need at least the UCD-SNMP 4.2.3 package installed, before
building the osasnmpd subagent.
For more information on UCD-SNMP/NET-SNMP refer to:
http://net-snmp.sourceforge.net/
* qethconf:
bash shell script simplifying the usage of qeth IPA (IP address
takeover), VIPA (Virtual IP address) and Proxy ARP.
* dbginfo.sh:
Shell script collecting useful information about the current system for
debugging purposes.
* zfcpdump:
Dump tool to create system dumps on fibre channel attached SCSI disks.
It is installed using the zipl command.
* zfcpdump_v2:
Version 2 of the zfcpdump tool. Now based on the upstream 2.6.23 Linux
kernel.
* ip_watcher:
Provides HiperSockets Network Concentrator functionality.
It looks for addresses in the HiperSockets and sets them as Proxy ARP
on the OSA cards. It also adds routing entries for all IP addresses
configured on active HiperSockets devices.
Use start_hsnc.sh to start HiperSockets Network Concentrator.
* tunedasd:
Adjust tunable parameters on DASD devices.
* vmconvert:
Convert system dumps created by the z/VM VMDUMP command into dumps with
LKCD format. These LKCD dumps can then be analyzed with the dump analysis
tool lcrash.
* vmcp:
Allows Linux users to send commands to the z/VM control program (CP).
The normal usage is to invoke vmcp with the command you want to
execute. The response of z/VM is written to the standard output.
* vmur:
Allows to work with z/VM spool file queues (reader, punch, printer).
* zfcpdbf:
Display debug data of zfcp. zfcp provides traces via the s390 debug
feature. Those traces are filtered with the zfcpdbf script, i.e. merge
several traces, make it more readable etc.
* scsi_logging_level:
Create, get or set the logging level for the SCSI logging facility.
* zconf:
Set of scripts to configure and list status information of Linux for
zSeries IO devices.
- chccwdev: Modify generic attributes of channel attached devices.
- lscss: List channel subsystem devices.
- lsdasd: List channel attached direct access storage devices (DASD).
- lsqeth: List all qeth-based network devices with their corresponding
settings.
- lstape: List channel attached tape devices.
- lszfcp: Shows information contained in sysfs about zfcp adapters, ports
and units that are online.
- lschp: List information about available channel-paths.
- chchp: Modify channel-path state.
* dumpconf:
Allows to configure the dump device used for system dump in case a kernel
panic occurs. This tool can also be used as an init script for etc/init.d.
Prerequisite for dumpconf is a Linux kernel with the "dump on panic"
feature.
* mon_statd:
Linux - z/VM monitoring daemons.
- mon_fsstatd: Daemon that writes filesystem utilization data to the
z/VM monitor stream.
- mon_procd: Daemon that writes process information data to the z/VM
monitor stream.
For more information refer to the following publications:
* "Device Drivers, Features, and Commands" chapter "Useful Linux commands"
* "Using the dump tools"
History of bug fixes:
=====================
1.6.2:
- zconf/lsdasd:
Description: Passing a list of DASDs does not work properly.
Symptom: Showing only the last DASD from a given list of DASDs.
Problem: The variable holding the DASDs is overwritten each time
a parameter is analysed.
Solution: Append DASDs to the list instead of overwriting it.
Problem-ID: 40076
- zfcpdump:
Description: SCSI dump does not work in some cases.
Symptom: When a SCSI dump is started, it does not work and no
messages are written to the console. This problem only
occurs from time to time.
Problem: Error handling of the 3215 console driver init function
assumes, that a failure of the called
ccw_device_probe_console() function is reported with a
NULL pointer. Unfortunately this function mixes NULL
pointer error reporting with the usage of the ERR_PTR
macros. Therefore the 3215 code misinterpreted an
ERR_PTR as valid return pointer. This can lead to a
kernel panic.
Solution: Always use the ERR_PTR macro for error reporting in the
ccw_device_probe_console() function.
Problem-ID: 40387
- zipl/dump tools:
Description: Memory detection sometimes does not work correctly.
Symptom: Error message "Device too small" and invalid dump.
Problem: In the 64 bit memory detection code a 32 bit XOR
operation is used to set a register to zero. If the
leftmost four bytes of the register are not zero, after
that operation the register will not be zero.
Solution: Use 64 bit XOR operation.
Problem-ID: 39807
- tape390_crypt:
Description: -query results in wrong message if mt setblk has been
used before.
Symptom: Query operation fails with message "Kernel does not
support tape encryption".
Problem: The query operation triggers a dummy read to enforce
the key exchange between tape control unit and EKM.
If the tape blocksize is not set to "auto", the read
will fail, if the blocksize of the read request is
smaller than the configured tape blocksize.
Solution: Use max blocksize for dummy read.
Problem-ID: 37795
- mon_fstatd:
Fixed error handling for invalid options.
- dbginfo.sh:
Collect more debug data.
- lszfcp:
Updated man page.
1.6.1:
- dbginfo.sh:
Description: Collect more debug data
Symptom: Missing data for analysis of customer problems
Problem: Important commands and directories are not captured
from dbginfo.sh
Solution: Added missing commands and attributes
Problem-ID: n/a
- dasdinfo:
Description: Wrong uid in some special cases
Symptom: In setups with many DASD devices sometimes dasdinfo
returns a wrong uid in some special setups if called
using a device node (-d option)
Problem: Missing check in major/minor comparisons
Solution: Add sanity check
Problem-ID: 32059
- zipl:
Description: dump_mem parameter can't be set for SCSI dump.
Symptom: When preparing a SCSI dump disk without additional
parameters, the optional memory parameter is always
ignored.
Problem: The memory parameter is not added to the kernel parameter
line, if no additional kernel parameters have been
specified.
Solution: Add memory parameter in every case.
Problem-ID: 32725
- zipl:
Description: boot menu uses wrong conversion table for input on LPAR
Symptom: When specifying extra kernel parameters via the boot menu
on LPAR, characters like [, ], |, !, ^ are incorrectly
converted and may lead to invalid kernel parameters (e.g.
cio_ignore=all,!0.0.1000).
Problem: zipl does not differentiate between z/VM console
(EBCDIC 037) and LPAR (EBCDIC 500) when converting
EBCDIC user input.
Solution: Use EBCDIC 500 conversion table on LPAR.
Problem-ID: 34247
- zfcpdump:
Description: No progress messages without SCLP console.
Symptom: During the dump process no progress messages are written
to the operator console.
Problem: If a system has another default console type than SCLP,
this console device is disabled by the zfcpdump code
using the cio_ignore kernel parameter. Therefore no
messages are written any more.
Solution: Do not disable the console device.
Problem-ID: n/a
Release History:
================
1.6.2:
Added new tools:
- vmur
- lschp
- chchp
- zfcpdump_v2
- mon_procd (with new mon_statd init script and sysconfig file)
Changes of existing tools:
- Use "-O3" compile option for all tools.
- Update zipl to enable zfcpdump_v2.
1.6.0:
Added new tools:
- tape390_crypt
- mon_fsstatd
- dumpconf
- dasdinfo
- 59-dasd.rules
Changes of existing tools:
- DASD/Tape dump tools:
SCLP console support to show dump progress on the operator console.
- zgetdump:
New -d option to check if DASD is a valid dump device.
- No more XML in zfcpdump:
Because XML is going to be obsolete, we now use the binary parameter
block provided by the hardware to find out on which scsi disk the dump
should be created.
- dbginfo.sh:
Collect additional system information.
- No libsysfs in DASD tools:
It turned out that using libsysfs is less stable than using the sysfs
attributes directly. Therefore the libsysfs dependency has been removed.
- Removed '-c' option of lsqeth.
- Unification of 'invalid option' error messages, Makefiles and "-v" output
for all tools.
1.5.2:
Added new tools:
- lszfcp
- scsi_logging_level
1.5.0:
Added new tool:
- vmcp: tool for accessing the control program of z/VM using the
kernel module 'vmcp'.
- zfcpdbf: perl script to filter ZFCP debug (DBF) data.
Added new features for existing tools:
- vmconvert: 64bit support.
Enhance vmconvert that it can convert the new 64bit format
z/VM dumps in addition to the old format dumps.
- osasnmpd: implement long options
For for all options now also long options have been implemented
using the "getopt_long" function.
- dasdxxxx: DASD tool harmonization
Some changes are applied to dasdfmt, fdasd and dasdview either to
make the syntax more common to other Linux tools or to introduce
small enhancements to get better usability.
- zfcpdump: Update SCSI System Dumper
Replaced the old Linux 2.4.19 kernel with Linux 2.6.12 and
e2fsprogs version 1.32 with version 1.37.
The busybox will be removed completely, since the functionality
provided by busybox will be implemented manually.
- dbginfo.sh: collect additional debug output.
fixed collection of s390dbf files which moved to debugfs.
Changed behaviour when trying to detect kernelversion.
1.4.0:
Added new tool:
- zconf/lsqeth: shell script to list all QETH based networking devices
Added new features for existing tools:
- dbginfo.sh: collect additional debug output,
corrected/changed command line handling
- zipl: added --dry-run function
This function can be used to simulate a zipl run without modifying
an existing IPL record.
- zipl: dump support for memory holes. Enables dumping for z/VM guests
with fragmented storage (defined with z/VM command
'define storage config').
- dasd tools: minor enhancements, rework and harmonization of the
commandline options
1.3.2: Added new tool:
- vmconvert
Added new features for existing tools:
- zipl: FBA dump support
1.3: Added new tools:
- zconf (chccwdev,lscss,lsdasd,lstape)
- tunedasd
Added new features for existing tools:
- zipl: multi boot, IPL from tape, custom dump size limit
- dbginfo.sh: adaptions for linux 2.6
1.2.2: Added new tool:
- ip_watcher/start_hsnc
1.2: Added new tools:
- qethconf
- zfcpdump
Added new features for existing tools:
- zipl: zfcp scsi ipl and dump support
- qetharp: static arp support
- tape390_display: new tape load option and new message types
1.1: Added new tools:
- dbginfo.sh
- osasnmpd
- qetharp
- tape390_display
1.0: Initial s390-tools release containing:
- dasdfmt
- dasdview
- fdasd
- zgetdump
- zipl
|