Creating the EQALANGX file for an assembler program

Note: The EQALANGX program is part of IBM® Application Delivery Foundation for z/OS® Common Components.

Use the EQALANGX program to create the EQALANGX file. The EQALANGX program is an alias of IPVLANGX, which is shipped as part of the ADFz Common Components. It is in IPV.SIPVMODA. It is the same as the IDILANGX alias that Fault Analyzer uses and the CAZLANGX alias that Application Performance Analyzer uses. The module names can be used interchangeably.

For further information about the xxxLANGX program, look for IDILANGX in the Fault Analyzer User's Guide and Reference. For return codes and messages, look for IPVLANGX in the IBM Application Delivery Foundation for z/OS Common Components Customization Guide and User Guide.

To create the EQALANGX files without using IBM z/OS Debugger Utilities, use JCL similar to the following:

//XTRACT EXEC PGM=EQALANGX,REGION=32M,
//  PARM='(ASM ERROR LOUD'
//STEPLIB DD DISP=SHR,DSN=IPV.SIPVMODA
//SYSADATA DD DISP=SHR,DSN=yourid.sysadata
//IDILANGX DD DISP=OLD,DSN=yourid.EQALANGX

The following list describes the variables used in this example the parameters you can use with the EQALANGX program:

PARM=

(ASM: Indicates that an assembler module is being processed.
ERROR: This parameter is suggested but optional. If you specify it, additional information is displayed when an error is detected.
LOUD: The LOUD parameter is suggested, but optional. If you specify it, additional informational and statistical messages are displayed.

The messages displayed by specifying the ERROR and LOUD parameters are Write To Operator or Write To Programmer (WTO or WTP) messages. See the IBM Application Delivery Foundation for z/OS Common Components Customization Guide and User Guide for detailed information about the messages and return codes displayed by the IPVLANGX program.

IPV.SIPVMODA

The name of the data set that contains the ADFz Common Components load modules. If the ADFz Common Components load modules are in a system linklib data set, you can omit the following line:

//STEPLIB DD DISP=SHR,DSN=IPV.SIPVMODA

yourid.sysadata

The name of the data set containing the SYSADATA output from the assembler. If this is a partitioned data set, the member name must be specified. For information about the characteristics of this data set, see HLASM Programmer's Guide.

yourid.EQALANGX

The name of the data set where the EQALANGX debug file is to be placed. This data set must have variable block record format (RECFM=VB) and a logical record length of 1562 (LRECL=1562).

z/OS Debugger searches for the EQALANGX debug file in a partitioned data set with the name yourid.EQALANGX and a member name that matches the name of the first CSECT in the assembly. If you want the member name of the EQALANGX debug file to match the first CSECT in the assembly, you do not need to specify a member name on the DD statement. Otherwise, you must specify a member name on the DD statement. In this case, you must use the SET SOURCE command to direct z/OS Debugger to the member containing the EQALANGX data.

z/OS Debugger does not support debugging of Private Code (unnamed CSECT).