ZFCPDBF(1)

NAME
zfcpdbf - zfcp trace data sort/analyse tool.

SYNOPSIS
zfcpdbf [OPTIONS] <adapter>
zfcpdbf {-h|-v}

DESCRIPTION
zfcpdbf Interprets the information from various logging and tracing sources, e.g. zfcp-, qdio- and cio-trace records and, if available, system messages.

OPTIONS

-h, --help
    Print usage information, then exit.

-v, --version
    Print version information, then exit.

-x <AREA[,AREA]>, --exclude=<AREA[,AREA]>
    list of trace areas to exclude (default none).

-i <AREA[,AREA]>, --include=<AREA[,AREA]>
    list of trace areas to include (default all).

-z , --zfcp-only
    zfcp trace areas only (short cut).

-t <DIFF>, --timediff=<DIFF>
    highlight requests with a round-trip processing time of <DIFF> or more.

-e, --def-error
    do NOT show deferred error messages.

-f, --force
    force execution on a detected version mismatch.

-p <PATH>, --path=<PATH>
    use directory <PATH> for the location of the trace records.

-r <PATH>, --root=<PATH>
    prepend <ROOT> to standard trace record location.

PARAMETERS
<AREA> may be REC, HBA, SAN, SCSI, QDIO, QDIO_SETUP, QDIO_ERROR, CIO_TRACE, CIO_MSG, CIO_CRW, KERNEL or MULTIPATH. <DIFF> is the value in seconds which has to be lapsed between sending the request and receiving its response. <PATH> is specifying the location(directory) of trace records which were pulled from another system, e.g. pulled from a dump. <ROOT> is specifying a directory which has to be prepended to the standard location of the trace records, e.g. typically used in conjunction with the result of the dbginfo script. <PATH> and <ROOT> are only useful if used on non-live systems and therefore typically used by service- or development-staff. <adapter> aka busid is specifying the host adapter of which the trace information should be processed. if a 4-digit value is provided it is automaitically extended to the correct format 0f 0.0.xxxx.