Processing Summary
To provide a better understanding of the RTC2AD tool,
check the following summary of the processing steps that the tool performs:
- Read the configuration file and ensure that all necessary keywords are set.
- Verify the existence of AD subfolders. If necessary,
create an
EWM_AD
sandbox directory. - Set the PATH, CLASSPATH, and JAVA_HOME environment variables.
- Test the call to scm.exe and run the test call to Java™ utility to confirm that PATH and CLASSPATH environment variables are set correctly.
- Log on to EWMJazz® team server with the user credentials sourced from config file.
- Read the stream list file.
- Follow these steps for each stream present in the list file:
- Create a temporary EWM workspace and load it with the EWM stream.
- Retrieve the list of all components in the stream from EWM, save in temporary working file.
- Follow these steps for each component in the stream:
- If pass list file exists, check whether the component is on it, else skip component.
- If no pass list file exists, process every component in the stream.
- Retrieve the list of all objects contained in the EWM component.
- Filter out only the zFile names and save them in a local file.
- Load all the zFile from EWM into the local file system sandbox.
- Follow these steps for each zFile:
- Check for the file extension. If the file extension exists, check if the mapping to source type exists.
- If the file extension is on exclude list, ignore it and proceed with next file.
- In case that no file extension is present, or extension is not mapped to source, call Java source classifier utility.
- If classifier can’t resolve the source, write the file name in the global unresolved file.
- If the source type is resolved, update the file list with the member’s type.
- Map the resolved source type to the correct AD source type sub folder.
- Based on type, update the file list with the member’s target AD project sub folder.
- After each file in the component is processed, build a file of copy commands.
- A copy command is generated only if the file source type is resolved and type maps to AD folder.
- Run the batch of copy commands, copying the file from local sandbox to the correct AD subfolder.
- Repeat the loop to process the next EWM component defined in the stream.
- When all EWM components in stream are processed, loop to the next stream specified in config.
- When all specified streams are processed, delete the temporary EWM workspace.
- Log off from EWM Jazz team server.