Catalog
The system's index of files. You give a name, it finds the disk.
Also written ICF catalog, master catalog, user catalog
Why it matters. Every time you open a dataset by name, the catalog is what finds it.
Syntax
LISTCAT LEVEL(level)
LISTCAT ENTRIES('dsname')- LEVEL(level)
- List every entry whose name starts with this level.
- ENTRIES('name')
- Ask about one entry. Quote the name.
- ALL
- Show every field for each entry.
- CATALOG(name)
- Look in one catalog only.
Try it LISTCAT
- 1
List every file whose name starts with ZBANK.
LISTCAT LEVEL(ZBANK) - 2
Ask the catalog about one file: the customer file.
LISTCAT ENTRIES('ZBANK.DATA.CUSTOMER')
Remember
- You ask for a file by name. The catalog finds the disk.
- LISTCAT shows what the catalog knows.
- The first part of a name, through an alias, decides which catalog holds it.
The usual mistake
LISTCAT ENTRIES(DATA.CUSTOMER)
Without quotes, your prefix (normally your user ID) is added to the front of the name.
LISTCAT ENTRIES('ZBANK.DATA.CUSTOMER')
On real z/OS
A real system has a master catalog and user catalogs, and an alias on the first part of a name points to the right one. MF/OS has one catalog per bank, and its name in IN-CAT is made up. CATALOG and ALL are not modelled.
Where can I practise Catalog?
Right here, at ZedBank. You take a junior job at a simulated bank and use Catalog in real work, with Zed beside you. There's nothing to install.
Start at ZedBankRelated
- Dataset nameThe full name of a dataset, written as dot-separated qualifiers of up to eight characters each.
- High-level qualifierThe first part of a dataset name, which usually identifies the owner and drives how security and storage rules apply.
- VolumeA single unit of disk storage with a six-character label, on which datasets are placed.
- IDCAMSThe utility used to create, list, copy and delete datasets, and the standard tool for anything involving VSAM.
- DispositionThe DISP parameter, which says whether a dataset already exists, and what to do with it when the step ends normally or fails.