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.

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)