1dasdseq(1)                  General Commands Manual                 dasdseq(1)
2
3
4

NAME

6       dasdseq - Hercules DSORG=PS retrieval command
7
8

SYNOPSIS

10       dasdseq [options...] image [sf=shadow] filespec
11       dasdseq  [-debug]  [-expert] [-ascii] image [sf=shadow] [attr] filespec
12       [debugopts] [ascii]
13
14

DESCRIPTION

16       Hercules command to  retrieve  a  DSORG=PS  (sequential)  dataset  from
17       CKD/CCKD  DASD.   The dataset is presumed to be encoded in EBCDIC.  The
18       second form of the command is for 'expert mode' users, and allows  more
19       advanced access to data on the DASD image.
20
21

OPTIONS

23       The  following  options are used to specify dasdseq behavior.  Surround
24       each option by blank(s).  Options are divided  into  three  categories:
25       required, optional, and expert mode operands.
26
27

Required operands

29   image
30       specifies the Hercules CKD/CCKD DASD filename (sometimes referred to as
31       the DASD image file)
32
33   filespec
34       dataset name of the file to retrieve.  Case insensitive,  converted  to
35       upper case for searching VTOC on image DASD volume.
36
37

Optional operands

39   sf=shadow
40       For CCKD images which also use shadow files, specifies the [path/]file‐
41       name of the shadow file.  Note the sf=, which must be present for  this
42       option.
43
44
45   -ascii
46       convert the output file to ASCII (from EBCDIC).  Additionally, trailing
47       blanks are trimmed.  The 'ascii' option (no  leading  dash)  is  depre‐
48       cated, and may be removed in a future release.
49
50

Expert mode operands

52       All expert mode operands are considered to be experimental.
53
54        dasdseq  [-debug] [-expert] [-ascii] image [sf=shadow] [attr] filespec
55       [debugopts]
56
57
58   -debug
59       Additional debug options are displayed.  Specifying -debug will  (even‐
60       tually) display dataset extent information.
61
62
63   attr
64       dataset attributes (only useful with -abs)
65
66       [-recfm fb] [-lrecl aa]
67
68       -recfm designates RECFM, reserved for future support
69
70       fb - fixed, blocked (only RECFM currently supported)
71
72       -lrecl designates dataset LRECL
73
74       aa - decimal logical record length (default 80)
75
76       Blocksize  need  not  be specified; dasdseq handles whatever block size
77       comes off the volume.
78
79
80   filespec
81       composed of the following sub-operands, in the following order:  heads,
82       abs, filename.
83
84
85   -heads xx
86       defines  #  tracks per cylinder on device; xx = decimal number of heads
87       per cylinder on device
88
89
90   -abs cc hh tt [...] [-abs cc hh tt]
91       -abs indicates the beginning of each  extent's  location  in  terms  of
92       absolute dasd image location.
93
94       cc - decimal cylinder number (relative zero)
95
96       hh - decimal head number (relative zero)
97
98       tt - decimal number of tracks in extent
99
100       When  -abs  is specified, each -abs group specifies one dataset extent.
101       For multi-extent datasets, -abs groups may be repeated  as  needed,  in
102       the  order  in  which  the  dataset's  extents occur.  A maximum of 123
103       extents are supported.  With -abs, no VTOC structure is implied;  a  F1
104       DSCB  will  not  be  sought.  Dasdseq will frequently report 'track not
105       found in extent table' (along with a message from fbcopy  about  rc  -1
106       from  convert_tt) due to potentially missing EOF markers in the extent,
107       and the fact that the F1 DSCB DS1LSTAR field is not valid.  Check  your
108       output file before you panic.  Fbcopy -abs ignores EOF, in case you are
109       attempting to recovery PDS member(s) from a damaged dasd  volume,  pre‐
110       ferring  to  wait  until  all tracks in the extent have been processed.
111       Tracks containing PDS members may have more than  one  EOF  per  track.
112       Expect a lot of associated manual effort with -abs.
113
114       When  -abs  is  -not-  specified,  filename  specifies the MVS DSORG=PS
115       dataset on the volume.  The dasd image volume  containing  the  dataset
116       must have a valid VTOC structure, and a F1 DSCB describing the dataset.
117
118
119   filename
120       will  be the filename of the output file in the current directory; out‐
121       put filename in the same case as the command line filename.
122
123
124   debugopts
125       Produces debugging output, refer to the source code.
126
127       verbose [x [y [z]]]
128
129       verbose   debug output level (default = 0 when not specified).   Higher
130       numbers produce more output.
131
132       x  main program (default = 1 when verbose specified)
133
134       y  copyfile + showf1
135
136       z  dasdutil
137
138

SEE ALSO

140       dasdpdsu for DSORG=PO datasets
141
142       cckd(4) for CCKD DASD
143
144       http://www.hercules-390.org/cckddasd.html which describes
145              the Hercules CCKD DASD facility.
146
147       http://www.hercules-390.org/ the Hercules emulator homepage.
148
149

HISTORY

151       2003-03-10 originally written by James M. Morrison
152
153
154
155
156
157
158                                  2003-03-10                        dasdseq(1)
Impressum