8.4.2 Extracting Scenario Metadata

Scenario metadata includes XML files that contain the table data for scenario, dataset, and network logic.

The sm_extract.sh script invokes a Java tool, which creates these files. You start this script as follows:

 sm_extract.sh <mode> -notarget | -target <name>

where:

• mode (mandatory) is the scenario, network, or dataset.
• -notarget, if included, implies that the system does not save the target environment to the generated XML files.
• -target <name> identifies the same target (in <name>) for all extracted XML files.

If you do not specify -notarget or -target <name> on the command line, the system prompts you to supply a target environment on each extracted file.

To extract scenario, dataset, and network metadata, follow these steps:

1. Navigate to the cd <OFSAAI Installed Directory>/db_tools directory.
2. Edit the metadata configuration files with identifying information for the scenarios, datasets, or networks for extraction:
   • <scnro_ctlg_id> in the scnros.cfg file and/or
   • <scnro_ctlg_id>.<scnro_id> in the scnros.cfg file

     Note:

     Providing both <scnro_ctlg_id> and <scnro_id> in the scnros.cfg file allows finer granularity when extracting scenarios. If you provide both a scenario catalog ID and a scenario ID on a line, you must separate them with a period.
   • <data_set_id> in the dataset.cfg file
   • <network_id> in the network.cfg file
3. Execute the sm_extract.sh script in this order:
   1. Enter sm_extract.sh dataset to extract dataset metadata.
   2. Enter sm_extract.sh scenario to extract scenario metadata.
   3. Enter sm_extract.sh network to extract network metadata.