Using the new trace formatting tool in 8.5.0

[Ed_Arnold]

Here I have added instructions to the LOAD job in the ODF IVP to take a full trace:


//STEP1     EXEC PGM=ARSLOAD,REGION=0M,                         
// PARM=('/-V //DD:PARM')                                       
//STEPLIB    DD DISP=SHR,DSN=ARS.ARSV850.SARSLOAD               
//           DD DISP=SHR,DSN=DSN.DB2VA10.SDSNEXIT               
//           DD DISP=SHR,DSN=DSN.DB2VA10.SDSNLOAD               
//           DD DISP=SHR,DSN=DSN.DB2VA10.SDSNLOD2               
//ARSBIN     DD PATH='/usr/lpp/ars/V8R5M0/bin'                 
//SYSPRINT   DD SYSOUT=*,DCB=(RECFM=FBA,LRECL=134,BLKSIZE=134)                                         
//SYSOUT     DD SYSOUT=*                                       
//STDERR     DD SYSOUT=*                                       
//STDOUT     DD SYSOUT=*                                                                           
//PARM     DD *                                                 
-h                                                             
ARCH850                                                         
-u                                                             
odadmin                                                         
-p                                                             
somepw                                                         
-1                                                             
/tmp/ed.trc                                                     
-2                                                             
ALL=15                                                             
-nfv                                                           
-g
"Daily sales invoices" 
/tmp/salesinvoice   

 

I formatted the trace with the following command:

/usr/lpp/bin/ars/V8R5M0/bin/arstfmt -i /tmp/ed.trc -o /tmp/ed.trc.txt

Here's a sample of the output unformatted and formatted  (also there's more stuff to the right not shown):

BROWSE    /SYSTEM/tmp/ed.trc                         Line 00000000 Col 001 080  Command ===>                                                  Scroll ===> CSR  ********************************* Top of Data ********************************** ........^......................... .?.?.<.|. .?................................+ ARS_TMP=/ars/V850/tmp....+?Yv..?,.......?..........?...........SYS11277.T091021. ARSSOCK_TCP_NODELAY=0....+?Yv..??.......?..........?...........SYS11277.T091021. .......?......................SYS11190.T075431.RA000.ARNADMIN.SRCCMS.H01(ARNADMI ArsOSMVS_DupChk_Query...r.....+?Yv...........?......................SYS11190.T07 n.......?......................SYS11190.T075431.RA000.ARNADMIN.SRCCMS.H01(ARNADM ].......?......................SYS11190.T075431.RA000.ARNADMIN.SRCCMS.H01(ARNADM ArcLGENP_KeywordValue...Y.....+?Yv..?G.......?......................SYS11190.T08 ArcLGENP_KeywordValue...2.....(ArcI32) keyword........+?Yv..??.......?..........

BROWSE    /SYSTEM/tmp/ed.trc.txt                     Line 00000000 Col 001 080  Command ===>                                                  Scroll ===> CSR  ********************************* Top of Data ********************************** z/OS-03.21.00-ARSLOAD-8.5.0.2-12/30/2011 11:36:53                                83888271:2389564222599069696 12/30/2011 11:36:53:348411 FLOW SYS11277.T091021.RA 83888271:2389564222599069696 12/30/2011 11:36:53:348443 INFO SYS11277.T091021.RA 83888271:2389564222599069696 12/30/2011 11:36:53:396987 FLOW SYS11277.T091021.RA 83888271:2389564222599069696 12/30/2011 11:36:53:433237 FLOW SYS11277.T091021.RA 83888271:2389564222599069696 12/30/2011 11:36:53:434900 ERROR SYS11277.T091021.R  rc=1                                                                            83888271:2389564222599069696 12/30/2011 11:36:53:434945 FLOW SYS11277.T091021.RA 83888271:2389564222599069696 12/30/2011 11:36:53:434997 FLOW SYS11277.T091021.RA 83888271:2389564222599069696 12/30/2011 11:36:53:448470 INFO SYS11277.T091021.RA

[Ed_Arnold]

Sample batch job I use to for arstfmt:

//STEP1    EXEC PGM=BPXBATCH,REGION=0M           
//*                                             
//STEPLIB  DD DISP=SHR,DSN=ARS.ARSV850.SARSLOAD 
//         DD DISP=SHR,DSN=DSN.DB2VA10.SDSNEXIT 
//         DD DISP=SHR,DSN=DSN.DB2VA10.SDSNLOAD 
//         DD DISP=SHR,DSN=ARS.IXM.SIXMLOD1     
//SYSPRINT DD SYSOUT=*                           
//SYSOUT   DD SYSOUT=*                           
//STDERR   DD SYSOUT=*                           
//STDOUT   DD SYSOUT=*                           
//STDPARM DD *                                   
PGM /usr/lpp/ars/V8R5M0/bin/arstfmt             
-i /tmp/ed.trc                                   
-o /tmp/ed.txt                                   
/*                                               
//STDENV DD *                                   
CLASSPATH=/usr/lpp/java/J7.0_64/lib/core.jar     

[ibmarthin]

Hi Ed

I get this error running arstfmt: CEE3501S The module IXM4C7A was not found.

I see you have this in your STEPLIB: DD DISP=SHR,DSN=ARS.IXM.SIXMLOD1

Where did you find it?

[Greg Ira]

Marthin,
From the 8.5 readme:
IBM XML Toolkit for z/OS required for tracing, trace formatting, and running the XML portion of the IVPs

The XML Parser found in the IBM XML Toolkit for z/OS is now required for product installation and the creation of trace output and the formatting of the trace output. Minimum requirement is: IBM XML Toolkit for z/OS V1.10 with 64-bit support (PTFs UA51089, UA51090, and UA51091). See http://www.ibm.com/systems/z/os/zos/tools/xml/ .

The XML Toolkit must be in the LIBPATH for:

o ODWEK
o arsxml
o arsslu
o arstfmt

Failure to have the LIBPATH setup properly may be indicated by message:

"CEE3501S The module IXM4C7A was not found." (may also show IXM4C7Q)
Sample LIBPATH setting:
LIBPATH=/usr/lpp/xml/xml4c-5_7/lib:$LIBPATH
export LIBPATH

[ibmarthin]

Aha.
Thanks Greg

[Ed_Arnold]

Note:  in V9.0 and up you no longer need the XML Toolkit