iCan Blog Archive

You probably know that the CPF1164 (Job Ended) message that is sent to the history log contains some basic performance information regarding the job that ended. You can’t see the details of this information via the Display Message Description (DSPMSGD) command or via the Display Log (DSPLOG) command, but the data is available in the history log files and you can write application programs to retrieve this data.

The basic performance information on the CPF1164 message includes:

  • Date and time the job entered the system
  • Date and time the job started
  • Total response time (for interactive jobs) 
  • Total transactions (for interactive jobs)
  • Number of synchronous auxiliary I/O operations

The Performance Information and QHST section in the Information Center is where documentation on this can be found.

What you may not be aware of, is in the IBM i 6.1 release, basic performance information was also added to the CPF1240 (Job ended abnormally) and CPF1241 (Job completed normally) messages.

Unlike the CPF1164 message, the performance information on the CPF1240 and CPF1241 messages is part of the message description and you can display the information with the DSPMSGD command. For example, a DSPMSGD CPF1240 will show the following information at the end of the technical description information:

   -- Entered system date and time:      &9 
   -- Started date and time:             &10
   -- Job type:                          &16
   -- Job subtype:                       &17
   -- CPU seconds used:                  &11
   -- Synchronous auxiliary I/O:         &12
   -- Asynchronous auxiliary I/O:        &13
   -- Ending code:                       &14
   -- Secondary ending code:             &15

By looking at the field data of the message, you can find the details of the data type and length for each of the replacement variables.

There are a few minor differences from the data that is included with the CPF1164 command.

  • The total response time and total transactions fields are not part of the information on the CPF1240 and CPF1241 messages; these messages are only sent for batch jobs and total response time and total transactions are only applicable to interactive jobs.
  • Asynchronous auxiliary I/O counts are included on the CPF1240 and CPF1241 messages.

This blog post was originally published on IBMSystemsMag.com and is reproduced here by permission of IBM Systems Media.