C-LANG Statements › CCEXIT Statement—Specify Type of Exit Code Returned by an i5/OS Job

CCEXIT Statement—Specify Type of Exit Code Returned by an i5/OS Job

The CCEXIT statement specifies the type of exit code returned by an i5/OS job. The exit code can be the job’s ending severity code, the return code of an ILE program or module, or the return code of an OPM program.

Note: The default type is *SEVERITY. If you do not specify the CCEXIT statement in your job definition, the job sends the ending severity code as the exit code.

Supported Job Type

This statement is optional for the i5/OS job type.

Syntax

This statement has the following format:

CCEXIT *PROGRAM|*SEVERITY|*USER

*PROGRAM

Sends the return code of an OPM program. For example, if your job runs an OPM RPG or OPM COBOL program that contains an exit or return statement, that return code is sent as the exit code.

Note: If the program does not set a return code, the i5 system returns a 0 (zero), which is sent as the exit code. By default, an exit code of zero (0) is interpreted as job success.

*SEVERITY

Sends the job’s ending severity code.

*USER

Sends the return code of an ILE program or module. For example, if your job runs an ILE C or ILE RPG program that contains an exit or return statement, that return code is sent as the exit code.

Note: If the program does not set a return code, the i5 system returns a 0 (zero), which is sent as the exit code. By default, an exit code of zero (0) is interpreted as job success.

Notes:

• Ensure that you specify the appropriate exit code type for the program you are running. If you specify the wrong exit code type (for example, you specify *PROGRAM for an ILE program), the agent sends 0 (zero) as the exit code. By default, an exit code of zero (0) is interpreted as job success.
• If you specify *PROGRAM or *USER, the agent adds a custom message before the final completion message in the job's spool file (job log). This message is required to track the program's return code.

Example: Send a C Program's Return Code as the Job's Exit Code

In this example, SALARY is a C language program. The I5AG agent sends the SALARY program's return code to the scheduling manager.

AGENT I5AG
CLPNAME SALARY
CCEXIT *USER

Example: Send an OPM COBOL Program's Return Code as the Job's Exit Code

In this example, PAYROLL is an OPM COBOL program. The I5AG agent sends the PAYROLL program's return code to the scheduling manager.

AGENT I5AG
CLPNAME PAYROLL
CCEXIT *PROGRAM