Before you begin
You must create an IPCS dump directory before you can use IPCS in batch mode. When setting up IPCS, your installation may customize IPCS for its users. This customization can include modifying the IBM-supplied BLSCDDIR CLIST with default values for creating an IPCS dump directory.Why and when to perform this task
To view messages or application trace data from Component Trace, you must use the interactive problem control system (IPCS) to format the data. Using IPCS in batch mode is the easiest method of formatting data, especially if you do not have much experience with using IPCS, TSO/E and ISPF. Through batch mode, you can use IPCS to format trace data and write it to an MVS data set. Optionally, you may copy the contents of that data set into an HFS file for viewing.
When your installation has modified the BLSCDDIR CLIST the steps outlined herein will create an IPCS dump directory.
BLSCDDIRcommand, specifying the data set name.
For example, to create a dump directory named IBMUSER.DDIR, enter:
%blscddir dsn('ibmuser.ddir')
If your installation has not customized IPCS, you might need to alter other BLSCDDIR CLIST parameters. See the z/OS MVS IPCS User's Guide, SA22-7596 and z/OS MVS IPCS Commands, SA22-7594 for more details about using the BLSCDDIR CLIST to create a dump directory.
Perform the following steps to use IPCS in batch mode to format application trace data:
Steps for this task
TSO/E OPUTcommand to copy the formatted data from the MVS data set into an HFS file.
//IBMUSERX JOB , // CLASS=J,NOTIFY=&SYSUID,MSGCLASS=H //IPCS EXEC PGM=IKJEFT01,REGION=4096K,DYNAMNBR=50 //IPCSDDIR DD DSN=IBMUSER.DDIR,DISP=SHR //IPCSDOC DD SYSOUT=H //JRASTRC DD DSN=IBMUSER.CB390.CTRACE,DISP=SHR //IPCSPRNT DD DSN=IBMUSER.IPCS.OUT,DISP=OLD //SYSTSPRT DD SYSOUT=* //SYSTSIN DD * IPCS DROPDUMP DDNAME(JRASTRC) PROFILE LINESIZE(80)PAGESIZE(99999999) SETDEF NOCONFIRM CTRACE COMP(SYSBBOSS) DDNAME(JRASTRC) FULL PRINT + NOTERMINAL DROPDUMP DDNAME(JRASTRC) END /* //OPUT EXEC PGM=IKJEFT01,REGION=4096K,DYNAMNBR=50 //SYSTSPRT DD SYSOUT=* //SYSTSIN DD * oput 'ibmuser.ipcs.out' '/u/ibmuser/ipcs/jrastrace.txt' TEXT /*
OPUTcommand processing will create a new HFS file, if the one specified does not exist, and grants read and write access to that file for your user ID only.
If you do specify an existing HFS file, the
OPUTcommand processing will write over any data that is already in that file. If you want to know more about the
OPUTcommand, see the z/OS UNIX System Services Command Reference, SA22-7802.
IPCSPRNT DDstatement and then (optionally) copied to the HFS data set. You must either pre-allocate this data set, or change the sample JCL to allocate the data set. This data set should have a record format of VBA and a record length of 133.
What to do next
Once you are done you can use a UNIX editor, such as vi, to view your trace data in the HFS file. If you want to know more about the UNIX editors, see z/OS UNIX System Services User's Guide, SA22-7801 .
CTRACE enables you to view multiple traces together with the trace data from the various sources intermixed based on the time stamp. See z/OS MVS IPCS Commands, SA22-7594 , for specifics on using this
MERGEsubcommand.