sfmlog utility options  Transaction status

Chapter 1: Overview

Transaction filtering options

These options filter all transactions in the input file. Only transactions that satisfy the filtering condition are included in the result set.

Key:

Option

Description

-x[gt,ge,lt,le]sernum

Filters by serial number. See key for description type.

Example – to display all transactions with serial number greater than 150:

ims sfmlog -fPending.log -xgt150

-w[gt,ge,lt,le]pronum

Filters by progenitor number. See key for description type.

Example – to display all transactions with progenitor number less than or equal to 150:

ims sfmlog -fPending.log -wle150

-ytranid

Filters by transaction ID, which corresponds to the Fkey field passed into a route call.

Example – to display all transactions with transaction ID equal to “id1”:

ims sfmlog -fPending.log -yid1

-eprodname

Filters by production object name.

Example – to display all transactions routed by production object “prod1”:

ims sfmlog -fPending.log -eprod1

-ddestflavor

Filters by destination flavor.

Example – to display all transactions that are or will be dispatched to the destination with a flavor of 5:

ims sfmlog -fPending.log -d5

-a[gt,lt]age

Filters by transaction age from current time. The age format is in DDD:HH:MM:SS. This option can filter older transactions, but not older than a certain age.

Example – to display all transactions older than 5 hours 30 nominates from current time in the log file:

ims sfmlog -fPending.log -agt0:5:30:0

-t[gt,ge,lt,le]time

Filters by transaction timestamp. The time format is YYYY/MM/DD:HH:MM:SS[.mmm] (milliseconds are optional). This option filters transactions with timestamps greater than, greater than or equal to, less than, or less than or equal to the time argument.

Example – to display all transactions with timestamps greater than or equal to 2003/04/01:15:30:00.000:

ims sfmlog -fPending.log -tge2003/04/01:15:30:00.000

-ppat

Filters by transaction data ASCII string pattern. This option filters transactions that contain the specified ASCII string patterns in the data portion.

Example – to display all transactions that contain the string pattern “hello world” in the data portion:

ims sfmlog -fPending.log -p”hello world”

-bhexpat

Filters by transaction data hexadecimal pattern. This option filters transactions that contain certain hexadecimal patterns and takes the data pattern argument in hexadecimal, separated by commas.

Example – to display all transactions that contain the hexidecimal pattern 41, 42, 43, 44, and 45 in the data portion:

ims sfmlog -fPending.log 
-b41,42,43,44,45

-zstat[,stat]

Filters by transaction status. This filter takes more than one status code as a parameter, and filters out transactions with the same status as the status parameters.

Example – to display all transactions having a COMPLETE or SKIPPED status:

ims sfmlog -fComplete.log 
-zCOMPLETE,SKIPPED

-rroute

Filters by route name. This route name corresponds to the TranID field passed into a route call.

Example – to display all transactions with route name equal to “R1”:

ims sfmlog -fPending.log -rR1

-usrcname

Filters by source name. This source name corresponds to the Source field passed into a route call.

Example – to display all transactions that originate from SRC1:

ims sfmlog -fPending.log -uSRC1

-i

Filters by incomplete transactions.

Example – to display all transactions that are not complete. The same result can be achieved using the -z option:

ims sfmlog -fPending.log -i

-c

Filters by completed transactions.

Example – to display all completed transactions. The same result can be achieved using the -z option.:

ims sfmlog -fCompleted.log -c

-R

Reverse filter. This option reverses the result of the filter so that it does not return transactions that satisfy the filtering condition, but all transactions that do not.

Example – to display all transactions that do not have a CANCELLED status:

ims sfmlog -fPending.log -zCANCELLED -R

-j

Filters transactions by destination status. Valid parameters are jdesttype, destflavor, and status. Example – filters for transactions containing pending instances for destination (aim, 1) in the pending log:

ims sfmlog -fPending.log -jaim,1,PENDING




Copyright © 2005. Sybase Inc. All rights reserved. Transaction status

View this book as PDF