zowe › profiles › create › mat-profile🖨️

CA MAT Analyze CLI profile schema.

Usage

zowe profiles create mat-profile <profileName> [options]

Positional Arguments

• profileName (string)

  • Specifies the name of the new mat profile. You can load this profile by using the name on commands that support the "--mat-profile" option.

MAT Profile Options

• --protocol | --prt (string)

  • Specifies the protocol defined for the CA MAT REST API server (http or https).

    Allowed values: http, https

• --hostname | --hn (string)

  • Specifies the hostname or IP address defined for the CA MAT REST API server (e.g. 127.0.0.0 or localhost).

• --port | --pt (number)

  • Specifies the server port (e.g. 8080).

• --username | --user (string)

  • Your mainframe username.

• --password | --pass (string)

  • Your mainframe password.

• --zowediscoverable | --zdis (boolean)

  • Specifies whether you want to use Zowe API Mediation Layer to process the commands for this profile. Set '--zowediscoverable true' only if you have configured the Zowe API Mediation Layer properties in your CA MAT REST API server settings.

    Allowed values: false, true

• --listingDir | --ldir (string)

  • Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with CA MAT and listing retrieval through CA Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with CA MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through CA Endevor® footprints, you need to have the CA Endevor® Web Services installed and configured and specify the CA Endevor® web server details in the CA MAT database configuration.

Options

• --overwrite | --ow (boolean)

  • Overwrite the mat profile when a profile of the same name exists.

• --disable-defaults | --dd (boolean)

  • Disable populating profile values of undefined properties with default values.

Examples

• Create a MAT profile called 'matprofile' using your CA MAT configuration and REST API details, with the CA MAT REST API server integrated with the Zowe API Mediation Layer:

  • zowe profiles create mat-profile matprofile --prt http --hn localhost --pt 1234 --user user --pass pass --zowediscoverable true Copy

• Create a MAT profile called 'matprofile' using your CA MAT configuration and the details of the CA MAT REST API server without integration with the Zowe API Mediation Layer,and define the 'c:\listings' directory to store program listings for instant analysis from your VS Code IDE:

  • zowe profiles create mat-profile matprofile --prt http --hn localhost --pt 1234 --user user --pass pass --zowediscoverable false --listingDir 'c:\listings' Copy