Using the Batch Command Interface › JCL Return Codes

JCL Return Codes

When the BCI program terminates, it sets a JCL return code which may be tested for successful completion. The return code will have one of the following values:

0

No errors detected.

4

BCI has processed all input cards and issued Important! messages. Check the messages to ensure that BCI has made the correct assumptions.

8

BCI has processed all input cards and has found that serious errors and incorrect results are likely. Check the messages and correct the input.

12

BCI has detected serious errors processing all input cards. The results are incomplete. Check the message and correct the input.

1001-1009

The BCI NCL procedure has ended with a non-zero return code (&RETCODE). The JCL return code is the value in &RETCODE plus 1000. For example, if &RETCODE is set to 2, then the JCL return code returned will be 1002. BCI will issue message N96009 and terminate the job with the JCL return code.

U4095

BCI has detected a serious problem. The BCI output file will contain messages that indicate the nature of the error; it may be an internal error. A dump is produced which may be required for problem diagnosis by your product supplier.

Example: JCL Return Codes

//NMBCI JOB   etc
//NMBCI EXEC PGM=NMBCI
//SYSOUT DD SYSOUT=A
//SYSIN DD *
BCILOGON NMTEST USER TESTBCI/TESTPSWD MENU BCI LU NMDOSBCI TRANSMIT TESTFILE
SHOW USERS
LIST $USERBCI
EXEC TESTPROC
BCIDISC
BCILOGON NMACCTS PASSWORD MONEY USER WAGES
TRANSMIT PAYROLL
BCIDISC
/*
//