FILES directive

The FILES directive is used to specify the files that the z/OS® DLA reads and associates with discovered resources. This directive impacts Report and Appdesc objects provided in books. z/OS DLA will create Report and Appdesc objects for most installations. However, if you have customized standard data sets, you might need to indicate that customization in FILES directives.

Syntax: FILES objtype.filetype.jobprefix dsn;report

Where:
objtype
One of the following object types:
  • ZOS
  • TASK
  • IMS
  • CICS
  • DB2
  • MQ
  • WEBSPHERE
filetype
One of the following file types:
  • REPORT
  • APPDESC
jobprefix
Optional jobname prefix criteria.
dsn
The name of the data set to read.
report
Optional report name. The default is the name of the data set.
Example:
*FILES ZOS.REPORT dataset;report_name
*FILES TASK.REPORT.jobprefix dataset;report_name
*FILES MQ.REPORT.jobprefix dataset;report_name
*FILES MQ.APPDESC.jobprefix dataset
*FILES IMS.REPORT.jobprefix dataset;report_name
*FILES IMS.APPDESC.jobprefix dataset
*FILES DB2.REPORT.jobprefix dataset;report_name
*FILES DB2.APPDESC.jobprefix dataset
*FILES CICS.REPORT.jobprefix dataset;report_name
*FILES CICS.APPDESC.jobprefix dataset
*FILES WEBSPHERE.REPORT.jobprefix dataset;report_name
*FILES WEBSPHERE.APPDESC.jobprefix dataset

The REPORT files are shown in the TADDM Report tab in the z/OS and Subsystem Detail View pane.

The APPDESC files are TADDM Application Descriptor files, which can be used to profile a subsystem with a Business Application. For more information, see Tivoli Application Dependency Discovery Manager documentation. The following example is the Application Descriptor XML markup:
<component-app-descriptor app-instance-name="Order Management" >
<component-descriptor
type="server"
name="zApp1"
functional-group="zApp Tier"
marker-module="false"
/>
</component-app-descriptor>

If this markup is saved into a member in the TADDM.APPDESC.PDS, the FILES MQ.APPDESC TADDM.APPDESC.PDS(*) rule associates all discover MQ subsystems with this AppDescriptor.