Using the DEBUG utility
The DEBUG utility is a diagnostic tool for the CMF Extractor.
When you select D - DEBUG from the CMF Extractor Online Utilities menu, the menu shown in the following figure is displayed.
COMMAND ===>
DATA AREA ===> MVT (Select from list below)
MONITOR MODE ===> CPM (CPM or IPM)
FNQE ID ===> (Name of sampler) *
DEC LENGTH ===> (Length in decimal of area to dump)
HEX LENGTH ===> (Length in hexadecimal of area to dump)
ADDRESS ===> (Virtual address; overrides DATA AREA field)
CMF Jobname ===> (If omitted, will select PAS with CXEN=Y)
Valid data areas are:
ASIDT FNQE FNQFWD4 FNQX MVT SAMPSRM SRMWORK
CSAB FNQFWD1 FNQFWD5 GSMP MVTX SRBD WKQE
CSAIB FNQFWD2 FNQFWD6 JES2 SAMPDIE SRBR
CSALOG FNQFWD3 FNQFWD7 JES3 SAMPSRB SRMR
* If DEVS, FNQE ID may be DASD, TAPE, COMM, UREC, GRAF, CHAR, or MIXD
Field descriptions for the DEBUG utility
The fields displayed in the CMF Extractor Debug panel and the information requested for each field are described in the following table.
Some of these fields are optional, depending upon the type of data you are researching.
Field name | Description |
|---|---|
DATA AREA | data area name Enter the data area name of your choice from the list provided; MVT is the default. |
MONITOR MODE | data area name Mode in which CMF MONITOR is operating. This value is either CPM or IPM; CPM is the default. |
FNQE ID | specific sampler’s FNQE ID If DEBUG requires this value for the data area that you have specified, you are prompted to enter the sample’s FNQE ID in this field. Valid FNQE IDs are shown in the Sampler column in the Samplers and Extractor control statements table. Any number of device FNQEs are allowed. If DEVS is specified, the first FNQE found for a device sampler is displayed. If a device sampler was requested for a device class, the class can be specified in place of DEVS. Valid device class values are TAPE, DASD, COMM, UREC, GRAF, CHAR, MIXD. (Use MIXD when you want to view an FNQE for a sampler of mixed device classes.) |
DEC LENGTH | explicit length for the data area, specified as a decimal value If you do not define a value in this field, you can, optionally, define a hexadecimal value in the HEX LENGTH field. If the DEBUG option requires this value for the data area you have specified, you are automatically prompted for the information if neither field is defined. |
HEX LENGTH | explicit length for the data area, specified as a hexadecimal value If you do not define a value in this field, you can, optionally, define a decimal value in the DEC LENGTH field. If the DEBUG option requires this value for the data area you have specified, you are automatically prompted for the information if neither field is defined. |
ADDRESS | storage area address You can display a storage area by specifying an address in this field. A length is required. |
CMF Jobname | allows you to specify the name of the CMF job that is to be the target of the DEBUG utility This option is useful if there are multiple CMF monitor jobs running concurrently. If not specified, the PAS with the CXEN=Y parameter specified will be selected. |
When a data area name is selected and other appropriate information has been entered, CMF MONITOR produces a data area display like the following figure:
COMMAND ===> SCROLL ===> PAGE
Enter HELP for a list of valid commands.
Address Offset CSAB data area
------------------------------------------------------------------------------
03902150 00000 90ECD00C 18CF18B0 58A0B004 18815890 *....... .. ..A..*
03902160 00010 80041B11 43108000 4100000A 19104720 *................*
03902170 00020 C9B28910 00029200 B0AD47F1 C02E47F0 *I I...K. ..1...0*
03902180 00030 C9B247F0 C05A47F0 C0FE47F0 C1AE47F0 *I .0...0...0A..0*
03902190 00040 C22847F0 C24847F0 C2B847F0 C3F047F0 *B..0B..0B .0C0.0*
039021A0 00050 C4BE47F0 C52447F0 C5609680 B0AC1F11 *D..0E..0E.O. ...*
039021B0 00060 BF178001 41101000 5910CA28 4720C9AA *..............I.*
039021C0 00070 5910CA2C 4740C9AA 9108A016 4710C094 *..... I.J......M*
039021D0 00080 9104A015 4710C9A2 9120A016 47E0C9A2 *J.....ISJ.....IS*
039021E0 00090 47F0C0A4 9108A015 4710C9A2 9180A016 *.0.UJ.....ISJ...*
039021F0 000A0 47E0C9A2 D603B070 B0704770 C9A2D73D *..ISO. . ...ISP.*
03902200 000B0 B070B070 5010B074 1B229110 A0154710 * . ... ...J.....*
03902210 000C0 C0C64120 00E40700 47F0C0D0 00007000 *.F...U...0......*
03902220 000D0 180118F2 89F00008 BFFDC0CC 1B110A78 *...2I0..........*
03902230 000E0 12FF4770 C9121831 5030B070 5030B094 *....I..... ... M*
03902240 000F0 18035810 B0741BFF 0E0E47F0 C9CC9680 *.... ......0I.O.*
03902250 00100 B0AC5810 B0804110 10014130 00B01C21 * ... ........ ..*
Using the DEBUG Output panel
Commands that are valid when entered at the COMMAND line on the DEBUG Output panel are shown in the following table.
Condition | Command | Function |
|---|---|---|
any time | A or AGAIN | refreshes the data area display |
when displaying a chained data area | F or FIRST | displays the first entry on the chain |
N or NEXT | displays the next entry on the chain in a push-down stack format | |
ALL | displays the entire chain | |
when displaying a WKQE chain | R | displays the next WKQE on the related chain |
U | displays the next WKQE on the unrelated chain |
Exiting the DEBUG utility
Press the End key to exit the DEBUG utility. You return to the CMF Extractor Online Utilities menu.
Related topic