This option enables the user to control the library the object module is to be stored in and the name it is to be stored under.
Format
| ||||||||||||||||||||||||||||||||||||||||
MODULE-OUTPUT = *STD
An object module is placed in the temporary EAM file of the current task.A link-and-load module (LLM) is placed in a PLAM library with the standard name PLIB.COBOL.<prog-id-name>, using the program name as the element name, and *UPPER-LIMIT (i.e. the highest possible version number) as the version designation.
MODULE-OUTPUT = *OMF
An object module is written to the temporary EAM file. If *OMF is specified for a link-andload module (LLM), the compiler issues a class I (information) message, and the module is placed in the PLAM library PLIB.COBOL.<prog-id-name>.
MODULE-OUTPUT = <c-string 1..1024 with-low>
If the POSIX subsystem is available, you can use this parameter to output a module (LLMs only) to the POSIX file system as an object file.
If <c-string> does not include a directory name, the object file will be stored under the specified file name in the home directory of the current BS2000 user ID. If the object file is to be written to any other directory, <c-string> must include the absolute path name.When selecting a file name, note that object files cannot be further processed, i.e. linked, in the POSIX subsystem unless they have a name ending with the extension “.o”. The compiler does not do any name checking.
This operand is not available in COBOL-BC.
MODULE-OUTPUT = *LIBRARY-ELEMENT(...)
This parameter specifies the PLAM library (LIBRARY=) the module is to be stored in and the element name (ELEMENT=) it is to be stored under.
LIBRARY = <filename 1..54>(...)
Name of the PLAM library in which the module is to be placed. If the PLAM library does not exist, it is created automatically.
ELEMENT = *STD
The element name of the module is derived from the PROGRAM-ID name. The formation of standard element names is described in section "Output of modules", in table 2).
VERSION =
Specifies the version designation
VERSION = *UPPER-LIMIT
If no version designation or *UPPER-LIMIT is specified, the element receives the highest possible version number (indicated by LMS with “@”).
VERSION = *INCREMENT
The element receives the version number of the highest existing version incremented by 1, provided that the highest existing version designation ends with a digit that can be incremented. Otherwise, the version designation cannot be incremented. In this case, *UPPER-LIMIT is assumed and an appropriate error message is output.
Example 3-1
Highest existing version | Version generated by *INCREMENT |
ABC1 | ABC2 |
VERSION = *HIGHEST-EXISTING
The highest existing version in the library is overwritten.
VERSION = <composed-name 1..24>
The element receives the specified version designation. If the version designation is to be incrementable, at least the last character must be an incrementable digit (see Example 3-1).
ELEMENT = <composed-name 1..32>
The user may optionally specify a freely-selected name for link-and-load modules (LLMs).
If a compilation group is being compiled, this operand is ignored, and the element names of LLMs are derived from the respective PROGRAM-ID name (see section "Output of modules", table 2)) instead.
VERSION = *UPPER-LIMIT / *INCREMENT / *HIGHEST-EXISTING / <composed-name 1..24>
Version designation (see the above description of the VERSION operand for object modules).
When a compilation group is compiled, each element is assigned the same version designation.