Page tree
Skip to end of metadata
Go to start of metadata

This documentation is no longer maintained and may contain obsolete information. You should instead refer to https://github.com/CAST-Extend/com.castsoftware.aip.console.tools for more information about automating source code delivery/analysis with AIP Console.

In this section:

Target audience:

  • CAST administrators
  • Delivery Managers
Summary: This section of documentation provides an explanation of how to deliver source code in an automated and repeatable way.

Introduction

How does it work?

The CLI for the CAST Delivery Manager Tool has two modes, just like the GUI:

  • With a CAST AIC Portal > i.e. when working with a CAST AIC Portal (via JNLP)
  • Without a CAST AIC Portal > i.e. when working directly with the Delivery folder when no CAST AIC Portal is deployed (in GUI mode this is achieved using the CAST Management Studio)

The documentation is therefore divided into two distinct sections, listing commands that work with a CAST AIC Portal and those that work without a CAST AIC Portal.

CAST AIC Portal mode

In CAST AIC Portal mode, the CAST Delivery Manager Tool GUI is launched from the CAST AIC Portal using the Java Network Launch Protocol (JNLP). The same is true for the command line utility and as such, CAST highly recommends that you use batch files containing the required instructions to run your operations in this mode. The batch file requires certain common configuration parameters, and then commands and parameters that are specific to each action. These are explained below.

Please note that when launching the CAST Delivery Manager Tool using the CLI mode for the first time, you may be prompted that the application represents a security risk - which can hinder command line operations. Please do the following to prevent this dialog box displaying again in subsequent command line operations:

  • Tick the "Do not show this again..." option
  • Click Run.


Prerequisites

Before you can starting using the CLI in CAST AIC Portal mode you must ensure that you meet the following requirements:

(tick)All Delivery Managers must be working in CAST AIC Portal mode (i.e. using the DMT as a standalone tool installed from the CAST AIC Portal).
(tick)All Delivery Managers must have already downloaded and installed the CAST Delivery Manager Tool from the CAST AIC Portal and have the corresponding Application in their local cache of the DMT data.


If your environment uses a web proxy to control or improve performance of internet or intranet access, please see Notes for using the CAST Delivery Manager Tool CLI via a web proxy.

Required common batch file parameters

 Click here to expand...

Each batch file you create requires the following common parameters to launch the CAST Delivery Manager Tool in command line mode - you should modify them all (except the JNLP_FILE parameter) and match them to your local environment:

Windows

REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=<name of machine hosting CAST AIC Portal - see below>
set AICPORTAL_PORT=<port used by the application server hosting the CAST AIC Portal, e.g.: 8080>
set AICPORTAL_WEBAPP=<Name of the CAST AIC Portal web application, e.g.: CAST-AICPortal>
set APPLICATION_ID=<Application ID - this can be found in the DMT in the Application screen and will consists of a string of random characters and letters - see below>
set AUTH=<The DMT requires authentication with CAST AIC Portal credentials prior to launch - see below for format>
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

Linux

AICPORTAL_HOST=<name of machine hosting CAST AIC Portal - see notes below>
AICPORTAL_PORT=<port used by the application server hosting the CAST AIC Portal, e.g.: 8080>
AICPORTAL_WEBAPP=<Name of the CAST AIC Portal web application, e.g.: CAST-AICPortal>
APPLICATION_ID=<Application ID - this can be found in the DMT in the Application screen and will consist of a string of random characters and letters - see notes below>
AUTH=<The DMT requires authentication with CAST AIC Portal credentials prior to launch - see notes below for format>
JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP

Notes on parameters

AICPORTAL_HOST

Please note that the value used in the AICPORTAL_HOST variable is case sensitive. Ensure that you use the SAME case for the CAST AIC Portal host name as used when accessing the CAST AIC Portal in your web browser to download the GUI version of the CAST Delivery Manager Tool. This can be determined by looking at the start menu item for the GUI version of the CAST Delivery Manager Tool installed on your workstation.

For example - the host name is displayed as highlighted below:

Failure to do so will cause a second instance of the CAST Delivery Manager Tool to be downloaded when you run the batch file, and this will point to a different local workspace.

APPLICATION_ID

You can determine the APPLICATION_ID value in the CAST Delivery Manager Tool:

AUTH

The DMT requires authentication with the CAST AIC Portal credentials prior to launch - and this applies in command line mode as well as in GUI mode. Use the following format to define the credentials that you wish to use to authenticate when the command line is run - the example below shows the default "cast" username with the default "cast" password (modify this as required):

set AUTH=-username cast -password cast

This will send the username and password in clear-text - if you need to encrypt the password to improve security (highly recommended), you should instead generate an encryption key (please see Encrypting the password for the CAST Delivery Manager Tool command line for more information) for your password and use it as follows:

set AUTH=-username cast -authkey <your encrypted key>

For example:

set AUTH=-username cast -authkey u0tjM5qkCZO8IpzrD0CYUw==

If the authentication fails (incorrect username/password, or user not authorised), then the action specified in the command line will fail. If any errors occur, they will be logged in the latest CAST-jnlpInstaller.CastLog2 file created in C:\Users\<user_name>\AppData\Local\Temp, as shown by the following dialog:

Clicking OK will cause another dialog to be displayed: 


By clicking the Details button you can see the java exception stack trace:

Command arguments

AutomateVersion

 Click here to expand...

This option will automate:

  • the creation of a new Version (copied from an existing version)
  • the packaging of the exact same packages in the copied Version
  • delivery of the new Version with the "close" option (i.e. the delivery is complete).

In other words this is a complete "rescan" mode".

application<string>The name of the Application which contains the Version to copy.
[version<string>]The name of the version to copy. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the copy.
name<string>The name of the new Version.
[releaseDate<date>]The release date. This parameter is optional (defaults to current date if not set).
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!
[username<string>]Specifies the username to authenticate against the CAST AIC Portal.
[password<string>]Specifies the password to authenticate against the CAST AIC Portal.
[authkey<string>]Specifies the authentication key to decode and authenticate against the CAST AIC Portal.
[proxy<string>]Specifies the proxy to be used to connect to the CAST AIC Portal.
[pxUsername<string>]Specifies the username to authenticate against the proxy.
[pxPassword<string>]Specifies the password to authenticate against the proxy.
[pxAuthkey<string>]Specifies the authentication key to decode and authenticate against the proxy.

Example batch files

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = AutomateVersion
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================

set APPLICATION=MEUDON
set VERSION=V1
set NAME=V2
set RELEASE_DATE=201809211700
set LOG_FILE_PATH=C:\TEMP
set ACTION_AUTOMATE=AutomateVersion -application \"%APPLICATION%\" -version \"%VERSION%\" -name \"%NAME%\" -releaseDate \"%RELEASE_DATE%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_AUTOMATE%"


