IBM i message

CPF1124: Job started

CPF1124 is an informational message, not an error. IBM i writes it when a job starts in a subsystem, naming the job, the subsystem and when the job entered the system. It is the first message in every job log.

Other names for this code

Also written as MSGCPF1124, CPF1124 job started, job started message AS400, CPF1124 QHST, iSeries CPF1124, CPF1124 CPF1164.

What it means

Every IBM i job has a three-part name in the form number/user/name, for example 123456/PAYUSER/PAYRUN01. When a job starts in a subsystem, the system logs CPF1124. It records the full job name, the date and time it started, the subsystem and its library, and the date and time the job entered the system. For a batch job, the gap between entering the system and starting is the time it spent waiting on the job queue.

The message goes to the job's own log, where it is always the first entry, and to the history log, QHST. Paired with CPF1164, the job ended message, it brackets the life of the job.

As IBM points out, CPF1124 only means the job got into the subsystem without routing errors. It doesn't mean the job did any work. A job that ends seconds later with an error still has a CPF1124 at the top of its log.

Common causes

  • Any job starting in a subsystem logs it. This includes interactive sign-ons, submitted batch jobs, autostart jobs, prestart jobs and server jobs.
  • An interactive sign-on produces one, which is why CPF1124 is used in sign-on reports.
  • A batch job leaving the job queue and starting produces one. The time it entered the system shows when it was submitted.

How to find the problem

  1. In a job log, from DSPJOBLOG or the QPJOBLOG spooled file, CPF1124 is the first message. Put the cursor on it and press F1 for the subsystem and the times.
  2. Search the history log with DSPLOG LOG(QHST) MSGID(CPF1124), or add JOB(PAYRUN01) to narrow it to one job name.
  3. In SQL, the QSYS2.HISTORY_LOG_INFO table function returns QHST entries. Filtering on MESSAGE_ID = 'CPF1124' together with CPF1164 gives a start and end time for each job.
  4. To hide job start and end messages when reading QHST, use DSPLOG with MSGIDSLT(*OMIT) and MSGID(CPF1124 CPF1164).

How to fix it

  • Nothing needs fixing. If you're troubleshooting a job, read past CPF1124 to the messages that follow it.
  • If a job ends seconds after CPF1124, look at the next messages in the log and at the end code in CPF1164.
  • If a batch job sat on the job queue for a long time before CPF1124, check whether the job queue was held or the subsystem's maximum active jobs was reached.
  • If QHST is too busy to read, filter out CPF1124 and CPF1164 with DSPLOG or the SQL function.

IBM documentation

IBM Display Message Descriptions (DSPMSGD). Use the documentation for your installed release.

This link opens the relevant IBM reference library or lookup instructions. Match the complete code and your installed product release; it is not a code-specific review.

Read the installed message description:

DSPMSGD MSGID(CPF1124) MSGF(QSYS/QCPFMSG)

Also inspect the full job log and second-level message text, including substitution values.

Report a correction to WND Software.

Questions

Does CPF1124 mean my job ran successfully?

No. It only means the job started in the subsystem. Check the end code in CPF1164, and the messages between the two, to see what happened.

Can I build a sign-on report from CPF1124?

Yes. IBM documents using CPF1124 and CPF1164 from QHST to list when interactive users signed on and off. Security auditing in QAUDJRN gives more detail if you need it.

Why is there a gap between the entered-system time and the started time?

For a batch job, that's the time the job waited on the job queue before a subsystem picked it up.