Application Monitor Batch Reports › Requesting Reports › Selection Criteria Parameters › Parameters

Parameters

ABOrt CODe abend-code

Selects only those tasks that abended with the (4-character) database/data communications task abend code specified. Abend-code is a 4-character database/data communications abend code. You can specify up to 20 codes. The abbreviation ABRT is permitted.

ABOrt MESsage message-id

Selects only those tasks that abended with the DC/UCF error message ID specified (6 digits, excluding the severity code suffix). Message-id is the six-digit DC/UCF message ID. You can select up to 20 IDs. The abbreviations ABRT and MSG are permitted.

ACTive STOrage storage-amount

Selects only those tasks that used more than the specified number of bytes of main memory from a storage pool during active execution. You can use the abbreviation STG.

BILling GROup billing-group-code

Selects tasks by billing-group code. Billing-group-code is a 1- to 12-character billing-group code. Use single quotes if it contains embedded spaces. Use two quotation marks to indicate a quotation mark that is part of the description. Up to 20 codes are permitted. You can use the abbreviation GRP.

CPU time cpu-amount

Selects only those tasks that used more than nnnn.nnnn seconds of CPU time. Cpu-amount is a number between .0001 and 999999.9999.

CV NUMber dc/ucf-version-number

Selects only those tasks that ran under the specified DC/UCF system. Dc/ucf-version-number is a number between 0 and 9999. You can place multiple values on one line and you can use the abbreviation NBR. Up to 20 CV numbers are permitted.

DATe FORmat MDY/DMY/MYD/DYM/YMD/YDM

Specifies the date format that appears on the reports. The default is MDY. You can use the abbreviation FMT.

DB CALls database-call-threshold

Selects only those tasks that issued more than the specified number of database calls. Synonyms you can use are DB and DBCALLS.

DB LEVels ads-database-levels

Selects only those CA ADS dialogs that issued database calls from more than the specified number of application-thread levels. Non CA ADS tasks are dropped. You can use the abbreviation LVLS.

ELApsed TIMe elapsed-seconds

Selects only those tasks with an elapsed time longer than the specified number of seconds. The elapsed time is a number between .0001 and 9999.9999 and is the internal CA IDMS response time, and it is measured from task initiation to task termination within the DC/UCF system.

IO physical-io-amount

Selects only those tasks that issued more than the specified number of physical disk I/Os.

KEPt STOrage kept-storage-amount

Selects only those tasks that kept more than the specified number of bytes of main memory from a storage pool after task termination (across a pseudo-converse). You can use the abbreviation STG.

LEVels dialog-levels

Selects only those CA ADS dialogs that processed more than the specified number of levels in the application thread. Non CA ADS tasks are dropped. You can use the abbreviation LVLS.

LTErm logical-terminal-id

Selects only tasks initiated from the logical terminal specified. Logical-terminal-id is a 1- to 8-character logical terminal ID. Up to 50 IDs are permitted.

PROgram program-name

Selects only those tasks that execute the named program at the first level. Program-name is a 1- to 8-character program name. Up to 50 program names are permitted. You can use the abbreviations PROG and PGM.

PTErm physical-terminal-id

Selects only tasks initiated from the physical terminal specified. Physical-terminal-id is a 1- to 8-character physical terminal ID. Up to 50 IDs are permitted.

RBB number-of-rbbs

Selects only those CA ADS dialogs that obtained more than the specified number of record buffer blocks. Non CA ADS tasks are dropped.

REPort FROm/THRu

Selects intervals to be included in the report. If you want to report on the entire input file, don't include this parameter. You can specify this parameter once per run, and you must specify at least one FROM or one THRU. The default is FROM 00:00 ON 00/001 THRU 24:00 ON 99/365.

Regarding the time specification:

• Specify the time as hh:mm or hhmm (00:00 through 24:00).
• Times include the entire minute. For example, THRU 14:34 means up to 14:34:59.9999.
• Times must include the leading 0. For example, 09:00 is valid, but 9:00 is not.
• If you specify a time range, the FROM time must be earlier than the THRU time.

Regarding the date specification:

• Julian: yy/ddd
• Gregorian: as specified by DATE FORMAT
• The FROM date must be earlier or matching the THRU date.
• Slashes are optional in date specifications.

SCAling FACtor nnnnnn.nnnn

Defines a scaling factor for report graphs. Nnnnnn.nnnn is a numeric value that specifies the scaling factor (for example, .01 results in scaling of data in hundredths). The decimal point is not required and, if present, can be leading or trailing. Any more than 4 digits to the right of the decimal point are truncated. For example, 1.2345678 will be truncated to 1.2345. The default is 1.0. You can use the synonym SCALE FACTOR. About the values you can specify:

• 0 is invalid.
• The maximum is 999999.9999.
• Examples of valid values follow:

  123456            .3456
    1234.5678     45.
  000000.01        0.3
  

TASk task-code

Selects only tasks with the task code or (for CA ADS) dialog name specified. Task-code is a 1- to 8-character task code or dialog name. Up to 50 task codes are permitted.

TP REAd bytes-read

Selects only those tasks that read in more than the specified number of bytes from the terminal.

TP WRIte bytes-written

Selects only those tasks that wrote out more than the specified number of bytes to the terminal.

TYPe task-type

Selects only tasks of the type specified. Possible values for task-type are shown in the following table.

USEr user-id

Selects only those tasks invoked by the specified user. User-id is a 1- to 8-character user ID. Use quotes if it contains embedded spaces. Use two quotation marks to indicate a quotation mark that is part of user-id.

Up to 20 user IDs are permitted. You can use the synonym USERID.