Input control parameters

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

We 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. We 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.

We 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.

We can also use the form ENDLRSN.

Specify this keyword only once.

RBASTART(hexadecimal-constant)

Specifies the log RBA from which to begin processing. We cannot use this keyword together with LRSNSTART.

We 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.

We 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. We 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 use. If you know the URID for a given UR that you are interested in, we 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.

We 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.

We 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 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.