Delivery Manager Tool DMT on Documentation - V2

Delivery Manager Tool - FAQ

Mon, 01 Jan 0001 00:00:00 +0000

What are the impacts of killing the DMT process ?

There is no impact.
But if you kill the process during the extraction, it may lead to some issues .The issue is that you cannot not execute the extraction again (lock on some files).
Workaround: If you have several versions, is to clean the delivery folder :You need to keep the package folder, but you can remove all the files inside these folders.

List of return values in DMT CLI Java Code

Delivery Manager Tool - Information - Extracting Folder while excluding all its sub folders in TFS server

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

When we want to exclude several folders from the extraction in the repository, what we do is to select the root folder and under that folder we check the folders we want to analyze .The ones we do not want to analyze remains unchecked.
But what if you have in the same level as the folders being excluded ,there is a csproj and you need to analyze it while excluding all other sub-folders and files in it.
This page will illustrate how to use a regular expression to achieve this.

Delivery Manager Tool - Information - File extensions discovered as Mainframe

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This document will list out the various file extensions that are discovered as Mainframe project.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS	✅

Details

The file type extension per language for Mainframe are as listed below:

CICSLanguage: *.csd;*.cics;*.bms"
CobolIncludeLanguage: *.cpy
CobolLanguage: *.cob;*.cbl;*.pco;*.sqb;*.cpy;*.cop;*.cpb
IMSLanguage: *.dbd;*.psb
JCLLanguage: *.jcl;*.prc;*.mbr;*.inc

Notes/comments

Delivery Manager Tool - Information - File Types and folders which can be ignored

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

Best Practices while packaging DMT is to ignore the files (types) and folders which are not useful for the analysis.

We can use these following information when we have performance issues in DMT or we run into errors like

Java Heap Space
The program delivery manger tool has not ended correctly error code 1000

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS3	✅
CSS2	✅

File types which can always be ignore

Delivery Manager Tool - Information - How to add java console debugging to diagnose JNLP and DMT issues while clicking on AICPortal

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page will help you to add java console debugging to diagnose JNLP/DMT issues and enable more traces for debug issues.

Applicable in CAST Version

Release	Yes/No
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	❌

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS1	❌

Details

Just edit
C:\Users<user>\AppData\LocalLow\Sun\Java\Deployment\deployment.properties
Add these 3 lines at end of file :
deployment.trace=true
deployment.trace.level=all
deployment.console.startup.mode=SHOW
Try reproducing by clicking to jnlp shortcut and you will have a popup window which appears(Java Console) which will have the traces from the content.
This Java console window may not appear depending on settings in java control panel, so a better way to get latest trace file is to get the generated log file under:
C:\Users<user>\AppData\LocalLow\Sun\Java\Deployment\log\javawsxxxxxxxxxxxx.trace

Note: To restore previous situation, remove added lines.

Delivery Manager Tool - Information - How to change the url of the AIC PORTAL in DMT

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

If the AICPortal is moved to some other place the DMT installed will still refer to the old url of the AIC Portal. To make these old DMTs still working we need to redirect them to the new AIC Portal

Applicable in CAST Version

Release	Yes/No
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	❌

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS1	✅

Details

Delivery Manager Tool - Information - How to exclude files for DOTNet analysis

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page provide information how to exclude files for .Net analysis.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	❌

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS1	❌

Details

Files can be excluded from the analysis using DMT with the option “Folders or files to ignore” as mentioned below.

However there will be some error/warning in analysis log for can not read files since it is still referenced in csproj.

Delivery Manager Tool - Information - How to get the list of custom plugins

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page provides you with the method to retrieve the list of custom plugins that have been installed by a user.

For more information, refer to:

For CAST AIP Version 8.0.x and higher : Pages Extending CAST AIP > Skip to end of banner > Go to start of banner > Install an extension > Step 2: Handle DMT plugins

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅
7.3.x	✅

Applicable RDBMS

Delivery Manager Tool - Information - How to Package Java applications using the Delivery Manager Tools

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page advise you on how to package a Java Application based on Maven and Eclipse projects.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS3	✅
CSS2	✅

Details

Qualify the application: maven, eclipse, both or another?

Currently, in CAST AIP, we’re covering 2 main cases: maven and eclipse.
The fact that the source code is containing maven (pom.xml) or eclipse (.project + .classpath) files is a good starting point to automate the configuration of the analysis but it is not enough to qualify an application. What we really need to know is what method is being used to build the source code and/or what method is being used by developers in the IDE to maintain the projects. Typically we can have old pom.xml with the source code that are not maintained anymore and the reference to use for the configuration is the eclipse files.

Delivery Manager Tool - Information - How to reproduce a DMT issue in Discovery Selection or Validation steps

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page provides you with the way to reproduce an issue encountered in Discovery, Selection or Validation steps, when packaging Files System.

For more information, refer to:

For 8.3.x : Official documentation : Source code delivery - an introduction
For 7.3.x: Online help : Delivery Manager Tool online-help : CAST Delivery Manager Tool

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅

Applicable RDBMS

Delivery Manager Tool - Information - How to run the DMT with java

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page explains how to execute the DMT using your Java Home and not using CAST MS.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS1	❌

Details

If you need to run the DMT with your JRE to avoid any limitation linked to the CAST MS JRE and memory limitation, use the below command lines. Visit the following page to get the application id and the version id: Delivery Manager Tool - Information - DELIVERY Folder Structure and Contents

Delivery Manager Tool - Information - How to verify the installation of an extension

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page provides checks to verify the proper installation of an extension in the CAST AIP platform.

For more information, refer to:

Official documentation:
- General Extension Information (explanations, download, install, etc): General Extension
- Specific Extension Information (specific versions, support, etc): Specific Extension

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅

