Procedures : CONTENTS

CONTENTS

Prints descriptions of the contents of one or more files from a SAS data library

OS/390 specifics: engine/host-dependent information, directory information

Syntax
Details
See Also

Syntax

PROC CONTENTS <option(s)>;

Details

Although most of the output that this procedure generates is the same on all operating environments, the Engine/Host Dependent Information is system-dependent and engine-dependent. CONTENTS Procedure Output, Including Engine/Host Dependent Information shows sample PROC CONTENTS output, including the information that is specific to OS/390 for the BASE engine.

CONTENTS Procedure Output, Including Engine/Host Dependent Information

CONTENTS PROCEDURE Data Set Name: WORK.ORANGES Observations: 4 Member Type: DATA Variables: 5 Engine: V8 Indexes: 0 Created: 15:56 Monday, April 27, 1999 Observation Length: 40 Last Modified: 15:56 Monday, April 27, 1999 Deleted Observations: 0 Protection: Compressed: NO Data Set Type: Sorted: YES Label: -----Engine/Host Dependent Information----- Data Set Page Size: 6144 Number of Data Set Pages: 1 First Data Page: 1 Max Obs per Page: 152 Obs in First Data Page: 4 Number of Data Set Repairs: 0 Physical Name: SYS96050.T153830.RA000.USERID.R0000004 Release Created: 8.0000B1 Release Last Modified: 8.0000B1 Created by: USERID Last Modified by: USERID Subextents: 1 Total Blocks Used: 1 Taste Test Results For Oranges CONTENTS PROCEDURE -----Alphabetic List of Variables and Attributes----- # Variable Type Len Pos ----------------------------------- 2 FLAVOR Num 8 8 4 LOOKS Num 8 24 3 TEXTURE Num 8 16 5 TOTAL Num 8 32 1 VARIETY Char 8 0

The procedure output provides values for the physical characteristics of the SAS data set WORK.ORANGES. Important values follow:

Observations: is the number of nondeleted records in the data set.
Observation Length: is the maximum record size in bytes.
Compressed: has the value NO if records are not compressed; it has the value CHAR or BINARY if records are compressed.
Data Set Page Size: is the size of pages in the data set.
Number of Data Set Pages: is the total number of pages in the data set.
First Data Page: is the number of the page that contains the first data record; header records are stored in front of data records.
Max Obs per Page: is the maximum number of records a page can hold.
Obs in First Data Page: is the number of data records in the first data page.

The DIRECTORY option lists several host-specific data library attributes at the beginning of PROC CONTENTS output. Engine/Host Dependent Information shows the directory information that is listed by the following code:

proc contents data=test._all_ directory;
run;

Engine/Host Dependent Information

CONTENTS PROCEDURE -----Directory----- Libref: TEST Engine: V8 Physical Name: USERID.TEST.TESTLIB Unit: DISK Volume: TST810 Disposition: OLD Device: 3380 Blocksize: 6144 Blocks per Track: 7 Total Library Blocks: 105 Total Used Blocks: 28 Total Free Blocks: 77 Highest Used Block: 28 Highest Formatted Block: 35 Members: 2 # Name Memtype Indexes _________________________ 1 TEMP DATA 2 XYZ DATA

The following list explains these data library attributes:

Total Library Blocks: is the total number of blocks that are currently allocated to the data library. This value equals the sum of Total Used Blocks and Total Free Blocks. It also equals Blocks per Track multiplied by the number of tracks that are currently allocated to the data library. The current number of allocated cylinders or tracks can be found in the DSINFO window, or in ISPF panel 3.2. These windows show what the allocation was the last time the data library was closed.
Total Used Blocks: is the total number of library blocks that currently contain valid data. It equals the sum of the directory blocks and all the data blocks that are associated with existing members.
Total Free Blocks: is the total number of currently allocated library blocks that are available for use by members or as extra directory blocks. This count includes any data blocks that were previously associated with members that have been deleted.
Highest Used Block: is the number of the highest relative block in the data library that currently contains either directory information or data for an existing member.
Highest Formatted Block: is the number of the highest relative block in the data library that has been internally formatted for use. Blocks are internally formatted before they are used, and they are formatted in full track increments. Therefore, the highest formatted block is equal to the Blocks per Track multiplied by the number of tracks that are currently used by the data library. The number of currently used cylinders or tracks can be found in the DSINFO window or in ISPF panel 3.2. These windows show what the allocation was the last time the data library was closed. This number is also the true End Of File marker. It corresponds to the DS1LSTAR field in the DSCB in the VTOC, which is the OS/390 operating environment's EOF flag.

Note: The same directory information that is generated by the DIRECTORY option in the PROC CONTENTS statement is also generated by the LIST option in the LIBNAME statement. [cautionend]

See Also

SAS Language Reference: Dictionary
SAS Procedures Guide

Chapter Contents
Previous
Next
Top of Page