Linux
AICPORTAL_HOST=ceiriad
AICPORTAL_PORT=8080
AICPORTAL_WEBAPP=CAST-AICPortal
APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
AUTH=-username cast -password cast
JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP

APPLICATION=MEUDON
VERSION=V1
NAME=V2
DATE=`date '+%Y%m%d%H%M'`
RELEASE_DATE=$DATE
LOG_FILE_PATH="log1"
ACTION_AUTOMATE="AutomateVersion -application \"$APPLICATION\" -version \"$VERSION\" -name \"$NAME\" -releaseDate $RELEASE_DATE -logFilePath \"$LOG_FILE_PATH\""

"/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_AUTOMATE"

AddVersion

 Click here to expand...

This option will automate the creation of a new Version (copied from an existing version).

[application<string>]The name of the Application which contains the Version to copy. This parameter is optional.
[version<string>]The name of the version to copy. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the copy.
name<string>The name of the new Version.
[releaseDate<date>]The release date. This parameter is optional (defaults to current date if not set).
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!
[username<string>]Specifies the username to authenticate against the CAST AIC Portal.
[password<string>]Specifies the password to authenticate against the CAST AIC Portal.
[authkey<string>]Specifies the authentication key to decode and authenticate against the CAST AIC Portal.
[proxy<string>]Specifies the proxy to be used to connect to the CAST AIC Portal.
[pxUsername<string>]Specifies the username to authenticate against the proxy.
[pxPassword<string>]Specifies the password to authenticate against the proxy.
[pxAuthkey<string>]Specifies the authentication key to decode and authenticate against the proxy.

Example:

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = AddVersion
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================

set APPLICATION=MEUDON
set VERSION=V1
set NAME=V2
set RELEASE_DATE=201809211700
set LOG_FILE_PATH=C:\TEMP
set ACTION_AUTOMATE=AddVersion -application \"%APPLICATION%\" -version \"%VERSION%\" -name \"%NAME%\" -releaseDate \"%RELEASE_DATE%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_AUTOMATE%"
Linux
AICPORTAL_HOST=ceiriad
AICPORTAL_PORT=8080
AICPORTAL_WEBAPP=CAST-AICPortal
APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
AUTH=-username cast -password cast
JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP

APPLICATION=MEUDON
VERSION=V1
NAME=V2
DATE=`date '+%Y%m%d%H%M'`
RELEASE_DATE=$DATE
LOG_FILE_PATH="log1"
ACTION_AUTOMATE="AddVersion -application \"$APPLICATION\" -version \"$VERSION\" -name \"$NAME\" -releaseDate $RELEASE_DATE -logFilePath \"$LOG_FILE_PATH\""

"/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_AUTOMATE"

Generate

 Click here to expand...

This option will automate the packaging action in the CAST Delivery Manager Tool.

[application<string>]The name of the Application which contains the Version to package. This parameter is optional.
[version<string>]The name of the version to package. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the package action.
[package<string>]

The name of the package to generate (if you want to generate a single package).

[reset[<boolean>]]If true, forces extraction of the package content (equivalent to the GUI option "Force extraction"). Default: false.
[forceScan[<boolean>]]If true, this option ensures the re-scanning of the source code (equivalent to the GUI option "Force scan"). This is necessary only when updating CAST AIP Extentions and the re-extraction
of the source code is not needed. Default: false.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!
[username<string>]Specifies the username to authenticate against the CAST AIC Portal.
[password<string>]Specifies the password to authenticate against the CAST AIC Portal.
[authkey<string>]Specifies the authentication key to decode and authenticate against the CAST AIC Portal.
[proxy<string>]Specifies the proxy to be used to connect to the CAST AIC Portal.
[pxUsername<string>]Specifies the username to authenticate against the proxy.
[pxPassword<string>]Specifies the password to authenticate against the proxy.
[pxAuthkey<string>]Specifies the authentication key to decode and authenticate against the proxy.

Example:

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = Generate
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================

set APPLICATION=MEUDON
set VERSION=V1
set PACKAGE=TEST_PACKAGE
set LOG_FILE_PATH=C:\TEMP
set ACTION_GENERATE=Generate -application \"%APPLICATION%\" -version \"%VERSION%\" -package \"%PACKAGE%\" -reset -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_GENERATE%"
Linux
AICPORTAL_HOST=ceiriad
AICPORTAL_PORT=8080
AICPORTAL_WEBAPP=CAST-AICPortal
APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
AUTH=-username cast -password cast
JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP

APPLICATION=MEUDON
VERSION=V1
PACKAGE=TEST_PACKAGE
LOG_FILE_PATH="log1"
ACTION_GENERATE="Generate -application \"$APPLICATION\" -version \"$VERSION\" -package \"$PACKAGE\" -reset -logFilePath \"$LOG_FILE_PATH\""

"/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_GENERATE"

Deliver

 Click here to expand...

This option will automate the delivery action in the CAST Delivery Manager Tool.

application<string>The name of the Application which contains the Version to deliver.
[version<string>]The name of the version to deliver. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the delivery action.
[package<string>]

The name of the package to deliver (if you want to deliver a single package).

[close[<boolean>]]If true, closes the delivery and makes it read-only (equivalent to the GUI option "Close"). Default: false.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!
[username<string>]Specifies the username to authenticate against the CAST AIC Portal.
[password<string>]Specifies the password to authenticate against the CAST AIC Portal.
[authkey<string>]Specifies the authentication key to decode and authenticate against the CAST AIC Portal.
[proxy<string>]Specifies the proxy to be used to connect to the CAST AIC Portal.
[pxUsername<string>]Specifies the username to authenticate against the proxy.
[pxPassword<string>]Specifies the password to authenticate against the proxy.
[pxAuthkey<string>]Specifies the authentication key to decode and authenticate against the proxy.

Example:

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = Deliver
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================

set APPLICATION=MEUDON
set VERSION=V1
set LOG_FILE_PATH=C:\TEMP
set ACTION_DELIVER=Deliver -application \"%APPLICATION%\" -version \"%VERSION%\" -close -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_DELIVER%"
Linux
AICPORTAL_HOST=ceiriad
AICPORTAL_PORT=8080
AICPORTAL_WEBAPP=CAST-AICPortal
APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
AUTH=-username cast -password cast
JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP

APPLICATION=MEUDON
VERSION=V1
LOG_FILE_PATH="log1"
ACTION_DELIVER="Deliver -application \"$APPLICATION\" -version \"$VERSION\" -close -logFilePath \"$LOG_FILE_PATH\""

"/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_DELIVER"

Refresh

 Click here to expand...

This option will automate the refresh action in the CAST Delivery Manager Tool - i.e. to "download" any changes (i.e. new Versions or Packages, or changes to Versions or Packages) that may have been made by other Delivery Managers.

