Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
dasdseq(1)		     General Commands Manual		      dasdseq(1)

NAME
     dasdseq - Hercules DSORG=PS retrieval command

SYNOPSIS
     dasdseq [options...] image [sf=shadow] filespec
     dasdseq  [-debug] [-expert] [-ascii] image [sf=shadow] [attr] filespec [de-
     bugopts] [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 [de-
     bugopts]

   -debug
     Additional  debug	options  are displayed.  Specifying -debug will (eventu-
     ally) 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  sup-
     ported.   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 po-
     tentially 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.  Fb-
     copy -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 ex-
     tent 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 num-
     bers 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dasdseq&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help