PRESELECT control statement - example and keywords
* PRESELECT syntax:
PRESelect
IMSID=ALL | imsid | (imsid1,imsid2, ...)
MAXLogs=100 | 999 | nnn | (nnn, abendcode) | (nnn, Rreturncode)
RECON=recond.data.set | (recon.data.set1,recon.data.set2,recon.data.set3)
ActiveOLDS=NO | YES
* SLDS=(slds.data.set,Rnn)
* SLDS=(dsn,Rnn,unit,volser) ** Use for UNCATALOGED SLDS
* SPLITSLDS=FIRST|LAST|BOTH
TIMEZone=LOCAL | ORIGINAL | GMT | (+hhmm) | (-hhmm)
* SKIP=0 | nnnnnnnnn
* LIMit=999999999 | nnnnnnnnn
The following example shows how to use PRESELECT.
//********************************************************************
//*
//* JCL generated by:
//* BMC AMI Log Analyzer for IMS V1.7.00.00
//*
//********************************************************************
//*
//********************************************************************
//*
//* PRESELECT Step
//*
//********************************************************************
//LUIMAIN EXEC PGM=LUIMAIN,REGION=0M
//STEPLIB DD DSN=BMC.V17.LOAD,DISP=SHR
// DD DSN=BMC.BMCPSWD,DISP=SHR
//SYSOUT DD SYSOUT=*
//SYSMDUMP DD SYSOUT=*
//SYSIN DD *
PRESELECT
SLDS=(IMSA.SLDS,R151)
TIMEZONE=LOCAL
SPLITSLDS=FIRST
FILTER
SELECT=DBD=DI21PART OR TRAN=PART OR TRAN=PART1
LUISLDS
DSN=BMC.LUISLDS.SAMP.T1
STORCLASS=DEVSMS
SPACEUNITS=CYL
PRISPACE=300
SECSPACE=300
END
/*
//********************************************************************
//*
//* ANALYZE Step
//*
//********************************************************************
//LUIMAIN EXEC PGM=LUIMAIN,REGION=0M
//STEPLIB DD DSN=BMC.V17.LOAD,DISP=SHR
// DD DSN=BMC.BMCPSWD,DISP=SHR
//SYSOUT DD SYSOUT=*
//SYSMDUMP DD SYSOUT=*
//SYSIN DD *
ANALYZE
SLDS=(BMC.LUISLDS.SAMP.T1,R151)
TIMEZONE=LOCAL
REPORTS
SUMMARY=100
END
/*
//
For more examples, see Allocating-log-record-sources.
PRESELECT control statement keywords
The following table summarizes information about the keywords that you can specify on an PRESELECT control statement.
Keyword (abbreviation) | Valid values | Default | Description | Topic |
|---|---|---|---|---|
ACTIVEOLDS (AOLDS) | NO YES | NO | Specify whether Log Analyzer can select an active OLDS during RECON processing. | |
IMSID | ALL imsid (ims1, ims2, ...) | ALL | Identify the IMS system (or systems) that created log records to be processed. Specify ALL to process records from all IMS systems. | |
LIMIT (LIM) | nnnnnnnnnn | 9999999999 (No limit) | Specify a maximum number of log records to process (after skipping log records, if SKIP is specified). | |
MAXLOGS (MAXL) | nnn (nnn, abendCode) (nnn,RreturnCode) 999 | 100 | if Log Analyzer determines that the number of input log data sets is greater than the specified number, it issues the specified user abend code or return code. Specify 999 to set no limit on the number of input log data sets. | |
RECON | (reconDsn1,reconDsn2, reconDsn3) | None | Explicitly identify a set of RECON data sets to examine for log record sources. You can specify multiple instances of this keyword. | |
SKIP | nnnnnnnnnn | 0 | Specify a number of log records to skip before beginning to process log records. | |
SLDS | (sldsName, Rnnn,unit,volser) | None | Explicitly identify a log data set to read and the version of IMS (Rnnn) that created the log data set. If the data set is not cataloged, specify the unit and the name of the volume that contains the data set. You can specify multiple instances of this keyword. | |
SPLITSLDS | FIRST LAST BOTH | FIRST | Specify the optional SPLITSLDS keyword to control the Log Analyzer processes when a log sequence error occurs while reading SLDS | |
TIMEZONE (TIMEZ) | LOCAL GMT ORIGINAL (+hhmm) (-hhmm) | LOCAL | Specify the time zone for time values that you specify in control statements and for Log Analyzer to use in reports and on panels. |