IdML file naming conventions
Discovery library books are stored in plain text XML files that must follow a consistent file naming convention. The file name includes information to uniquely identify the discovery library book in the DLFS and to help developers and administrators quickly identify the source and creation date of the discovery data.
- The CICS application code CICSTSnnnbooktype.application.,
where:
- nnn is the CICS version identifier, for example “410”.
- booktype identifies the type of discovery library book, for example “CTSPLEX”.
- application is the name of the CICSplex or CICS region from which the data is derived, which is the CMAS name for the CTSPLEX summary discovery library book.
- The host name, for example: @mvs2c.example.com.
- An ISO 8601 time stamp UTC (Coordinated Universal Time), with colons (:) replaced by dots (.), for example: 2008-03-08T12.05.31Z.
- The text string “.refresh” when the discovery library book contains a refresh operation.
- A file name extension of “.xml”.
A slightly different naming convention applies to discovery library books when they are being written or copied to the DLFS. In this case, the file name of the discovery library book must contain the suffix “.partial” following .xml. The “.partial” suffix is removed from the file name when the operation of writing the file to the DLFS has been successfully completed.
Sample file names
The following file name example is for a discovery library book that is in the DLFS:
CICSTS410CICSPLEX.plex1@mvs2c.example.com.2008-11-07T14.32.31Z.xml
The
following file name example is for a discovery library book that is
in the DLFS that contains a refresh operation:CICSTS410CTSPLEX.cmasa@mvs2c.example.com.2008-11-07T14.32.31Z.refresh.xml
CICSTS410CICSREGION.plex1.cicsa@mvs2c.example.com.2008-11-08T14.32.31Z.xml.partial