application<string>The name of the Application which contains the Version to deliver.
[version<string>]The name of the version to deliver. This parameter is optional. If you omit it, then the most recent Version will always be used as the source for the delivery action.
[package<string>]

The name of the package to deliver (if you want to deliver a single package).

[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!
[username<string>]Specifies the username to authenticate against the CAST AIC Portal.
[password<string>]Specifies the password to authenticate against the CAST AIC Portal.
[authkey<string>]Specifies the authentication key to decode and authenticate against the CAST AIC Portal.
[proxy<string>]Specifies the proxy to be used to connect to the CAST AIC Portal.
[pxUsername<string>]Specifies the username to authenticate against the proxy.
[pxPassword<string>]Specifies the password to authenticate against the proxy.
[pxAuthkey<string>]Specifies the authentication key to decode and authenticate against the proxy.

Example:

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = Refresh
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================

set APPLICATION=MEUDON
set VERSION=V1
set LOG_FILE_PATH=C:\TEMP
set ACTION_REFRESH=Refresh -application \"%APPLICATION%\" -version \"%VERSION%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_REFRESH%"
Linux
AICPORTAL_HOST=ceiriad
AICPORTAL_PORT=8080
AICPORTAL_WEBAPP=CAST-AICPortal
APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
AUTH=-username cast -password cast
JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP

APPLICATION=MEUDON
VERSION=V1
LOG_FILE_PATH="log1"
ACTION_REFRESH="Refresh -application \"$APPLICATION\" -version \"$VERSION\" -logFilePath \"$LOG_FILE_PATH\""

"/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_REFRESH"

CreateVersionForLocal

Only available in CAST AIP 8.3.6.


 Click here to expand...

This option will create a new Version (from scratch) via the CAST AIC Portal. There is no need to clone an existing Version.

application<string>The name of the Application which contains the Version to deliver.
name<string>The name of the new Version to create from scratch.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!
[username<string>]Specifies the username to authenticate against the CAST AIC Portal.
[password<string>]Specifies the password to authenticate against the CAST AIC Portal.
[authkey<string>]Specifies the authentication key to decode and authenticate against the CAST AIC Portal.
[proxy<string>]Specifies the proxy to be used to connect to the CAST AIC Portal.
[pxUsername<string>]Specifies the username to authenticate against the proxy.
[pxPassword<string>]Specifies the password to authenticate against the proxy.
[pxAuthkey<string>]Specifies the authentication key to decode and authenticate against the proxy.

Example:

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = CreateVersionForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================

set APPLICATION=MEUDON
set NAME=V1
set LOG_FILE_PATH=C:\TEMP
set ACTION_CREATEVERSIONFORLOCAL=CreateVersionForLocal -application \"%APPLICATION%\" -name \"%NAME%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEVERSIONFORLOCAL%"
Linux
AICPORTAL_HOST=ceiriad
AICPORTAL_PORT=8080
AICPORTAL_WEBAPP=CAST-AICPortal
APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
AUTH=-username cast -password cast
JNLP_FILE=http://$AICPORTAL_HOST:$AICPORTAL_PORT/$AICPORTAL_WEBAPP/$APPLICATION_ID/dmt-launcher.jnlp?url=https%%3A%%2F%%2F$AICPORTAL_HOST%%3A$AICPORTAL_PORT%%2F$AICPORTAL_WEBAPP

APPLICATION=MEUDON
VERSION=V1
LOG_FILE_PATH="log1"
ACTION_CREATEVERSIONFORLOCAL="CreateVersionForLocal -application \"$APPLICATION\" -name \"$NAME\" -logFilePath \"$LOG_FILE_PATH\""

"/opt/jre1.8.0_171/bin/javaws" $JNLP_FILE -Xnosplash -silent -wait -open "$AUTH $ACTION_REFRESH"

CreatePackageForLocal

Only available in CAST AIP 8.3.6.

 Click here to expand...

This option will create a new Package via the CAST AIC Portal. You can configure all aspects of the package.

application<string>The name of the Application which contains the Version for your new Package.
versionName<string>The name of the Version for your new Package.
storagePath<string>The location (path) of the Delivery folder that contains the Application/Version in which you want to create the new Package.
packageType<string>

The type of package you want to create. Choose from one of the following:

packageName<string>The name of the package you want to create.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!

dmtdevdbtechno.SQLCASTDatabasePackage > Oracle Server

Requires the following options:

extractorType<string>

dmtdevsqlcastextractororacle.SQLCASTExtractor > CAST extractor for Oracle

host<string>Used to configure the host name of your Oracle Server. You can also enter an IP address if required.
port<string>

Used to configure the port number for accessing your Oracle Server. The default port number for Oracle Server is 1521.

service<string> or sid<string>

Choose either -service or -sid, i.e. the Service/SID name for accessing your database server.

Please note that when connecting to a "pluggable database" (for example in Oracle 12c and above) you MUST use the Service option - the SID option will not function.

loginName<string>Used to configure the user name that has sufficient privileges to access the required schemas on the selected server for packaging purposes. Please see the CAST Delivery Manager Tool help for more information about required privileges.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the database access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of the same schemas on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

[rootPaths<string>]

Use this option to select the schemas you wish to extract.

  • To extract an individual schema, enter the NAME of the schema
  • If you intend to extract an entire instance and all schemas, you can omit this option
  • If you intend to extract multiple schemas you can list them separated with a semi-comma (";").
  • Please ensure that you input the name of the schema in the correct case (i.e. upper or lower) as these fields are case sensitive - remember that the vast majority of Oracle schemas are in upper case.
  • If you have objects from different schemas on the same instance that are linked (i.e. inter-schema links such as "Database-Links" or between objects in different schemas) and you expect the analysis to detect and store these links, then you must ensure that you carry out ONE extraction on all the schemas involved (i.e. specify the schemas involved separated with a semi-comma). If you are unsure which schemas are involved, you can extract the entire instance by omitting the option, but this can affect performance.
  • The CAST Database Extractor will carry out an automatic validation of the information entered into this field to counter the incorrect use of case or the input of a non-existent schema/database. The extraction process will be stopped and an error will be displayed if the validation fails.

Example

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = CreatePackageForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================

SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevdbtechno.SQLCASTDatabasePackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevsqlcastextractororacle.SQLCASTExtractor"
SET HOST="ORASERVER"
SET PORT="1521"
SET SERVICE="ORADB1"
SET LOGIN_NAME="system"
SET LOGIN_PASSWORD="my_password"
SET REMEMBER_PASSWORD="Server"
SET ROOT_PATHS="CASTPUBS;COOLCLUBS;BI"
SET LOG_FILE_PATH="C:\TEMP"
SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -host \"%HOST%\" -port \"%PORT%\" -service \"%SERVICE%\" -loginName \"%LOGIN_NAME%\" -loginPassword \"%LOGIN_PASSWORD%\" -rememberPassword \"%REMEMBER_PASSWORD%\" -rootPaths \"%ROOT_PATHS%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"

dmtdevmainframetechno.MainframePackage > Mainframe (IBM zOS PDS (Partitioned Data Set) dump extraction)

Requires the following options:
extractorType<string>dmtdevmainframeextractor.MainframeExtractor > IBM zOS PDS (Partitioned Data Set) dump extraction
libraryFilePath<string> Enter the absolute location of your PDS dump file.
extension<string>

This option enables you to choose the content of the PDS dump file that will be extracted an packaged. Filters are based on file extensions and can be one of the following:

  • "CobolProgram" 
  • "CobolCopybook" 
  • "JCLJobProc" 
  • "JCLInclude" 
  • "IMSDBD" 
  • "IMSPSB" 
  • "CICSCSD" 
  • "CICSBMS"
banner<text>Indicates the left hand part of the banner in the PDS dump excluding the member name. This determines the start of each member - this is used by the CAST Delivery Manager Tool to identify each member.
leftMargin<integer>Indicates the line column(s) in which system characters are present. This column (or columns) are ignored during the extraction and packaging process and are not transferred to file.
lineMaxLength<integer>For each member line that will be extracted, this value indicates the line max size that will be retained during the extraction to file. Any characters that are located in the line beyond the line max size will be ignored during the extraction and packaging process and are not transferred to file.

Example

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = CreatePackageForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================


SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevmainframetechno.MainframePackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevmainframeextractor.MainframeExtractor"
SET LIBRARY="C:\PDS_DUMP"
SET EXTENSION="CobolProgram"
SET BANNER="VMEMBER NAME"
SET LEFT_MARGIN="1"
SET MAX_LENGTH="80"
SET LOG_FILE_PATH="C:\TEMP"
SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName "%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -libraryFilePath \"%LIBRARY%\" -extension \"%EXTENSION%\" -banner \"%BANNER%\" -leftMargin \"%LEFT%\" -lineMaxLength \"%MAX_LENGTH%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"

delivery.SourceFilesPackage > Files on your system

Requires the following options:

extractorType<string>dmtdevfolderextractor.SourceFolderExtractor > Folder on your local file system
folderPath<string> Enter the absolute location of the folder that contains your target source code. This can be a network location or a folder on your local machine.
[originalLocation<string>]

If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path).

Example

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = CreatePackageForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================


SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="delivery.SourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevfolderextractor.SourceFolderExtractor"
SET FOLDER_PATH="C:\SOURCE_CODE"
SET LOG_FILE_PATH="C:\TEMP"
SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -folderPath \"%FOLDER_PATH%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"

delivery.SourceFilesPackage > Subversion using svnkit

Requires the following options:
extractorType<string>dmtdevsvnextractor.SVNExtractor > Folder on your local file system
connectionURL<string>Enter the URL of your Subversion repository. You can use either the https:// or svn:// protocols.
revision<string>

Enter the specific revision of source code that you require, for example HEAD.

loginName<string>Used to configure the user name that has sufficient privileges to access the SVN repository.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the SVN access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

[originalLocation<string>]

If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path).

Example

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = CreatePackageForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================


SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="delivery.SourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevsvnextractor.SVNExtractor"
SET CONNECTION_URL="svn://server/trunk/test"
SET REVISION="HEAD"
SET LOGIN_NAME="svn_user"
SET LOGIN_PASSWORD="my_password"
SET REMEMBER_PASSWORD="Server"
SET LOG_FILE_PATH="C:\TEMP"
SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -connectionURL \"%CONNECTION_URL%\" -revision \"%REVISION%\" -loginName \"%LOGIN_NAME%\" -loginPassword \"%LOGIN_PASSWORD%\" -rememberPassword \"%REMEMBER_PASSWORD%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"

dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven HTTP repository

Requires the following options:
extractorType<string>dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor > Maven Http repository
connectionURL<string>Enter the URL of your Maven repository. You can use either the https:// or http:// protocols.
loginName<string>Used to configure the user name that has sufficient privileges to access the Maven repository.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the Maven access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

Example

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = CreatePackageForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================


SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor"
SET CONNECTION_URL="https://server/test"
SET LOGIN_NAME="maven_user"
SET LOGIN_PASSWORD="my_password"
SET REMEMBER_PASSWORD="Server"
SET LOG_FILE_PATH="C:\TEMP"
SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -connectionURL \"%CONNECTION_URL%\" -loginName \"%LOGIN_NAME%\" -loginPassword \"%LOGIN_PASSWORD%\" -rememberPassword \"%REMEMBER_PASSWORD%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"

dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven repository on your file system

Requires the following options:
extractorType<string>dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor > Maven repository on your file system
folderPath<string> 

Enter the absolute location of the folder that contains your Maven repository. This can be a network location or a folder on your local machine.

Example

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = CreatePackageForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================


SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor"
SET FOLDER_PATH="C:\MAVEN\REPO"
SET LOG_FILE_PATH="C:\TEMP"
SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -folderPath \"%FOLDER_PATH%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"

dmtdevmicrosofttechno.NetResourceFilesPackage > Automated extraction of required .NET assemblies

Requires the following:

extractorType<string>dmtdevnetresourcesextractor.NetResourceFolderExtractor > Maven repository on your file system
folderPath<string> 

Enter the absolute location of the folder that contains your Microsoft .NET Framework system assemblies. This can be a network location or a folder on your local machine, e.g.: "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>". If "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>" is NOT available on the machine, please use the most recent framework installed on the machine instead: "C:\Windows\Microsoft.NET\Framework64\<use the most recent>".

Example

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = CreatePackageForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================


SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevmicrosofttechno.NetResourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevnetresourcesextractor.NetResourceFolderExtractor"
SET FOLDER_PATH="C:\Windows\Microsoft.NET\Framework64\v4.0.30319"
SET LOG_FILE_PATH="C:\TEMP"
SET ACTION_CREATEPACKAGEFORLOCAL=CreatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageType \"%PACKAGE_TYPE%\" -packageName \"%PACKAGE_NAME%\" -extractorType \"%EXTRACTOR_TYPE%\" -folderPath \"%FOLDER_PATH%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_CREATEPACKAGEFORLOCAL%"

UpdatePackageForLocal

Only available in CAST AIP 8.3.6.

 Click here to expand...

This option will update an existing Package via the CAST AIC Portal. . You can configure all aspects of the existing package:

application<string>The name of the Application which contains your existing Version/Package.
versionName<string>The name of the Version which contains your existing Package.
storagePath<string>The location (path) of the Delivery folder that contains the Application/Version/Package.
packageName<string>The name of the package you want to update.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!

Depending on the type of package you are updating, additional parameters will be necessary to make the updates as follows:

dmtdevdbtechno.SQLCASTDatabasePackage > Oracle Server

Requires the following options:

extractorType<string>

dmtdevsqlcastextractororacle.SQLCASTExtractor > CAST extractor for Oracle

host<string>Used to configure the host name of your Oracle Server. You can also enter an IP address if required.
port<string>

Used to configure the port number for accessing your Oracle Server. The default port number for Oracle Server is 1521.

service<string> or sid<string>

Choose either -service or -sid, i.e. the Service/SID name for accessing your database server.

Please note that when connecting to a "pluggable database" (for example in Oracle 12c and above) you MUST use the Service option - the SID option will not function.

loginName<string>Used to configure the user name that has sufficient privileges to access the required schemas on the selected server for packaging purposes. Please see the CAST Delivery Manager Tool help for more information about required privileges.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the database access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of the same schemas on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

[rootPaths<string>]

Use this option to select the schemas you wish to extract.

  • To extract an individual schema, enter the NAME of the schema
  • If you intend to extract an entire instance and all schemas, you can omit this option
  • If you intend to extract multiple schemas you can list them separated with a semi-comma (";").
  • Please ensure that you input the name of the schema in the correct case (i.e. upper or lower) as these fields are case sensitive - remember that the vast majority of Oracle schemas are in upper case.
  • If you have objects from different schemas on the same instance that are linked (i.e. inter-schema links such as "Database-Links" or between objects in different schemas) and you expect the analysis to detect and store these links, then you must ensure that you carry out ONE extraction on all the schemas involved (i.e. specify the schemas involved separated with a semi-comma). If you are unsure which schemas are involved, you can extract the entire instance by omitting the option, but this can affect performance.
  • The CAST Database Extractor will carry out an automatic validation of the information entered into this field to counter the incorrect use of case or the input of a non-existent schema/database. The extraction process will be stopped and an error will be displayed if the validation fails.

dmtdevmainframetechno.MainframePackage > Mainframe (IBM zOS PDS (Partitioned Data Set) dump extraction)

Requires the following options:
extractorType<string>dmtdevmainframeextractor.MainframeExtractor > IBM zOS PDS (Partitioned Data Set) dump extraction
libraryFilePath<string> Enter the absolute location of your PDS dump file.
extension<string>

This option enables you to choose the content of the PDS dump file that will be extracted an packaged. Filters are based on file extensions and can be one of the following:

  • "CobolProgram" 
  • "CobolCopybook" 
  • "JCLJobProc" 
  • "JCLInclude" 
  • "IMSDBD" 
  • "IMSPSB" 
  • "CICSCSD" 
  • "CICSBMS"
banner<text>Indicates the left hand part of the banner in the PDS dump excluding the member name. This determines the start of each member - this is used by the CAST Delivery Manager Tool to identify each member.
leftMargin<integer>Indicates the line column(s) in which system characters are present. This column (or columns) are ignored during the extraction and packaging process and are not transferred to file.
lineMaxLength<integer>For each member line that will be extracted, this value indicates the line max size that will be retained during the extraction to file. Any characters that are located in the line beyond the line max size will be ignored during the extraction and packaging process and are not transferred to file.

delivery.SourceFilesPackage > Files on your system

Requires the following options:

extractorType<string>dmtdevfolderextractor.SourceFolderExtractor > Folder on your local file system
folderPath<string> Enter the absolute location of the folder that contains your target source code. This can be a network location or a folder on your local machine.
[originalLocation<string>]

If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path).

delivery.SourceFilesPackage > Subversion using svnkit

Requires the following options:
extractorType<string>dmtdevsvnextractor.SVNExtractor > Folder on your local file system
connectionURL<string>Enter the URL of your Subversion repository. You can use either the https:// or svn:// protocols.
revision<string>

Enter the specific revision of source code that you require, for example HEAD.

loginName<string>Used to configure the user name that has sufficient privileges to access the SVN repository.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the SVN access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

[originalLocation<string>]

If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path).

dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven HTTP repository

Requires the following options:
extractorType<string>dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor > Maven Http repository
connectionURL<string>Enter the URL of your Maven repository. You can use either the https:// or http:// protocols.
loginName<string>Used to configure the user name that has sufficient privileges to access the Maven repository.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the Maven access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven repository on your file system

Requires the following options:
extractorType<string>dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor > Maven repository on your file system
folderPath<string> 

Enter the absolute location of the folder that contains your Maven repository. This can be a network location or a folder on your local machine.

dmtdevmicrosofttechno.NetResourceFilesPackage > Automated extraction of required .NET assemblies

Requires the following:

extractorType<string>dmtdevnetresourcesextractor.NetResourceFolderExtractor > Maven repository on your file system
folderPath<string> 

Enter the absolute location of the folder that contains your Microsoft .NET Framework system assemblies. This can be a network location or a folder on your local machine, e.g.: "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>". If "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>" is NOT available on the machine, please use the most recent framework installed on the machine instead: "C:\Windows\Microsoft.NET\Framework64\<use the most recent>".

Example

Windows
REM ===============================================
REM = DMT - Configuration
REM = Please do not change the JNLP_FILE parameter
REM ===============================================

set AICPORTAL_HOST=ceiriad
set AICPORTAL_PORT=8080
set AICPORTAL_WEBAPP=CAST-AICPortal
set APPLICATION_ID=cdab40c0-9cf0-4cc0-aca4-c01d06bbabbe
set AUTH=-username cast -password cast
set JNLP_FILE=http://%AICPORTAL_HOST%:%AICPORTAL_PORT%/%AICPORTAL_WEBAPP%/%APPLICATION_ID%/dmt-launcher.jnlp?url=http%%3A%%2F%%2F%AICPORTAL_HOST%%%3A%AICPORTAL_PORT%%%2F%AICPORTAL_WEBAPP%

REM ========================================================
REM = UpdatePackageForLocal
REM = Please only modify the path to your Java JRE "bin" folder
REM = note the quote marks that must be used for this path
REM = if it contains spaces.
REM ========================================================


SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_NAME="test_package"
SET HOST="ORASERVER1"
SET PORT="1521"
SET SERVICE="ORADB2"
SET LOGIN_NAME="system"
SET LOGIN_PASSWORD="my_password"
SET REMEMBER_PASSWORD="Server"
SET ROOT_PATHS="CASTPUBS;COOLCLUBS;BI;NEW"
SET LOG_FILE_PATH="C:\TEMP"
SET ACTION_UPDATEPACKAGEFORLOCAL=UpdatePackageForLocal -application \"%APPLICATION%\" -versionName \"%VERSION_NAME%\" -storagePath \"%STORAGE_PATH%\" -packageName \"%PACKAGE_NAME%\" -host \"%HOST%\" -port \"%PORT%\" -service \"%SERVICE%\" -loginName \"%LOGIN_NAME%\" -loginPassword \"%LOGIN_PASSWORD%\" -rememberPassword \"%REMEMBER_PASSWORD%\" -rootPaths \"%ROOT_PATHS%\" -logFilePath \"%LOG_FILE_PATH%\"

