Previous Topic: Not TrackingNext Topic: Dumps of CA7ONL

Troubleshooting Best Practices › SASSXTRK Program

SASSXTRK Program

You are sometimes asked to run the program SASSXTRK so that CA Support can view your CA WA CA 7 Edition log file for problem solving. SASSXTRK is a program that is used to extract records from the CA WA CA 7 Edition log file. The SASSXTRK program sample JCL is provided in the sample JCL CAL2JCL as member AL2ZXTRK.

This program produces a control statement edit report and an output file that contains the extracted CA WA CA 7 Edition log records. Other reporting jobs can use this output file to produce specific reports. Depending on the SYSIN, the program can extract records based on a date and time, a job name, or both.

Use the following sample JCL to execute the SASSXTRK program:

//jobname JOB ... 
//EXTRACT     EXEC PGM=SASSXTRK 
//STEPLIB     DD DISP=SHR,DSN=ca7.cal2load 
//LOGIN       DD DISP=SHR,DSN=ca7.logtape 
//LOGOUT      DD DISP=(NEW,CATLG,DELETE),DSN=extracted.file, 
//            UNIT=SYSDA,SPACE=(CYL,(10,5),RLSE), 
//            DCB=(RECFM=VB,LRECL=2100,BLKSIZE=21004) 
//SYSOUT      DD SYSOUT=* 
//SYSIN       DD *            
*            yydddhhmm yydddhhmm 
/*

The LOGIN DD is required and can be either the log or history files. The LRECL must be 2100.

The LOGOUT DD is required and can be DASD or tape. The LRECL is copied from the LOGIN DD statement. This file contains a copy of the log records that were selected.

The SYSOUT DD is required and contains information from the control statement edit routine and possibly some error messages.

The SYSIN DD is required and is the control statement for selecting records to write to LOGOUT. The control statement has the following format:

*         yydddhhmm yydddhhmm

You can specify a job name on the control statement starting in column 1. If you do, only records with the matching job name are extracted. If you are running this utility to provide log data for CA Support, use an asterisk (*) in column 1 to denote a generic request. The generic requests extract all records for the requested time frame.

Business Value:

Understanding how to obtain log records for a specified time frame helps when troubleshooting many issues.