This tool is used to get a list of data sets corresponding to a given filter.
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:
| 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.
Default value: 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.
Default value: 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.
Default value: 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.
Default value: 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.
Default value: 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.
Default value: false |
| Matchname GDG | String | Specifies the match name returned for GDG files. Only visible if Distinguish GDG Files is set to true.
Default value: MVSGDG |
| Matchname Load | String | Specifies the match name returned for load libraries. Only visible if Distinguish Load Libraries is set to true.
Default value: MVSLOADLIB |
| Matchname Migrated | String | Specifies the match name returned for migrated data sets. Only visible if Distinguish Migrated Data Sets is set to true.
Default value: MVSMIGRATED |
| Matchname PO | String | Specifies the match name returned for PO data sets. Only visible if Element Type Distinction is set to true.
Default value: MVSPO |
| Matchname Sequential | String | Specifies the match name returned for sequential data sets. Only visible if Element Type Distinction is set to true.
Default value: MVSSEQ |
| Matchname VSAM | String | Specifies the match name returned for VSAM files. Only visible if Distinguish VSAM Files is set to true.
Default value: MVSVSAM |
| Parameter No | I/O | Type | Description |
|---|---|---|---|
| 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:
Supported values for the data set organization are: