When you call a CODE-1 Plus module, you must pass, as parameters (addresses), the names of the predefined call areas. These call areas are blocks of memory containing data that is used by both your program and the CODE-1 Plus Matcher. Each call area has a specific copybook with which it is associated. These copybooks describe the data that is stored in each byte of the call area. The copybooks are very specific, so that the driver and called module "know" where each piece of data is stored in the call area. Therefore, the copybooks must not be altered in any way.
Copybooks of the call areas are supplied to call the Batch Matchers (C1MATCHx) as:
-
COBOL (P9IN, P9OUT, P9AUDIT, and P9INTRF)
-
Assembler (ASMPARMI and ASMPARMO)
-
PL/I (PLIP9I and PLIP9O)
-
ILE RPG on IBM i (P9INR, P9OUTR, P9AUDITR, and P9INTRFR)
If you are calling the CODE-1 Plus matcher from a CICS application, you must use the C1MATCHI matcher and pass a single 01-level call area. The copybook P9COMM is supplied with the software and it combines the call areas previously described.