Get Data Sets

Function:

This tool is used to get a list of data sets corresponding to a given filter.

Note: The Get Data Sets tool descriptors created in models prior AWM V3.0 are marked as deprecated in models. They still work as before but do not return the resource identifier property, which must be used as ID definition property for linked MVS element types.

Tool Attribute:

Get Data Sets can return different data set match names. If required, different match names can be returned for specific data set types, including sequential, partitioned organized, migrated, VSAM, and so on. This is to support scenarios where different element types are not required, as well as complex models, which require different data set element types with specific actions and properties.

By default, the tool distinguishes three data set types returning three different match names:

PO data set
PS data set
Migrated data set

Attribute	Type	Description
Element Type Distinction	Boolean	Specifies whether different match names should be returned by the tool. When set to false, the tool returns the same match name for all data set types. If true, supported data set types can be customized in more detail. The default value is true.
Matchname Data Set	String	Specifies the match name that should be used for returned data sets, if Element Type Distinction is set to false. The default value is MVSDATASET.
Distinguish GDG Files	Boolean	Specifies whether a specific match name should be returned for GDG files. Only visible if Element Type Distinction is set to true. The default value is false.
Distinguish Load Libraries	Boolean	Specifies whether a specific match name should be returned for load libraries. Only visible if Element Type Distinction is set to true. The default value is false.
Distinguish Migrated Data Sets	Boolean	Specifies whether a specific match name should be returned for migrated data sets. Only visible if Element Type Distinction is set to true. The default value is true.
Distinguish VSAM Files	Boolean	Specifies whether a specific match name should be returned for GDG files. Only visible if Element Type Distinction is set to true. The default value is false.
Matchname GDG	String	Specifies the match name returned for GDG files. Only visible if Distinguish GDG Files is set to true. The default value is MVSGDG.
Matchname Load	String	Specifies the match name returned for load libraries. Only visible if Distinguish Load Libraries is set to true. The default value is MVSLOADLIB.
Matchname Migrated	String	Specifies the match name returned for migrated data sets. Only visible if Distinguish Migrated Data Sets is set to true. The default value is MVSMIGRATED.
Matchname PO	String	Specifies the match name returned for PO data sets. Only visible if Element Type Distinction is set to true. The default value is MVSPO.
Matchname Sequential	String	Specifies the match name returned for sequential data sets. Only visible if Element Type Distinction is set to true. The default value is MVSSEQ.
Matchname VSAM	String	Specifies the match name returned for VSAM files. Only visible if Distinguish VSAM Files is set to true. The default value is MVSVSAM.

Parameters:

Parameter Name	I/O	Type	Description
Data Set Filter [M]	I	String	Data set filters can be specified in the same way as under z/OS ISPF. The reference variable userid can be used in the filter string. Valid filter specifications are, for example: &userid., &userid., SYS1.PROC, &userid..TEST., &userid..TES%. * is a substitute for any number of characters; % is a substitute for exactly one character. It is possible to specify more than one data set filter separated by a semicolon.
Data Set List [M]	O	File	References the file contained in the Data Set List.

Parameter Name

I/O

Type

Description

Data Set Filter [M]

String

Data set filters can be specified in the same way as under z/OS ISPF. The reference variable userid can be used in the filter string. Valid filter specifications are, for example:

&userid., &userid.*, SYS1.PROC*, &userid..TEST.*, &userid..TES%.*

* is a substitute for any number of characters; % is a substitute for exactly one character.

It is possible to specify more than one data set filter separated by a semicolon.

Data Set List [M]

File

References the file contained in the Data Set List.

The generated output file descriptor (Data Set List) is of type InputStream with the following table structure. The property separator is /%/$/.

Property No	Target ID
1	Name of the data set.
2	Resource identifier, used for linked MVS element types.
3	Matchname identifying the data set element type.
4	Type of the data set.
5	Organization of the data set.
6	Record Format of the data set.
7	Record Length of the data set.
8	Space Units of the data set.
9	Primary Quantity of the data set.
10	Secondary Quantity of the data set.
11	Total Quantity of the data set.
12	Volume Serial of the data set.
13	Block Size of the data set.
14	SMS Managed of the data set.
15	Whether the data set is accessible.
16	Suffix of the data set.
17	Whether the data set is browsable.
18	Whether the data set is editable.

The match name specified under "Dataset Matchname" must correspond with a match name defined for an element type in the model.

Supported values for the data set type are:

LIBRARY
HFS
PDS
LARGE
BASIC
EXTREQ
EXTPREF
SEQ
VSAM
GDG
NONE

Supported values for the data set organization are:

PS
PO
DA
KSDS
ESDS
RRDS
UNKNOWN (if data set is migrated)