"C:\Program Files\Java\jre8\bin\javaws.exe" %JNLP_FILE% -Xnosplash -silent -wait -open "%AUTH% %ACTION_UPDATEPACKAGEFORLOCAL%"

Without CAST AIC Portal mode

To execute an action via the command line in this mode you must specify the DeliveryManagerTool-CLI.exe executable available in the DeliveryManagerTool folder in the CAST AIP installation folder. Command arguments are expressed as verbs and then various mandatory and optional (enclosed in square brackets) options. Each command argument verb and various examples is listed and explained below.

Prerequisites

Before you can starting using the CLI in CAST AIC Portal mode you must ensure that you meet the following requirements:

(tick)Ensure you have access to the Delivery folder.

Miscellaneous information

  • Boolean format: [true|false]

  • String format: enclose with double quotes if containing blank spaces

  • Date format: [yyyyMMdd|yyyyMMddHHmm]
  • The examples listed below should be placed on one line if they are being used in a batch file.
  • Use the -help command to list all possible parameters for an argument, for example:
DeliveryManagerTool-CLI.exe AddVersion -help

Output codes

The CLI will return two output codes:

  • 0 = No error
  • 2 = Error exists

Command arguments

CreateServerApplication

Only available in CAST AIP 8.3.6.

 Click here to expand...

This option will create a new Application directly in the Delivery folder.

name<string>The name of the Application you want to create.
storagePath<string>The location (path) of the Delivery folder you want to create the Application in.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!
[username<string>]Specifies the username to authenticate against the CAST AIC Portal.
[password<string>]Specifies the password to authenticate against the CAST AIC Portal.
[authkey<string>]Specifies the authentication key to decode and authenticate against the CAST AIC Portal.
[proxy<string>]Specifies the proxy to be used to connect to the CAST AIC Portal.
[pxUsername<string>]Specifies the username to authenticate against the proxy.
[pxPassword<string>]Specifies the password to authenticate against the proxy.
[pxAuthkey<string>]Specifies the authentication key to decode and authenticate against the proxy.

Example

Windows
SET APPLICATION="MEUDON"
SET STORAGE_PATH="E:\CAST\Delivery"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" createServerApplication -name %APPLICATION% -storagePath %STORAGE_PATH% -logFilePath %LOG_FILE_PATH%

CreateVersionForServer

Only available in CAST AIP 8.3.6.

 Click here to expand...

This option will create a new Version directly in the Delivery folder.

application<string>The name of the Application in which you want to create the new Version.
name<string>The name of the new Version to create.
[releaseDate<date>]The release date. This parameter is optional (defaults to current date if not set).
storagePath<string>The location (path) of the Delivery folder that contains the Application in which you want to create the new Version.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!
[username<string>]Specifies the username to authenticate against the CAST AIC Portal.
[password<string>]Specifies the password to authenticate against the CAST AIC Portal.
[authkey<string>]Specifies the authentication key to decode and authenticate against the CAST AIC Portal.
[proxy<string>]Specifies the proxy to be used to connect to the CAST AIC Portal.
[pxUsername<string>]Specifies the username to authenticate against the proxy.
[pxPassword<string>]Specifies the password to authenticate against the proxy.
[pxAuthkey<string>]Specifies the authentication key to decode and authenticate against the proxy.

Example

Windows
SET APPLICATION="MEUDON"
SET NAME="V1"
SET RELEASE_DATE=201809211700
SET STORAGE_PATH="E:\CAST\Delivery"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreateVersionForServer -application %APPLICATION% -name %NAME% -releaseDate %RELEASE_DATE% -storagePath %STORAGE_PATH% -logFilePath %LOG_FILE_PATH%

CreatePackageForServer

Only available in CAST AIP 8.3.6.

 Click here to expand...

This option will create a new Package directly in the Delivery folder. You can configure all aspects of the package.

application<string>The name of the Application which contains the Version for your new Package.
versionName<string>The name of the Version for your new Package.
storagePath<string>The location (path) of the Delivery folder that contains the Application/Version in which you want to create the new Package.
packageType<string>

The type of package you want to create. Choose from one of the following:

packageName<string>The name of the package you want to create.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!

dmtdevdbtechno.SQLCASTDatabasePackage > Oracle Server

Requires the following options:

extractorType<string>

dmtdevsqlcastextractororacle.SQLCASTExtractor > CAST extractor for Oracle

host<string>Used to configure the host name of your Oracle Server. You can also enter an IP address if required.
port<string>

Used to configure the port number for accessing your Oracle Server. The default port number for Oracle Server is 1521.

service<string> or sid<string>

Choose either -service or -sid, i.e. the Service/SID name for accessing your database server.

Please note that when connecting to a "pluggable database" (for example in Oracle 12c and above) you MUST use the Service option - the SID option will not function.

loginName<string>Used to configure the user name that has sufficient privileges to access the required schemas on the selected server for packaging purposes. Please see the CAST Delivery Manager Tool help for more information about required privileges.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the database access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of the same schemas on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

[rootPaths<string>]

Use this option to select the schemas you wish to extract.

  • To extract an individual schema, enter the NAME of the schema
  • If you intend to extract an entire instance and all schemas, you can omit this option
  • If you intend to extract multiple schemas you can list them separated with a semi-comma (";").
  • Please ensure that you input the name of the schema in the correct case (i.e. upper or lower) as these fields are case sensitive - remember that the vast majority of Oracle schemas are in upper case.
  • If you have objects from different schemas on the same instance that are linked (i.e. inter-schema links such as "Database-Links" or between objects in different schemas) and you expect the analysis to detect and store these links, then you must ensure that you carry out ONE extraction on all the schemas involved (i.e. specify the schemas involved separated with a semi-comma). If you are unsure which schemas are involved, you can extract the entire instance by omitting the option, but this can affect performance.
  • The CAST Database Extractor will carry out an automatic validation of the information entered into this field to counter the incorrect use of case or the input of a non-existent schema/database. The extraction process will be stopped and an error will be displayed if the validation fails.

Example

Windows
SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevdbtechno.SQLCASTDatabasePackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevsqlcastextractororacle.SQLCASTExtractor"
SET HOST="ORASERVER"
SET PORT="1521"
SET SERVICE="ORADB1"
SET LOGIN_NAME="system"
SET LOGIN_PASSWORD="my_password"
SET REMEMBER_PASSWORD="Server"
SET ROOT_PATHS="CASTPUBS;COOLCLUBS;BI"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -host %HOST% -port %PORT% -service %SERVICE% -loginName %LOGIN_NAME% -loginPassword %LOGIN_PASSWORD% -rememberPassword %REMEMBER_PASSWORD% -rootPaths %ROOT_PATHS% -logFilePath %LOG_FILE_PATH%

