NAME

       dasdseq - Hercules DSORG=PS retrieval command

SYNOPSIS

       dasdseq [options...] image [sf=shadow] filespec
       dasdseq [-debug] [-expert] [-ascii] image [sf=shadow] [attr] filespec [debugopts] [ascii]

DESCRIPTION

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

OPTIONS

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

Required operands

   image
       specifies  the  Hercules  CKD/CCKD  DASD filename (sometimes referred to as the DASD image
       file)

   filespec
       dataset name of the file to retrieve.  Case  insensitive,  converted  to  upper  case  for
       searching VTOC on image DASD volume.

Optional operands

   sf=shadow
       For  CCKD  images which also use shadow files, specifies the [path/]filename of the shadow
       file.  Note the sf=, which must be present for this option.

   -ascii
       convert the output file  to  ASCII  (from  EBCDIC).   Additionally,  trailing  blanks  are
       trimmed.   The  'ascii'  option  (no  leading dash) is deprecated, and may be removed in a
       future release.

Expert mode operands

       All expert mode operands are considered to be experimental.

        dasdseq [-debug] [-expert] [-ascii] image [sf=shadow] [attr] filespec [debugopts]

   -debug
       Additional debug options are  displayed.   Specifying  -debug  will  (eventually)  display
       dataset extent information.

   attr
       dataset attributes (only useful with -abs)

       [-recfm fb] [-lrecl aa]

       -recfm designates RECFM, reserved for future support

       fb - fixed, blocked (only RECFM currently supported)

       -lrecl designates dataset LRECL

       aa - decimal logical record length (default 80)

       Blocksize need not be specified; dasdseq handles whatever block size comes off the volume.

   filespec
       composed of the following sub-operands, in the following order: heads, abs, filename.

   -heads xx
       defines  #  tracks  per  cylinder  on device; xx = decimal number of heads per cylinder on
       device

   -abs cc hh tt [...] [-abs cc hh tt]
       -abs indicates the beginning of each extent's location in terms  of  absolute  dasd  image
       location.

       cc - decimal cylinder number (relative zero)

       hh - decimal head number (relative zero)

       tt - decimal number of tracks in extent

       When  -abs  is  specified, each -abs group specifies one dataset extent.  For multi-extent
       datasets, -abs groups may be repeated as needed, in  the  order  in  which  the  dataset's
       extents  occur.   A maximum of 123 extents are supported.  With -abs, no VTOC structure is
       implied; a F1 DSCB will not be sought.  Dasdseq will frequently report 'track not found in
       extent  table'  (along  with  a  message  from  fbcopy about rc -1 from convert_tt) due to
       potentially missing EOF markers in the extent, and the fact  that  the  F1  DSCB  DS1LSTAR
       field is not valid.  Check your output file before you panic.  Fbcopy -abs ignores EOF, in
       case you are attempting to recovery PDS member(s) from a damaged dasd  volume,  preferring
       to wait until all tracks in the extent have been processed.  Tracks containing PDS members
       may have more than one EOF per track.  Expect a lot of associated manual effort with -abs.

       When -abs is -not- specified, filename specifies the MVS DSORG=PS dataset on  the  volume.
       The  dasd  image  volume containing the dataset must have a valid VTOC structure, and a F1
       DSCB describing the dataset.

   filename
       will be the filename of the output file in the current directory; output filename  in  the
       same case as the command line filename.

   debugopts
       Produces debugging output, refer to the source code.

       verbose [x [y [z]]]

       verbose    debug  output  level  (default = 0 when not specified).  Higher numbers produce
       more output.

       x  main program (default = 1 when verbose specified)

       y  copyfile + showf1

       z  dasdutil

SEE ALSO

       dasdpdsu for DSORG=PO datasets

       cckd(4) for CCKD DASD

       http://www.hercules-390.org/cckddasd.html which describes
              the Hercules CCKD DASD facility.

       http://www.hercules-390.org/ the Hercules emulator homepage.

HISTORY

       2003-03-10 originally written by James M. Morrison

                                            2003-03-10                                 dasdseq(1)