x = LISTDSI('my.data') /* x is set to a function code */
x = LISTDSI(my.data) /* x is set to a function code */
When you specify a variable that was previously set to a data set name, do not
enclose the variable in quotation marks. Quotation marks would prevent the data
set name from being substituted for the variable name.
variable = 'my.data'
x = LISTDSI(variable)
You cannot use LISTDSI with the filename parameter if the filename is allocated to
a data set
v which exists more than once with the same name on different volumes, and
v which is already in use
because in this case the system may not retrieve information for the data set you
wanted. After LISTDSI executes, the function call is replaced by one of the following
function codes:
Function Code Meaning
0 Normal completion
4 Some data set information is unavailable. All data set information other
than directory information can be considered valid.
16 Severe error occurred. None of the variables containing information
about the data set can be considered valid.
The following variables are set to the attributes of the data set specified.
Variable Contents
SYSDSNAME Data set name
SYSVOLUME Volume serial ID
SYSUNIT Device unit on which volume resides
SYSDSORG Data set organization: PS, PSU, DA, DAU, IS, ISU, PO,
POU, VS
SYSRECFM Record format; three-character combination of the following:
U, F, V, T, B, S, A, M
SYSLRECL Logical record length
SYSBLKSIZE Block size
SYSKEYLEN Key length
SYSALLOC Allocation, in space units
SYSUSED Allocation used, in space units
SYSUSEDPAGES Used space of a partitioned data set extended (PDSE) in 4K
pages.
SYSPRIMARY Primary allocation in space units
SYSSECONDS Secondary allocation in space units
SYSUNITS Space units: CYLINDER, TRACK, BLOCK
SYSEXTENTS Number of extents allocated
SYSCREATE Creation date:
Year/day format, for example: 1985/102
TSO/E External Functions
Chapter 10. Using TSO/E External Functions 121
To Next Page
Need help?
General