dmtdevmainframetechno.MainframePackage > Mainframe (IBM zOS PDS (Partitioned Data Set) dump extraction)

Requires the following options:
extractorType<string>dmtdevmainframeextractor.MainframeExtractor > IBM zOS PDS (Partitioned Data Set) dump extraction
libraryFilePath<string> Enter the absolute location of your PDS dump file.
extension<string>

This option enables you to choose the content of the PDS dump file that will be extracted an packaged. Filters are based on file extensions and can be one of the following:

  • "CobolProgram" 
  • "CobolCopybook" 
  • "JCLJobProc" 
  • "JCLInclude" 
  • "IMSDBD" 
  • "IMSPSB" 
  • "CICSCSD" 
  • "CICSBMS"
banner<text>Indicates the left hand part of the banner in the PDS dump excluding the member name. This determines the start of each member - this is used by the CAST Delivery Manager Tool to identify each member.
leftMargin<integer>Indicates the line column(s) in which system characters are present. This column (or columns) are ignored during the extraction and packaging process and are not transferred to file.
lineMaxLength<integer>For each member line that will be extracted, this value indicates the line max size that will be retained during the extraction to file. Any characters that are located in the line beyond the line max size will be ignored during the extraction and packaging process and are not transferred to file.

Example

Windows
SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevmainframetechno.MainframePackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevmainframeextractor.MainframeExtractor"
SET LIBRARY="C:\PDS_DUMP"
SET EXTENSION="CobolProgram"
SET BANNER="VMEMBER NAME"
SET LEFT_MARGIN="1"
SET MAX_LENGTH="80"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -libraryFilePath %LIBRARY% -extension %EXTENSION% -banner %BANNER% -leftMargin %LEFT% -lineMaxLength %MAX_LENGTH% -logFilePath %LOG_FILE_PATH%

delivery.SourceFilesPackage > Files on your system

Requires the following options:

extractorType<string>dmtdevfolderextractor.SourceFolderExtractor > Folder on your local file system
folderPath<string> Enter the absolute location of the folder that contains your target source code. This can be a network location or a folder on your local machine.
[originalLocation<string>]

If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path).

Example

Windows
SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="delivery.SourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevfolderextractor.SourceFolderExtractor"
SET FOLDER_PATH="C:\SOURCE_CODE"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -folderPath %FOLDER_PATH% -logFilePath %LOG_FILE_PATH%

delivery.SourceFilesPackage > Subversion using svnkit

Requires the following options:
extractorType<string>dmtdevsvnextractor.SVNExtractor > Folder on your local file system
connectionURL<string>Enter the URL of your Subversion repository. You can use either the https:// or svn:// protocols.
revision<string>

Enter the specific revision of source code that you require, for example HEAD.

loginName<string>Used to configure the user name that has sufficient privileges to access the SVN repository.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the SVN access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

[originalLocation<string>]

If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path).

Example

Windows
SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="delivery.SourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevsvnextractor.SVNExtractor"
SET CONNECTION_URL="svn://server/trunk/test"
SET REVISION="HEAD"
SET LOGIN_NAME="svn_user"
SET LOGIN_PASSWORD="my_password"
SET REMEMBER_PASSWORD="Server"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -connectionURL %CONNECTION_URL% -revision %REVISION% -loginName %LOGIN_NAME% -loginPassword %LOGIN_PASSWORD% -rememberPassword %REMEMBER_PASSWORD% -logFilePath %LOG_FILE_PATH%

dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven HTTP repository

Requires the following options:
extractorType<string>dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor > Maven Http repository
connectionURL<string>Enter the URL of your Maven repository. You can use either the https:// or http:// protocols.
loginName<string>Used to configure the user name that has sufficient privileges to access the Maven repository.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the Maven access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

Example

Windows
SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor"
SET CONNECTION_URL="https://server/test"
SET LOGIN_NAME="maven_user"
SET LOGIN_PASSWORD="my_password"
SET REMEMBER_PASSWORD="Server"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -connectionURL %CONNECTION_URL% -loginName %LOGIN_NAME% -loginPassword %LOGIN_PASSWORD% -rememberPassword %REMEMBER_PASSWORD% -logFilePath %LOG_FILE_PATH%

dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven repository on your file system

Requires the following options:
extractorType<string>dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor > Maven repository on your file system
folderPath<string> 

Enter the absolute location of the folder that contains your Maven repository. This can be a network location or a folder on your local machine.

Example

Windows
SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor"
SET FOLDER_PATH="C:\MAVEN\REPO"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -folderPath %FOLDER_PATH% -logFilePath %LOG_FILE_PATH%

dmtdevmicrosofttechno.NetResourceFilesPackage > Automated extraction of required .NET assemblies

Requires the following:

extractorType<string>dmtdevnetresourcesextractor.NetResourceFolderExtractor > Maven repository on your file system
folderPath<string> 

Enter the absolute location of the folder that contains your Microsoft .NET Framework system assemblies. This can be a network location or a folder on your local machine, e.g.: "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>". If "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>" is NOT available on the machine, please use the most recent framework installed on the machine instead: "C:\Windows\Microsoft.NET\Framework64\<use the most recent>".

Example

Windows
SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_TYPE="dmtdevmicrosofttechno.NetResourceFilesPackage"
SET PACKAGE_NAME="test_package"
SET EXTRACTOR_TYPE="dmtdevnetresourcesextractor.NetResourceFolderExtractor"
SET FOLDER_PATH="C:\Windows\Microsoft.NET\Framework64\v4.0.30319"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" CreatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageType %PACKAGE_TYPE% -packageName %PACKAGE_NAME% -extractorType %EXTRACTOR_TYPE% -folderPath %FOLDER_PATH% -logFilePath %LOG_FILE_PATH%

UpdatePackageForServer

Only available in CAST AIP 8.3.6.

 Click here to expand...

This option will update an existing Package directly in the Delivery folder. You can configure all aspects of the existing package:

application<string>The name of the Application which contains your existing Version/Package.
versionName<string>The name of the Version which contains your existing Package.
storagePath<string>The location (path) of the Delivery folder that contains the Application/Version/Package.
packageName<string>The name of the package you want to update.
[logFilePath<string>]Specifies the exact log file path or a log directory path. This path must exist already!

Depending on the type of package you are updating, additional parameters will be necessary to make the updates as follows:

dmtdevdbtechno.SQLCASTDatabasePackage > Oracle Server

Requires the following options:

extractorType<string>

dmtdevsqlcastextractororacle.SQLCASTExtractor > CAST extractor for Oracle

host<string>Used to configure the host name of your Oracle Server. You can also enter an IP address if required.
port<string>

