bms

Description

Compiles one or more BMS maps.

Parameters

Attribute Description Required
asmdir The name of the directory where Assembler copybooks (.mac files) are to be written. Defaults to the current directory. No
coboldir The name of the directory where COBOL copybooks (.cpy files) are to be written. Defaults to the current directory. No
copybookname The base name of a generated copybook. Defaults to the base name of the BMS copybook being compiled. No
destdir The name of the directory where the output from a compilation of a BMS map (.mod file) is to be written. Defaults to the current directory. No
failonerror Stop the build process if the task exits with a return-code other than 0. Defaults to false. No
forcecompile If true, compiles a BMS source file even if it is not out-of-date. Defaults to false. No
generatemap If true, generates map attributes (/SYSPARM=MAP). Defaults to false. No
generatecopybook If true, generates copybook attributes (/SYSPARM=DSECT). Defaults to false. No
mapname The base name of a generated map. Defaults to the base name of the BMS map being compiled. No
plidir The name of the directory where PL/I include files (.inc) from a compilation are to be written. Defaults to the current directory. No
srcdir The name of the directory where the BMS map files are to be picked up from. Defaults to the current directory. No
srcfile The name of the BMS map source file to be compiled. Must not be used if nested mffilelist elements have been specified. No
verbose If true, causes additional informational messages to be displayed by the task. Defaults to false. No

Parameters specified as nested elements

mfdirlist

Use nested <mfdirlist> elements to specify directives to be used to compile the program(s). See mfdirlist.

mffilelist

Use nested <mffilelist> elements to specify the source file name(s) to be compiled and the copybook locations. See mffilelist.

Errors and return codes

By default, the return code of a <bms> task is ignored. When you set failonerror="true", any non-zero response is treated as an error and means the build exits.

Examples


Copyright © 1984-2015 Micro Focus. All rights reserved.