zowe › mat › profile › create🖨️

Create a CA MAT monitor profile.

Usage

zowe mat profile create [options]

Required Options

• --profile (string)

  • Specifies the name of the profile that you create in CA MAT (e.g. PROFILE1). Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.

• --jobname (string)

  • Specifies the name of the job that you want to measure (e.g. JOB1). Values: 1 to 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

• --targsys (string)

  • Specifies the target system in SYSPLEX. Values: a comma separated list of up to 4 values is allowed, 1-8 characters each, a combination of alphanumeric (A-Z and 0-9) and national (@,#,$), the first character must be an alphabetic (A-Z) or a national (@, #, $), e.g. AA31,AA32).

Options

• --batchreports (string)

  • Specifies the setting for the Batch report option upon monitor completion.

    Default value: no
    Allowed values: yes, no

• --description (string)

  • Provide the monitor description (maximum 24 characters).

• --mondsn (string)

  • Specifies the monitor data set name where CA MAT saves the measurement (e.g. DEMO.MAT.MONITOR). Values: data set name pattern, maximum 46 characters. If not specified, your default CA MAT monitor DSN pattern is applied.

• --stepname (string)

  • Specifies the name of the job step to monitor. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

• --mstep (string)

  • Indicates whether the multi-step monitoring option is enabled.

    Default value: no
    Allowed values: yes, no

• --procstep (string)

  • Specifies the name of the procedure step. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

• --program (string)

  • Specifies the name of the program to monitor. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

• --elapstime (string)

  • Specifies the required monitor duration followed by s (seconds) or m (minutes) (e.g. 60s). Values: maximum 6 characters total, number must be > 0.

    Default value: 60s

• --smon (string)

  • Specifies whether to monitor the entire step.

    Default value: no
    Allowed values: yes, no

• --tasklib (string)

  • Specifies an additional DD name for load modules. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

• --samplecnt (string)

  • Specifies the number of observations requested. Values: maximum 6 characters, numbers between 10 and 999999.

    Default value: 6000

• --succnt (string)

  • Specifies the maximum number of monitors to run per job execution. Values: maximum 4 characters, numbers between 1 and 9999.

    Default value: 1

• --reccnt (string)

  • Specifies the number of times this job step will be monitored. Values: maximum 4 characters, numbers between 1 and 9999.

    Default value: 1

• --sampdelay (string)

  • Specifies the delay monitoring time in seconds after the step start. Values: maximum 4 characters, numbers between 0 and 9999.

    Default value: 0

• --userexit1 (string)

  • Specifies the name for the call user written Data Base. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. DBEXIT1).

• --userexit2 (string)

  • Specifies the name 1 for the call user written 4GL exit programs for this monitor . Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. UEXIT1).

• --userexit3 (string)

  • Specifies the name 2 for the call user written 4GL exit programs for this monitor . Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. UEXIT2).

• --inctask (string)

  • Specifies the task name to define the tasks that you want to sample in a multitasking environment and restrict monitoring to the specific subtask within the address space. Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. INC31,INC32).

• --exctask (string)

  • Specifies the task name to omit from sampling in a multitasking environment Values: a comma separated list of up to 4 values is allowed, max. 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. EXC31,EXC32).

• --tran (string)

  • Specifies the CICS transaction code name to monitor .Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. TRAN1,TRAN2).

• --term (string)

  • Specifies the CICS terminal IDs to monitor. Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. TERM1,TERM2).

• --userid (string)

  • Specifies the CICS user IDs to monitor. Values: Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. USER1,USER2).

• --db2expl (string)

  • Indicates whether the Explain SQL option is enabled for DB2 SQL statements.

    Default value: no
    Allowed values: yes, no

• --db2ctsql (string)

  • Indicates whether the Collect SQL from Catalog option is enabled for DB2 SQL statements.If you specify db2expl=yes, then db2ctsql must be also set to yes.

    Default value: no
    Allowed values: yes, no

• --db2hvloc (string)

  • Indicates whether the Requestor Location option is enabled for DB2 measurements.

    Default value: no
    Allowed values: yes, no

• --db2hvcor (string)

  • Indicates whether the Correlation ID option for SQL statements is enabled for DB2 measurements.

    Default value: no
    Allowed values: yes, no

• --db2hviid (string)

  • Indicates whether the Operator ID option for SQL statements is enabled for DB2 measurements.

    Default value: no
    Allowed values: yes, no

• --db2hvthd (string)

  • Indicates whether the Thread Address option for SQL statements is enabled for DB2 measurements.

    Default value: no
    Allowed values: yes, no

• --wasexprt (string)

  • Indicates whether the Expert Mode is enabled for Java measurement.

    Default value: no
    Allowed values: yes, no

• --urlfilt (string)

  • A filtering string to restrict monitoring to the specific application URL, transaction, or stored procedure for Java measurements. Values: a comma separated list of up to 4 values is allowed, max. 64 characters (e.g. mypage1.html,mypage2.html).

• --sysfilt (string)

  • A filtering string to include the specified system class for Java measurements. If you specify a value for sysfilt, the measurement includes only the classes that match the filtering string pattern. Values: a comma separated list of up to 3 values is allowed, max. 64 characters (e.g. user1.class,user2.class).

• --schedule (string)

  • Specifies the name of the schedule that you want to apply to the monitor profile (maximum 8 characters).

Profile Options

• --mat-profile | --mat-p (string)

  • The name of a (mat) profile to load for this command execution.

• --base-profile | --base-p (string)

  • The name of a (base) profile to load for this command execution.

Base Connection Options

• --host | -H (string)

  • Host name of service on the mainframe.

• --port | -P (number)

  • Port number of service on the mainframe.

• --user | -u (string)

  • User name to authenticate to service on the mainframe.

• --password | --pass | --pw (string)

  • Password to authenticate to service on the mainframe.

• --reject-unauthorized | --ru (boolean)

  • Reject self-signed certificates.

    Default value: true

• --token-type | --tt (string)

  • The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

• --token-value | --tv (string)

  • The value of the token to pass to the API.

• --cert-file (local file path)

  • The file path to a certificate file to use for authentication

• --cert-key-file (local file path)

  • The file path to a certificate key file to use for authentication

Examples

• Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system:

  • zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31 Copy

• Create the PROFILE1 monitor profile to measure for 90 seconds job JOB1 that runs on the AA31 and AA32 systems:

  • zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31,AA32 --elapstime 90s Copy