Details

Here are the checks to be made to verify that an extension is properly installed:

Delivery Manager Tool - Information - How to view CastLog2 files on the system which does not have CAST AIP installed

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This guide will help one to view the CastLog2 files with the CASTLog2Viewer.exe on the system which does not have CastAIP installed. Usually if you see the log from the DMT application it will be opened with CastLog2Viewer.exe but when trying to open the logs from the folder you can use this solution.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅
7.3.x	✅
7.2.x	✅
7.0.x	❌

Applicable RDBMS

Delivery Manager Tool - Information - JEE Maven Http Extractor - How to reproduce user issues

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page explains how to reproduce issues using the JEE Maven Http Extractor.

The Maven HTTP Extractor is always associated with Files on your file system package for which Maven alerts have been raised.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅
8.1.x	✅
8.0.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅

Action plan

Perform the following steps to reproduce JEE Maven Http Extractor user issues:

Delivery Manager Tool - Information - Large files in LISA folders

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page provides information on large files found in the LISA folder related to the Delivery Manager Tool DMT, like the one shown below:

For more information, refer to:

For 8.3: Official documentation CMS - Preferences - Platform Settings

Applicable CAST Version

Release	Yes/No
8.2	✅
8.3	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	N/A
Microsoft SQL Server	N/A
CSS3	N/A
CSS2	N/A

Details

You may see large files in the LISA folder which are CAST Configuration files which contain all the configuration and referenced details of each Analysis unit for the called libraries.

Delivery Manager Tool - Information - Package Extraction - Creating repositories of jars when not present in project

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page describes the process to create repositories of jars if they are not found in the project.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS	✅

Details

If you do not have jars in projects,you can rebuild the project.For the same,you should have the parent pom.xml file and maven plugin.

Maven provides a command line tool. To use this tooling, switch to the command line into a directory which contains a pom.xml.

Delivery Manager Tool - Information - Package Extraction - How to get Castextraction file

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page provides information on how to get the .castextraction file.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS3	✅

Details

Here this page is explained by taking an example for Sybase, however this is valid for Oracle, MS SQL server, DB 2 as well.

In Delivery Manager Tool, we have two option for the extraction:

Delivery Manager Tool - Information - PDS Dump Extractor - Multiple banner Prefix for PDS Dump

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page gives you more about the usage of Banner Prefix while configuring a PDS dump extractor package in DMT.
This page gives you an approach when there is multiple banner prefix in one PDS Dump.

What is a Mainframe PDS dump?

The Mainframe PDS dump option is designed for target Mainframe source code (Cobol, JCL etc.) which is the result of a PDS (Partitioned Data Set) dump.
A PDS is a type of “library” containing elements known as “members” exported from a z/OS system. A PDS can only contain one type of member (eg. Cobol programs, copybooks, JCL etc.) Each member in the PDS is preceded by a banner containing the member’s name (among other information) and is concatenated with other elements in text format.

Delivery Manager Tool - Information - Project Remediation - Remediate packaging alerts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

To remediate the packaging alerts found while packaging.

In Delivery Manager Tool,while packaging the project,there might be alerts.If these alerts are not remediated,some of the files will not be analyzed in CAST-MS

Alerts can be for different reasons like:

Undefined variable
Missing Project
Missing file
Missing folder
Missing resource

Alerts generally indicate that the source code package is incomplete, that there is something wrong in the source code.

Delivery Manager Tool - Information - Package Extraction - How to identify whether the castextraction is Vanilla or Project

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This page provides information on how to identify whether the Siebel castextraction files are Vanilla or Project.

Applicable in CAST Version

Release	Yes/No
8.3.x	✅
8.2.x	✅

Applicable RDBMS

RDBMS	Yes/No
Oracle Server	✅
Microsoft SQL Server	✅
CSS2	✅
CSS3	✅

Details

To find whether the castextraction file generated for Siebel is Vanilla or Project, you need to unzip the castextraction file and check the manifest.mf file.

Delivery Manager Tool DMT on Documentation - V2

Delivery Manager Tool - FAQ

Delivery Manager Tool - Information - Extracting Folder while excluding all its sub folders in TFS server

Delivery Manager Tool - Information - File extensions discovered as Mainframe

Delivery Manager Tool - Information - File Types and folders which can be ignored

Delivery Manager Tool - Information - How to add java console debugging to diagnose JNLP and DMT issues while clicking on AICPortal

Delivery Manager Tool - Information - How to change the url of the AIC PORTAL in DMT

Delivery Manager Tool - Information - How to exclude files for DOTNet analysis

Delivery Manager Tool - Information - How to get the list of custom plugins

Delivery Manager Tool - Information - How to Package Java applications using the Delivery Manager Tools

Qualify the application: maven, eclipse, both or another?

Delivery Manager Tool - Information - How to reproduce a DMT issue in Discovery Selection or Validation steps

Delivery Manager Tool - Information - How to run the DMT with java

Delivery Manager Tool - Information - How to verify the installation of an extension

Delivery Manager Tool - Information - How to view CastLog2 files on the system which does not have CAST AIP installed

Delivery Manager Tool - Information - JEE Maven Http Extractor - How to reproduce user issues

Delivery Manager Tool - Information - Large files in LISA folders

Delivery Manager Tool - Information - Package Extraction - Creating repositories of jars when not present in project

Delivery Manager Tool - Information - Package Extraction - How to get Castextraction file

Delivery Manager Tool - Information - PDS Dump Extractor - Multiple banner Prefix for PDS Dump

Delivery Manager Tool - Information - Project Remediation - Remediate packaging alerts

Delivery Manager Tool - Information - Package Extraction - How to identify whether the castextraction is Vanilla or Project