CSV and XML File Production › Generating XML Files › Multiple Report Considerations

Multiple Report Considerations

The XML writer can produce multiple XML documents during a single CA JARS run. Each report produced in a run can also be produced in XML. There are some considerations however:

• Documents that are written to the same ddname are concatenated to each other. If report A in a run is followed by report B, and both write XML to the same ddname, the XML for report B is appended to the XML for report A. This applies to report data documents as well as schemas.
• If multiple documents are written to the same data set from different job steps, only the documents written in the last step are kept. This applies to report data documents as well as schemas.

We recommend that separate DD statements be used for all XML documents and schemas needed in a CA JARS run. If multiple reports are in the run, each report should have its own set of XML and schema ddnames.

You can create Comma Separated Value (CSV) files compatible with the CA NSM APIs using the CA Earl Report Writer. Two new files are introduced with this feature; the CAIJSCSV file and the CAIJSIDX file.

The CAIJSCSV file is a Partitioned Data Set (PDS) that acts as a repository for the CSV files. The CAIJSIDX file is an index file that contains information about CSV files that have been created, and where they reside.

The members of the CAIJSCSV PDS are named using pattern AAAAnnCC, where the prefix AAAA may be user-specified through the 'SET MEM=' command in the CA Earl module, nn is a numeric starting with '01' and incrementing as each member is created in the PDS during a single run, and the 'CC' is a constant. If you do not specify a member prefix, the name will default to 'CSVM.'

For a given CA Earl run, one member is created for each date found on the CA JARS ACCT or History file input. For example, if your input file has data from 3, 4, and 5 September, the CA Earl run with an empty CAIJSCSV PDS will create members CSVM01CC, CSVM02CC, and CSVM03CC.

The PDS is a variable blocked file with an LRECL of 512 bytes and a default BLKSIZE of 5124 bytes. These values can be changed in your JCL. The CAIJSCSV PDS is defined as a Generation Data Group (GDG) type data set (recommended) to allow for repeated executions of CA Earl jobs that create CSV files (weekly, for example).

The reports provided for the user are in CAJREARL, member names ERXT0262 through ERXT0269.