Dataset names and what they tell you
A dataset name is not free text. It is a series of qualifiers separated by dots, each up to eight characters, up to 44 characters in total. At almost every site the qualifiers encode environment, application and content — so the name alone tells you a great deal.
The rules
- Each qualifier is 1–8 characters, starts with a letter or national character, and contains letters, digits, and
@ # $. - The whole name is at most 44 characters including the dots.
- The first qualifier is the high-level qualifier (HLQ). It usually determines who can access the dataset and where it is catalogued.
- Names are always uppercase. There is no case sensitivity and no spaces.
- A member of a library is written
LIBRARY.NAME(MEMBER), and member names are up to 8 characters.
What a typical site encodes
| Position | Commonly means | Example |
|---|---|---|
| 1st | Environment or owner | PROD, TEST, DEV, or a userid |
| 2nd | Application or system | PAY, GL, CARD, CLM |
| 3rd | Content or file type | MASTER, TRANS, JCLLIB, SOURCE, LOADLIB |
| 4th+ | Date, cycle, or generation | D20260930, G0042V00 |
The names you will keep seeing
| Suffix | Holds |
|---|---|
| SOURCE / SRC | Program source code |
| COPYLIB / COPYBOOK | Shared record layouts included into programs |
| LOADLIB / LOAD | Executable load modules |
| JCLLIB / CNTL | JCL members |
| PROCLIB | Catalogued procedures |
| MASTER | A permanent master file |
| TRANS | Transaction input for a batch run |
| REPORT / RPT | Formatted output |
A dataset name, piece by piece
PROD.PAY.MASTER.G0012V00Try it yourself
What is the maximum length of a single qualifier in a dataset name?
Show a hint
The whole name can be 44 characters including dots.
Show the solution
8 characters, starting with a letter or national character (@ # $).
Common mistakes
Storage management rules often key on the HLQ. A non-standard name may be rejected, or land on the wrong storage with the wrong backup policy.
Easy to do with date qualifiers. The allocation fails with a message that names the length limit.
Check the HLQ against the site standard rather than assuming. PRODTEST is not PROD.
What you will see at work
- Access control is usually granted on name patterns, so the HLQ decides what you can see. 'I cannot find that dataset' often means 'I am not permitted to see it'.
- Backup and retention policies are also driven by name patterns. Putting real data under a scratch HLQ means it may not be backed up.
- Your personal libraries usually start with your userid, and are the one place you can name things freely.
Key terms
Check your understanding.
Take this lesson's quiz and save your progress. Free.