Creating side files using IPVLANGX
Use the IPVLANGX program to create a side file from a compiler listing.
The sample JCL in Sample JCL to compile a COBOL program and store the side file is provided as member IPVSCMPS in the
IPV.SIPVSAM1 data set. It performs the following steps:
- Compiles a COBOL program. Note: You can only compile one program per compile step in order to name the compiler listing PDS(E) member (if using a partitioned data set), and to ensure that only one compiler listing is written to the output file. Nested COBOL programs are not supported.
- Executes IPVLANGX to process the listing and store it as a side file where the ADFz products can access it. (For return codes issued by IPVLANGX, see IPVLANGX return codes.)
- Writes the listing as part of the job output.
After you have created and stored a side file, there is no benefit to ADFz products in retaining the listing.
If you already have listings, you can turn them into side files. Here is sample JCL to do this
conversion (it is provided as member IPVSFILE in the IPV.SIPVSAM1 data set):
Notes:
- ❶
- DDname must be LISTING for all types of compiler listings, or SYSADATA for an assembler ADATA file.
- ❷
- DDname must be IDILANGX for the output LANGX side file. The data set must be sequential or PDS(E), RECFM=VB, LRECL≥1562.
Refer to the documentation for the individual ADFz products for information about how to provide the LANGX side file for processing.
A compiler listing is the only data format that IPVLANGX accepts as input, with the exception of SYSADATA for assembler.