Using BMS map sets in application programs

The procedure to use BMS map sets in application programs is summarized.

About this task

Use the following procedure before you install an application program to run under CICS®.

Procedure

  • Create any BMS map sets used by the program, as described in Installing map sets and partition sets.
  • Include the physical map sets (used by BMS in its formatting activities) in a data set that is in the DFHRPL or dynamic LIBRARY concatenation.
  • Either include the symbolic map sets (copied into the application programs) in a user copy library, or insert them directly into the application program source.

    The DFHMAPS procedure writes the symbolic map set output to the library specified on the DSCTLIB parameter, which defaults to the CICSTS53.CICS.SDFHMAC library. To include symbolic map sets in a user copy library, use the following steps:

    1. Specify the library name by the DSCTLIB=name operand on the EXEC statement for the DFHMAPS procedure used to install physical and symbolic map sets together.
    2. Include a DD statement for the user copy library in the SYSLIB concatenation of the job stream used to assemble and compile the application program.

      If you choose to let the DFHMAPS procedure write the symbolic map sets to the CICSTS53.CICS.SDFHMAC library (the default), include a DD statement for the CICSTS53.CICS.SDFHMAC library in the SYSLIB concatenation of the job stream used to compile the application program. This is not necessary for the DFHEITAL procedure used to assemble assembler language programs, because these jobs already include a DD statement for the CICSTS53.CICS.SDFHMAC library in the SYSLIB concatenation.

    3. For PL/I, specify a library that has a block size of 32760 bytes. This is necessary to overcome the blocksize restriction on the PL/I compiler.

What to do next

For more information about installing map sets, see Installing map sets and partition sets. For information about writing programs to use BMS services, see Basic mapping support.