Specifying Files on Mainframe Systems

Mainframe file names can be up to 55 characters in any of the following formats:

  • <tag> DD:ddname
  • <tag> DD:ddname(member)
  • <tag> 'qualifier.qualifier.qualifier'
  • <tag> 'qualifier.qualifier.qualifier(member)'

Where:

  • ddname is the data definition of the file in your JCL
  • member is the member name of a PDS
  • qualifier is a node of a data set

Alternatively, mainframe file names can be specified in this format:

<tag> JES:DD:ddname

Where ddname is the data definition of the file in your JCL. To access the JES2 spool use <FILE> JES:DD:ddname. The ddname contains one record to identify the spool file in the following comma-delimited format:

JobNumber,JobName,StepName,ProcName,DDName

Where:

  • JobNumber is the job that created the JES file
  • JobName is the name of the job that created the JES file
  • StepName is the name of the job step that created the JES file
  • ProcName is the name of the procedure used, if applicable
  • DDName is the name of the DD that specifies the JES file

You can omit ProcName by placing two commas after StepName.

Note: In rule files, quotation marks indicate a word or phrase that contains blanks or special symbols. Therefore, when using mainframe file specifications in rule files, you must surround fully-qualified file names with double and single quotation marks so that the single quotation marks will be kept with the file specification.