The NEW command is used to create a new Observation Request.
Indicates that this is a NEW request.
Specifies the name of the job (or started task or TSO user) to be measured.
The maximum number of jobs that can be measured from a multi-job request is defined during the installation of Application Performance Analyzer. When this limit is exceeded, Application Performance Analyzer stops creating measurements for this request, and the status of the request is displayed as ‘Stoppd'. The measurements that executed (within the limit) are accessible for report viewing under the request. To increase the limit, contact your system programmer.
Example: %MSMPP% causes one sampling request to be created for each active job whose jobname contains "MSMPP".
The ASID keyword is ignored when the jobname specifes a pattern.
The ACTIVE keyword is automatically set to YES when the jobname specifies a pattern.
Specifies a target system within a sysplex. You can also enter an asterisk (*), in which case the target job is measured on the first system to run it. When an asterisk (*) is entered, the keyword ACTIVE=YES is invalid. This keyword is invalid in a non-sysplex environment.
Example: SYSTEMS=SYS3
Specifies a free form text description for this observation request. The text must be within single quotes, and if mandatory must be a minimum of 8 characters.
Example: DESCR= 'Any user text goes here'
If omitted, the default number of samples will be used. Specifies the number of samples to take during the measurement.
Example: SAMPLES=10000
If omitted, the default duration will be used. Specifies the duration of the measurement in seconds.
Example: DURATION=120
Specifies a TSO userid to notify when the measurement ends.
Example: NOTIFY=USER01
Specify YES to indicate that the measurement should continue to run until the job step has completed, even if the target number of observations has been reached.
This indicates that sampling should be delayed for the specified amount of time (in seconds). After the target job step starts, Application Performance Analyzer will delay the start of the measurement for the number of seconds specified.
If omitted the installation default will be used.
Specifies the number of days the measurement data for this observation request should be retained on before being automatically deleted. To keep the measurement data indefinitely, use EXPDAYS=0.
Example: EXPDAYS=30
Specify the maximum number of spawned address spaces or substeps to measure for a USS observation, up to the maximum defined in the system configuration. The same sampling frequency will be used for each spawned address space or substep. Sampling overhead can be high if several spawned address spaces are running simultaneously.
When this field is specified, the collection of measurements will be grouped under a USS master record on the Observation List panel.
Specifies which data extractors, if any, need to be turned on for this measurement. The data extractor values are: CICS®, CICS+, IMS™, IMS+, DB2, DB2+, DB2V, CDB2, MQS, Java, ADA, NAT. A list of data extractors is separated by commas.
If your installation has any default extractors set, the FEATURES command will override these. If you need to override default extractors and want to turn all extractors off, specify FEATURES=(BATCH).
Example: FEATURES=(CICS,DB2)
Enter the value to limit the number of DB2+ SQL call interceptions for which full details will be written to the sample file. Collecting full details on every interception allows the F02 Timeline report to report exact times for all SQL calls. The F02 report will be truncated at the number of calls specified in this field. The DB2+ data extractor continues to collect the data it requires for the other reports for the duration of the measurement. The value cannot exceed the default value specified for DB2IMaxTraceSize during Application Performance Analyzer installation.
Example: DB2IMAX=(10000)
Enter the value to limit the number of IMS+ DLI call interceptions for which full details will be written to the sample file. Collecting full details on every interception allows the I02 and I03 Timeline reports to report exact times for all DLI calls and IMS transactions. The I02 and I03 reports will be truncated at the number of calls specified in this field. The IMS+ data extractor continues to collect the data it requires for the other reports for the duration of the measurement. The value cannot exceed the default value specified for IMSIMaxTraceSize during Application Performance Analyzer installation.
Example: IMSIMAX=(10000)
Specifies additional load libraries to be searched. A list of data set names is separated by commas. A maximum of 10 data set names is allowed.
Example: LIBS=(USER1.LOADLIB,TEST1.LOADLIB)
Specifies up to 440 bytes of HFS directory path names to be searched by Application Performance Analyzer, enclosed in quotes and each separated by one or more spaces. These are applicable only when sampled HFS programs have relative path names. The LIBS and DIRS keywords are mutually exclusive.
Example: DIRS=("/u/axx01 /u/axx01/cpp")
If omitted, the first step will be measured.
Multiple STEP keywords can be specified. Specifying multiple STEP keywords creates a multistep request. A maximum of 20 STEP keywords is allowed.
Each STEP can have multiple positional parameters:
If the format stepname.procstep is coded, then stepname identifies an EXEC statement that invoked a procedure, and procstep identifies the EXEC statement containing a PGM parameter within that procedure.
This parameter can not be specified when selecting an active job.
Specify ALLSTEPS=YES to create a multi-step request which measures all steps in the job. When specified for a threshold measurement on the TNEW command, all steps in the job that meet the threshold criteria are measured. When ALLSTEPS=YES is specified, the STEP keyword is meaningless, and will be ignored if coded.
Example: ALLSTEPS=YES
Specify YES if the job is active, or NO if the job is not active.
Example: ACTIVE=YES
If omitted, Application Performance Analyzer will measure the first job it finds with the JOBNAME. Specifies the ASID, in decimal, of the job to be measured. Only applies when ACTIVE=YES.
Example: ASID=1023
Specifies one or more CICS trancodes to measure. For all transactions, use CTRAN=*. A list of transactions is separated by commas. A maximum of 16 transactions is allowed.
Example 1: CTRAN=(TRNA,TRNB,TRNC)
Example 2: CTRAN=*
Specify YES if you want to measure the CICS system transactions.
Specifies one or more CICS terminal ids to measure. A list of terminal ids is separated by commas. You can also specify a terminal id pattern, such as a terminal id prefix followed by an asterisk (*) or an asterisk itself. The asterisk indicates that all terminals starting with the prefix are to be included in the measurement. The asterisk on its own indicates that all terminals are to be included. A maximum of 8 terminal ids / patterns is allowed.
Example:
CTERM=(TRM1,TRM2,TRM3)
CTERM=TRM*
CTERM=*
Specify NO if you do not want to measure CICS transactions that run non-terminal attached.
When measuring a single IMS/MPP or IMS/IFP region as entered in the JOBNAME parameter, this specifies an IMS transaction to include when measuring that IMS/MPP or IMS/IFP region. You can also specify a transaction ID pattern, such as a transaction ID prefix followed by an asterisk (*) or an asterisk by itself. The asterisk indicates that all transaction ids starting with the prefix are to be included in the measurement. The asterisk on its own indicates that all transactions are to be included.
Example:
ITRAN=IMSTRN1
ITRAN=IMSTRN*
ITRAN=*
When measuring multiple IMS/MPP regions simultaneously, as indicated by a dash ‘-‘ in the JOBNAME parameter and a list of IMS/MPP regions in the JOBNAMES parameter, this specifies a single IMS transaction to include when measuring the IMS/MPP regions. In this case, the complete transaction code must be provided and the IPROG and IUSER parameters are not applicable.
Example:
JOBNAME=(-) ITRAN=(TXNA) JOBNAMES=("IMSMPP1,IMSMPP2,IMSMPP3")
Specifies an IMS program to include when measuring an MPP or IFP region. You can also specify a program name pattern, such as a program name prefix followed by an asterisk (*) or an asterisk by itself. The asterisk indicates that all programs starting with the prefix are to be included in the measurement. The asterisk on its own indicates that all programs are to be included.
Example:
IPROG=IMSPGM1
IPROG=IMSPGM*
IPROG=*
Specifies an IMS user id to include when measuring an MPP or IFP region. You can also specify a user id pattern, such as a user id prefix followed by an asterisk (*) or an asterisk by itself. The asterisk indicates that transactions initiated by user IDs starting with the prefix are to be included in the measurement. The asterisk on its own indicates that transactions initiated by all users are to be included.
Example:
IUSER=IMSUSR1
IUSER=IMSUSR*
IUSER=*
Identifies the DDF filtering criteria that are used to limit the scope of a DDF measurement, to specific correlation id, end user id or workstation id or any combination. It accepts up to three sub-keywords; CORRID, EUSERID and WKSTNID. Values in CORRID, EUSERID, and WKSTNID are ANDed together to determine SQL requests that are included in the measurement. In any of these sub-keywords, you may also specify a wildcard pattern using an asterisk (*) or a percent sign (%). An asterisk is used to indicate one or more characters that can appear in place of the asterisk. It can be used as a prefix or a suffix, or both. Alternatively, a percent sign is used to indicate any single character, and can appear any number of times.
Specify a DB2 correlation id or pattern. This identifies a DB2 correlation id to be included in the measurement when measuring a DDF address space. A correlation id of null (binary zero) may be specified by entering ‘,NULL' as the corrid.
Example:
DDFFILTERS=(CORRID=(,NULL),EUSERID=(DDFUSER1),WKSTNID=(*))
This indicates that remote SQL with a null correlation id, originating from the user DDFUSER1 from any workstation will be included for the measurement for the observed DDF address space.
Identifies the DB2 stored procedure or user-defined function to be measured. It requires 4 positional parameters to identify the type (stored procedure or user-defined function), the DB2 subsystem name, the schema and the name of the procedure or function, in the format DB2SP=(type,ssnm,schema,name).
Type can be either P for stored procedure or F for user-defined function. For both schema and name, you can also specify a name pattern, for example, a name prefix followed by an asterisk (*) or an asterisk by itself. Application Performance Analyzer will measure the first DB2 stored procedure or user-defined function executed by the DB2 subsystem that matches the schema and name concatenation. If a single asterisk is coded in both schema and name, Application Performance Analyzer will measure the first stored procedure or user-defined function executed by the DB2 subsystem.
Example1: DB2SP=(P,DSN1,SCHEMA1,SP1)
This indicates that the first occurrence of DB2 stored procedure SCHEMA.SP1, which runs in the DB2 Subsystem DSN1 is to be measured.
Example2: DB2SP=(F,DSN2,SCHEMA2,UDF2)
This indicates that the first occurrence of user-defined function SCHEMA2.UDF2, which runs in the DB2 Subsystem DSN2 is to be measured.
Example3: DB2SP=(P,DSN1,SCH*,SP1)
This indicates that the first occurrence of stored procedure SP1 with a schema that begins with SCH, that runs in the DB2 Subsystem DSN1 is to be measured.
Specifies the IMS subsystem ID for an IMS Multiple Region request. An IMS Multiple Region request is identified by specifying a dash in the JOBNAME keyword. Refer to the JOBNAME parameter description for details.
Example:
IMSID=(IMSA)
Specifies the names of the IMS MPP regions to be measured for an IMS Multiple Region request. The region names must be separated by commas and enclosed in quotes. An IMS Multiple Region request is identified by specifying a dash in the JOBNAME keyword. Refer to the JOBNAME parameter description for details.
Example:
JOBNAMES=("IMSAMPP1,IMSAMPP4,IMSAMPP5")
Multiple SCHDDATE keywords can be specified to schedule future requests on multiple dates and times. Date/time is specified in the format: yyyy/mm/dd@hh:mm.
Example:
SCHDDATE=2004/12/03@16:00
SCHDDATE=2004/12/10@16:00
SCHDDATE=2004/12/17@16:00
SCHDDATE=2004/12/24@16:00
This creates a future schedule request to run a measurement on each of the four dates and times specified.
This is only used for future schedule requests (one or more SCHDDATE keywords must be present), where the job is expected to be active (ACTIVE=YES specified). Specifies that Application Performance Analyzer should retry the request if the target job was not active on the first attempt. Also specifies how many times to retry.
Specified in the format: (mm, FOR=nn), where mm is the number of minutes between retry attempts, and nn is the number of times to retry.
Example: RETRYAFTER=(15,FOR=3)
This is only used for future schedule requests (one or more SCHDDATE keywords must be present), where the measurement is to begin when the job becomes active (ACTIVE=NO specified). Specifies the number of minutes that this request will wait for the job to become active before Application Performance Analyzer expires the request.
Example: SCHDSPAN=120
This indicates that for a specified time interval, if the target job runs again, the measurement should be run again. The For= parm indicates how many times the measurement should potentially be repeated. The time interval is reset after each rerun of the target job. The maximum time interval for a future schedule request is 999 minutes. The maximum time interval for a single occurrence request is 31,680 minutes (22 days).
Example: RUNAGAIN=(60,FOR=3)
This means that for 60 minutes after the target job starts, Application Performance Analyzer will run the measurement again, if the job starts again. It will do this up to three times.
[ Top of Page | Previous Page | Next Page | Contents | Index ]