Input control parameters

The keywords that you can use in the SYSIN data set are described below.

You can specify various selection criteria to limit the log records that are processed. These are:

Different types of selection criteria can be combined; only records meeting all the criteria are processed.

LRSNSTART(hexadecimal-constant)
Specifies the logical record sequence number (LRSN) from which to begin processing. You cannot use this keyword together with RBASTART. Use this keyword only if your queue manager is in a queue-sharing group.

LRSN values are always greater than A00000000000; this value is used as the start value if a lower value is specified.

You can also use the forms STARTLRSN or STRTLRSN or LRSNSTRT. Specify this keyword only once.

LRSNEND(hexadecimal-constant)
Specifies the logical record sequence number (LRSN) of the last record to be scanned. The default is FFFFFFFFFFFF (the end of the data sets). You can use this keyword only with LRSNSTART.

You can also use the form ENDLRSN.

Specify this keyword only once.

RBASTART(hexadecimal-constant)
Specifies the log RBA from which to begin processing. You cannot use this keyword together with LRSNSTART.

You can also use the forms STARTRBA or ST. Specify this keyword only once.

RBAEND(hexadecimal-constant)
Specifies the last valid log RBA that is to be processed. If this keyword is omitted, processing continues to the end of the log (FFFFFFFFFFFF). You can use this keyword only with RBASTART.

You can also use the forms ENDRBA or EN. Specify this keyword only once.

PAGESET(decimal-integer)
Specifies a page set identifier. The number should be in the range 00 through 99. You can specify a maximum of 10 PAGESET keywords. If PAGESET keywords are specified, only log records associated with the page sets you specify are processed.
URID (hexadecimal-constant)
Specifies a hexadecimal unit of recovery identifier. Changes to data occur in the context of a WebSphere MQ unit of recovery. A unit of recovery is identified on the log by a BEGIN UR record. The log RBA of that BEGIN UR record is the URID value you must use. If you know the URID for a given UR that you are interested in, you can limit the extraction of information from the log to that URID.

The hexadecimal constant can consist of 1 through 12 characters (6 bytes), and leading zeros are not required.

You can specify a maximum of 10 URID keywords.

DATA (hexadecimal-string)
Specifies a data string in hexadecimal.

The string can consist of 2 through 48 characters (24 bytes), and must have an even number of characters.

You can specify a maximum of 10 DATA keywords.

If DATA keywords are specified, only log records that contain at least one of the strings are processed.

RM (resource_manager)
Specifies a particular resource manager. Only records associated with this resource manager are processed. Valid values for this keyword are:
RECOVERY
Recovery log manager
DATA
Data manager
BUFFER
Buffer manager
IMSBRIDGE
IMS(TM) bridge
SUMMARY(YES|NO|ONLY)
Specifies whether a summary report is to be produced or not:
YES
Produce a summary report in addition to the detail report.
NO
Do not produce a summary report.
ONLY
Produce only a summary report (no detail report).
The default is NO.
EXTRACT(YES|NO)
Specifying EXTRACT(YES) will cause each log record that meets the input selection criteria to be written to the appropriate output file, as explained on page The EXTRACT function. The default is NO.