Assembler Customization

This article describes the JCL Procedure that you can use to integrate modern integrated development environments (IDEs) with Assembler programs running under CA IDMS.
idms19
This article describes the JCL Procedure that you can use to integrate modern integrated development environments (IDEs) with Assembler programs running under CA IDMS.
2
2
JCL Procedure
IDMSJMLA
IDMSJMLA is a JCL Procedure that invokes the CA IDMS DML Precompiler for Assembler programs that either run-under or access CA IDMS. This procedure also invokes the system assembler and Linkage Editor. IDMSJMLA is invoked when certain menu actions are performed within IDEs, and should be added to one of your system PROCLIBs.
A sample REXX Exec is not provided for Assembler, due to the lack of pre-processor support for this language within IDEs.
Customizing the JCL Procedure
The IDMSJMLA JCL Procedure must be configured both within z/OS and IDEs.
z/OS
The following variables must be configured within IDMSJMLA:
  • UNITDMLA
    The unit name for all files that are allocated in the DMLC precompile step.
  • UNITA
    The unit name for all files that are allocated in the Assembler step.
  • IDMSLIB1
    The Data Set Name for your Network loadlib or DBA load library.
  • IDMSLIB2
    The Data Set Name for your Custom load library.
  • IDMSLIB3
    The Data Set Name for your complete CA IDMS load library.
  • SYSIDMS
    The Data Set Name for the SYSIDMS DD statement in the DMLC step.
Modern IDEs
To invoke the IDMSJMLA proc, modify the following items in the
Procedures and Steps
section within the
Property Group
that is associated with your sub-project.
To locate the
Procedures and Steps
section,
follow this navigation:
  1. Within the IDE Property Group window, edit the
    Property Group
    that is associated with your sub-project.
  2. Select the
    Assembler
    tab.
  3. Select
    Procedures and Steps
    .
  4. Expand
    Step options
    , and add the following
    Procedure & Steps:
    1. IDMSJMLA - DMLA
    2. IDMSJMLA - ASM
  5. Configure the following items for the DMLA step:
    1. Options:
      Specify NOINSTALL. This setting prevents the storage of the RCM into the dictionary for programs that use SQL.
    2. Support Error Feedback:
      Do not check this box.
  6. Configure the following items for the ASM step:
    1. Listing output data set
      The Data Set Name that is used to store the listing file generated by the compiler.
    2. Object deck data set
      The Data Set Name that is used to store the Object module generated by the compiler.
    3. Macro libraries
      One or more data set libraries (separated by a space) used for the Assembler, SYSLIB DD statement.
      To recognize a CA IDMS macro, you must add your CA IDMS macro library to this field. Adding the macro to this field also allows you to open the macro definition by pressing the control key and hovering over a macro name.
    4. Support Error Feedback
      Check this box if you want to use the automated mechanism for reporting compiler errors through the
      Remote Error List
      in the IDE.
    5. Data set qualifier for compiler errors
      The Data Set prefix that is used to communicate compiler errors to the IDE.
Customized CA IDMS User Macro File
CA IDMS provides an XML user macro file, IDMSUMAC, that includes DML Assembler Macros for integration with IDEs.
IDMSUMAC can be uploaded into the
Editor Options
section within the Property Group that is associated with your sub-project.
To locate
Editor Options
to upload your DML Assembler XML Macro file, follow this navigation:
  1. Within the IDE Property Group window, edit the
    Property Group
    that is associated with your sub-project.
  2. Select the
    Assembler
    tab.
  3. Select
    Editor Options
    .
  4. Within the
    General
    section, click
    Manage
    .
  5. Select the
    Macro Instructions
    tab.
  6. Click
    Import
    to import a
    Macro file
    .
  7. Click on the
    File
    button.
  8. Click
    Browse
    and select the <
    DMLA XML macro file>
    .
  9. Click
    OK
    .
  10. Click
    Finish
    to upload the macro into your Macro Instructions list.
  11. Click
    OK
    to complete the macro upload process.
Benefits of Applying the CA IDMS User Macro
The following benefits are available when editing an Assembler source program:
  • Content assist, by pressing CTRL key and space bar
  • Syntax checking
    When CA IDMS pre-compiler directive statements do not follow Assembler standards, the syntax checker may flag those statements as errors.