The GenerateJobList.jar program is designed to analyze the zBNA client output, 
then generate an input for the next APA/Strobe profiling step.

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Execution instructions: 

1. Run GenerateJobList.jar from the command prompt by issuing:
 
   java -jar GenerateJobList.jar

   or double click the GenerateJobList.bat file provided (Windows OS only)

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Program description:

GenerateJobList.jar
 - reads "zBNA CSV Job & Steps details" report 
 - removes every row with STC/TSU value in the Job Class column, 
   or if any other STC/TSU (IBM default) names are used for started task and 
   TSO users, then  alternatively removes the rows with those customized names 
 - removes every row with program names such as: IEBCOPY, IEFBR14, SORT, etc. 
   which are 'non-COBOL' programs 
 - removes every row with a blank program name 
 - removes duplicate entries corresponding with the same named job/program pairs 
 - calculates sub total CPU for those multiple entries and finally generates a 
   single entry representing that particular job/program pair
 - removes all columns except the following three: 
   Job Name, Program Name and CPU Time
 - introduces 'Count' column showing the number of job/program pair repetitions.

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Program input:

The GenerateJobList.jar program expects

1. The input Job & Steps CSV file to be provided. You will be prompted for this
file selection. The sample file sample.jobsteps.csv file is provided for trial 
execution of the GenerateJobList.jar file. Once ready for zBNA analysis of your 
environment, generate your own zBNA Job and Step CSV report file. 

2. The program exclusion list file to be provided. You will be prompted for 
this file selection. The default file named default.exclude.csv is provided for
your convenience. It consists of a pre-coded program exclusion list consisting  
of program names commonly known as non-COBOL programs. It can be modified to    
include additional non-COBOL program names specific to the user's environment,    
as well as new 'Job Class' or 'Service Class' names representing started tasks     
or TSO clients on your system. The new name can be added in any order into the 
corresponding column, and it's not case sensitive. For example, the new program 
name you decided to be excluded should be introduced into 'Program name' column. 
    
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Program output:

The GenerateJobList.jar program generates a single output file. You will be 
prompted to specify its name and location to save this file at.

Also two auxiliary files history.txt & log.txt are generated. 
- history.txt file is used to remember last used directories,
- log.txt file is used to keep the details about program progress and results.   

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Files included in the ZIP package:

GenerateJobList.jar
GenerateJobList.bat
readme.txt
default.exclude.csv
sample.jobsteps.csv