Get Data Sets

Function:

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

Note: 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 simple 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	Whether different match names should be returned by the tool. When set to false, the tool will return the same match name for all data set types. If true, supported data set types can be customized in more detail. Default value: true
Matchname Data Set	String	The match name that should be used for returned data sets, if “Element Type Distinction” is set to false. Default value: MVSDATASET
Distinguish GDG Files	Boolean	Whether a specific match name should be returned for GDG files. Only visible if Element Type Distinction is set to true. Default value: false
Distinguish Load Libraries	Boolean	Whether a specific match name should be returned for load libraries. Only visible if Element Type Distinction is set to true. Default value: false
Distinguish Migrated Data Sets	Boolean	Whether a specific match name should be returned for migrated data sets. Only visible if Element Type Distinction is set to true. Default value: true
Distinguish VSAM Files	Boolean	Whether a specific match name should be returned for GDG files. Only visible if Element Type Distinction is set to true. Default value: false
Matchname GDG	String	Match name returned for GDG files. Only visible if Distinguish GDG Files is set to true. Default value: MVSGDG
Matchname Load	String	Match name returned for load libraries. Only visible if Distinguish Load Libraries is set to true. Default value: MVSLOADLIB
Matchname Migrated	String	Match name returned for migrated data sets. Only visible if Distinguish Migrated Data Sets is set to true. Default value: MVSMIGRATED
Matchname PO	String	Match name returned for PO data sets. Only visible if Element Type Distinction is set to true. Default value: MVSPO
Matchname Sequential	String	Match name returned for sequential data sets. Only visible if Element Type Distinction is set to true. Default value: MVSSEQ
Matchname VSAM	String	Match name returned for VSAM files. Only visible if Distinguish VSAM Files is set to true. Default value: MVSVSAM

Parameters:

Parameter No	I/O	Type	Meaning
1 [M]	I	String	Data Set Filter. 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.
2 [M]	O	File	References the file contained in the Data Set List.

Parameter No

I/O

Type

Meaning

1 [M]

I

String

Data Set Filter. 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.

2 [M]

O

File

References the file contained in the Data Set List.

The output file descriptor (Data Set List) should be of type InputStream and have the following structure:

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.

When defining the file descriptor you must make sure you define a unique delimiter used to separate the data set properties. The MVS Explorer uses the delimiter "/%/$/".

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)