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
       [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/]file-
       name 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	depre-
       cated, 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	(even-
       tually) 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  ab-
       solute 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 ex-
       tents 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,  pre-
       ferring	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; out-
       put 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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | Required operands | Optional operands | Expert mode operands | SEE ALSO | HISTORY

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

home | help