z/OS Batch Command Server dtxprof usage

The dtxprof utility command is available to use with the z/OS Batch Command Server. It profiles maps and analyzes map execution behavior.

To use the dtxprof utility command:

  1. Make a copy of the JCL file that executes the map on which the dtxprof utility command profiles.
  2. Change the program name from MERCATOR or DTXCMDSV to DTXPROF in one of the copies of the JCL file.
  3. Specify the command line switches you want to use with the dtxprof utility command in the PARM field on the EXEC statement of the JCL.

    If the PARM field length exceeds the 100-character limit, place the DTXCMDSV map command line in a file and specify -dtx "-@ddname" in the PARM field along with the dtxprof command line you want to use.

    For more information about the -@ddname command line option, see the Command Server documentation.

  4. Add PROF1 and PROF2 Data Definition (DD) cards.

dtxprof JCL example

The following example JCL code shows how you can use the dtxprof utility command with the z/OS Batch Command Server.


//STEP1 EXEC PGM=DTXPROF,REGION=0M,
// PARM='-f -t -fs -ts -o DD:PROFOUT -dtx "-@CMD"'
...
...
//CMD       DD *
   REVERSE /VX0D,X0A REVERSEI /VX0D,X0A REVERSEO
/*
//PROF1    DD DSN=&&PROF01,DCB=(RECFM=FBS,LRECL=23476,BLKSIZE=23476),     
//            UNIT=3390,SPACE=(CYL,(0100,050),RLSE),                      
//            DISP=(NEW,DELETE,DELETE)                                    
//PROF2    DD DSN=&&PROF02,DCB=(RECFM=FBS,LRECL=23476,BLKSIZE=23476),     
//            UNIT=3390,SPACE=(CYL,(0100,050),RLSE),                      
//            DISP=(NEW,DELETE,DELETE)       
//PROFOUT DD SYSOUT=*
...
...

-@ddname identifies the Data Definition (DD) name that points to the file containing the DTXCMDSV map command line.