Dataset name
The full name of a dataset: qualifiers of up to eight characters, joined by full stops.
Also written DSN, DSNAME, data set name
Why it matters. A name that breaks the rules is refused before anything is made. Every JCL and command uses these names.
See it
Syntax
qualifier.qualifier.qualifier
ALLOCATE DATASET('HLQ.QUAL.QUAL') NEW- Qualifier
- 1 to 8 characters, joined by full stops.
- First character
- A letter, or # @ $. Not a digit.
- Other characters
- Letters, digits, # @ $ and hyphen.
- Whole name
- Up to 44 characters, including the full stops.
- Member
- In brackets after the name: NAME(MEMBER).
Try it ALLOC
- 1
Try to make a file called ZB0001.DEV.CUSTOMERS. Look at the last part of the name.
ALLOC DSN('ZB0001.DEV.CUSTOMERS') NEW - 2
Make it again with a name that fits: ZB0001.DEV.CUSTOMER.
ALLOC DSN('ZB0001.DEV.CUSTOMER') NEW
Remember
- A name is qualifiers joined by full stops, from general to specific.
- One qualifier is 1 to 8 characters. The whole name is 44 at most.
- Each qualifier starts with a letter or one of # @ $.
The usual mistake
ZB0001.DEV.CUSTOMERS
The last qualifier has nine characters. The limit is eight.
ZB0001.DEV.CUSTOMER
On real z/OS
The refusal shown here is a Mainframe101 sim: note. Real TSO refuses a bad name with its own message, such as IKJ56702I INVALID DATA SET NAME. In quotes a name is used as written; without quotes TSO adds your prefix in front.
Where can I practise Dataset name?
Right here, at ZedBank. You take a junior job at a simulated bank and use Dataset name in real work, with Zed beside you. There's nothing to install.
Start at ZedBankRelated
- DatasetWhat a mainframe calls a file: a named collection of records with a defined structure, rather than a loose stream of bytes.
- High-level qualifierThe first part of a dataset name, which usually identifies the owner and drives how security and storage rules apply.
- CatalogThe system's index of where datasets live, so you can refer to a dataset by name without knowing which disk it is on.
- Dataset profileA security rule describing which datasets it covers and who is allowed to do what to them.