DINFO(1)

NAME

dinfo: print out information about a dataset

SYNOPSIS

dinfo [-hvdlus] [<dataset> <volume>]+
	-h: syntax
	-v: print verbose information
	-d: print debug information
	-l: print dataset name, dataset organization, record format, 
		logical record length, volume
		This is the default.
	-u: print dataset name, last reference date, dataset organization, 
		record format, logical record length, volume 
		This is the same as -l with the addition of the reference date.
	-s: print used tracks (in bytes) and allocated tracks (in bytes)
		after other information 

DESCRIPTION

Print out information about a dataset in well-defined columns, 
making it easy to programmatically extract the fields required.
Field Descriptions, as they appear from left to right in output:

dataset name: 
	A 44 character field, blank padded on the right.
	The field is the dataset name provided to dinfo.

reference date: (when -u specified)
	Date is in the format YYYY/MM/DD. If the dataset has been 
	allocated but not referenced, 0000/01/01 will be printed.

dataset organization:
	A 3 character field, blank padded on the right.
		PS: physical sequential (Basic, Extended, Large)
		PO: partitioned organization (PDSE, PDSE, HFS file system)
		VS: virtual storage access method (VSAM)
		U:  unmovable
		DA: direct access
		CX: seldom used
		IS: seldom used
		??: unknown
	
record format:
	A 4 character field, blank padded on the right.
	The first character is one of:
		?:  unknown
		V:  variable record format
		F:  fixed record format
		U:  unknown record format 
	
	If the dataset is blocked, the next character will be:
		B:  blocked

	If the dataset is spanned, the next character will be:
		S:  spanned
	
	If the dataset contains ANSI-defined printer control characters,
	the next character will be:
		A:  ANSI-defined printer control characters present
	
logical record length:
	a 5 character field, blank padded on the left.

	The field is the logical record length. If the dataset has a
	variable record format, the number of bytes available per
	record will be 4 less than the logical record length, because
	the logical record length includes the 4 byte prefix 
	containing the record length. If the dataset has an unknown
	record format, the record length will be 0.
	
block size:
	A 5 character field, blank padded on the left.
	The field is the dataset block size, which is seldom required.
	
volume:
	A 6 character field, blank padded on the right.
	The field is the volume name provided to dinfo. 
	
used tracks: (when -s specified)
	An 11 character field, blank padded on the left.
	The number of bytes used on disk, if known.     
	Currently, the used tracks is known for sequential and
	partitioned datasets (but not PDSEs or VSAM datasets).                     

allocated tracks: (when -s specified)
	An 11 character field, blank padded on the left.
	The number of bytes allocated on disk, if known.     
	Currently, the allocated tracks is known for sequential and
	partitioned datasets but not VSAM datasets.                     

EXAMPLES

Print out basic information about the dataset SYS1.PROCLIB
residing on volume C3RES1:
	dinfo sys1.proclib c3res1

Print out detailed information including the last reference
date, the used and allocated sizes for the dataset 
SYS1.PARMLIB residing on volume C3RES1:
	dinfo -s -u SYS1.PARMLIB C3RES1

EXIT VALUES

0         dinfo ran successfully.

other     Error occurred. See error messages for details.

SEE ALSO

dcp(1), drm(1), dtouch(1), dls(1), decho(1), ddiff(1), dgrep(1), mrm(1), mls(1)