Used to configure the port number for accessing your Oracle Server. The default port number for Oracle Server is 1521.

service<string> or sid<string>

Choose either -service or -sid, i.e. the Service/SID name for accessing your database server.

Please note that when connecting to a "pluggable database" (for example in Oracle 12c and above) you MUST use the Service option - the SID option will not function.

loginName<string>Used to configure the user name that has sufficient privileges to access the required schemas on the selected server for packaging purposes. Please see the CAST Delivery Manager Tool help for more information about required privileges.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the database access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of the same schemas on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

[rootPaths<string>]

Use this option to select the schemas you wish to extract.

  • To extract an individual schema, enter the NAME of the schema
  • If you intend to extract an entire instance and all schemas, you can omit this option
  • If you intend to extract multiple schemas you can list them separated with a semi-comma (";").
  • Please ensure that you input the name of the schema in the correct case (i.e. upper or lower) as these fields are case sensitive - remember that the vast majority of Oracle schemas are in upper case.
  • If you have objects from different schemas on the same instance that are linked (i.e. inter-schema links such as "Database-Links" or between objects in different schemas) and you expect the analysis to detect and store these links, then you must ensure that you carry out ONE extraction on all the schemas involved (i.e. specify the schemas involved separated with a semi-comma). If you are unsure which schemas are involved, you can extract the entire instance by omitting the option, but this can affect performance.
  • The CAST Database Extractor will carry out an automatic validation of the information entered into this field to counter the incorrect use of case or the input of a non-existent schema/database. The extraction process will be stopped and an error will be displayed if the validation fails.

dmtdevmainframetechno.MainframePackage > Mainframe (IBM zOS PDS (Partitioned Data Set) dump extraction)

Requires the following options:
extractorType<string>dmtdevmainframeextractor.MainframeExtractor > IBM zOS PDS (Partitioned Data Set) dump extraction
libraryFilePath<string> Enter the absolute location of your PDS dump file.
extension<string>

This option enables you to choose the content of the PDS dump file that will be extracted an packaged. Filters are based on file extensions and can be one of the following:

  • "CobolProgram" 
  • "CobolCopybook" 
  • "JCLJobProc" 
  • "JCLInclude" 
  • "IMSDBD" 
  • "IMSPSB" 
  • "CICSCSD" 
  • "CICSBMS"
banner<text>Indicates the left hand part of the banner in the PDS dump excluding the member name. This determines the start of each member - this is used by the CAST Delivery Manager Tool to identify each member.
leftMargin<integer>Indicates the line column(s) in which system characters are present. This column (or columns) are ignored during the extraction and packaging process and are not transferred to file.
lineMaxLength<integer>For each member line that will be extracted, this value indicates the line max size that will be retained during the extraction to file. Any characters that are located in the line beyond the line max size will be ignored during the extraction and packaging process and are not transferred to file.

delivery.SourceFilesPackage > Files on your system

Requires the following options:

extractorType<string>dmtdevfolderextractor.SourceFolderExtractor > Folder on your local file system
folderPath<string> Enter the absolute location of the folder that contains your target source code. This can be a network location or a folder on your local machine.
[originalLocation<string>]

If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path).

delivery.SourceFilesPackage > Subversion using svnkit

Requires the following options:
extractorType<string>dmtdevsvnextractor.SVNExtractor > Folder on your local file system
connectionURL<string>Enter the URL of your Subversion repository. You can use either the https:// or svn:// protocols.
revision<string>

Enter the specific revision of source code that you require, for example HEAD.

loginName<string>Used to configure the user name that has sufficient privileges to access the SVN repository.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the SVN access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

[originalLocation<string>]

If you are forced to deliver source code from a location that is not the same as the location used to develop the source code, you can use this option to define what is known as a "development root folder". This may occur, for example, when you need to deliver source code developed in a Linux environment and subsequently transferred to Windows - in this case, the development root folder will be used to locate file or folder references in your source code (whether full or relative path).

dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven HTTP repository

Requires the following options:
extractorType<string>dmtjeemavenhttpresourcesextractor.MavenHttpResourceExtractor > Maven Http repository
connectionURL<string>Enter the URL of your Maven repository. You can use either the https:// or http:// protocols.
loginName<string>Used to configure the user name that has sufficient privileges to access the Maven repository.
loginPassword<string>Used to configure the password that corresponds to your User name configured in -loginName<string>.
rememberPassword<string>

This option enables you to save the Maven access credentials you have entered. Choose one of:

  • "NotStored"
  • "Local"
  • "Server"

Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions on the same server, you can choose to store the password in which case you will not need to re-enter it. Please see the CAST Delivery Manager Tool help for more information.

dmtdevjeemavenresourcesextractor.MavenResourceFilesPackage > Automated extraction of required JAR files > Maven repository on your file system

Requires the following options:
extractorType<string>dmtdevjeemavenresourcesextractor.MavenFileSystemExtractor > Maven repository on your file system
folderPath<string> 

Enter the absolute location of the folder that contains your Maven repository. This can be a network location or a folder on your local machine.

dmtdevmicrosofttechno.NetResourceFilesPackage > Automated extraction of required .NET assemblies

Requires the following:

extractorType<string>dmtdevnetresourcesextractor.NetResourceFolderExtractor > Maven repository on your file system
folderPath<string> 

Enter the absolute location of the folder that contains your Microsoft .NET Framework system assemblies. This can be a network location or a folder on your local machine, e.g.: "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>". If "C:\Windows\Microsoft.NET\Framework64\<use the version used by your projects>" is NOT available on the machine, please use the most recent framework installed on the machine instead: "C:\Windows\Microsoft.NET\Framework64\<use the most recent>".

Example

Windows
SET APPLICATION="MEUDON"
SET VERSION_NAME="V1"
SET STORAGE_PATH="E:\CAST\Delivery"
SET PACKAGE_NAME="test_package"
SET HOST="ORASERVER1"
SET PORT="1521"
SET SERVICE="ORADB2"
SET LOGIN_NAME="system"
SET LOGIN_PASSWORD="my_password"
SET REMEMBER_PASSWORD="Server"
SET ROOT_PATHS="CASTPUBS;COOLCLUBS;BI;NEW"
SET LOG_FILE_PATH="C:\TEMP"

"%programfiles%\CAST\<version>\DeliveryManagerTool\DeliveryManagerTool-CLI.exe" UpdatePackageForServer -application %APPLICATION% -versionName %VERSION_NAME% -storagePath %STORAGE_PATH% -packageName %PACKAGE_NAME% -host %HOST% -port %PORT% -service %SERVICE% -loginName %LOGIN_NAME% -loginPassword %LOGIN_PASSWORD% -rememberPassword %REMEMBER_PASSWORD% -rootPaths %ROOT_PATHS% -logFilePath %LOG_FILE_PATH%
  • No labels