MODIFY-CIF-PROPERTIES

Aliases:

SET-CIF-PROPERTIES MODIFY-INFO-FILE-PROPERTIES SET-INFO-FILE-PROPERTIES

This statement can be used to instruct the compiler to create a CIF (Compiler Information File), which may include information on some or all compiler listings. For each compiled source program, the CIF is written to a separate file, which can then be processed further with the global listing generator (see "Controlling the global listing generator)" for details).

MODIFY-CIF-PROPERTIES

CONSUMER= *UNCHANGED / *NONE / *ALL / list-poss(9): *BY-LISTING-PROPERTIES / *OPTIONS /
							*SOURCE / *PREPROCESSING-RESULT / *DATA-ALLOCATION-MAP /
							*CROSS-REFERENCE / *PROJECT-INFORMATION / *ASSEMBLER-CODE /
							*SUMMARY
,INCLUDE-INFORMATION= *UNCHANGED / *NONE / *ALL / *USER-INCLUDES-ONLY
,OUTPUT= *UNCHANGED / *NONE / *STD-FILE / *SOURCE-LOCATION / <filename 1..54> /
			<posix-pathname> / *LIBRARY-ELEMENT(...)
	*LIBRARY-ELEMENT(...)
		|		LIBRARY= *STD-LIBRARY / *SOURCE-LIBRARY / <filename 1..54>
		|		,ELEMENT= *STD-ELEMENT(...) / <composed-name 1..64 with-under>(...)
		|			*STD-ELEMENT(...)
		|				|		VERSION= *UPPER-LIMIT / <composed-name 1..24 with-under>
		|			<composed-name 1..64 with-under>(...)
		|				|		VERSION= *UPPER-LIMIT / <composed-name 1..24 with-under>

CONSUMER = *UNCHANGED
The value specified in the last MODIFY-CIF-PROPERTIES statement applies.

CONSUMER = *NONE
No permanent CIF is created.
When local listings are requested (with MODIFY-LISTING-PROPERTIES), a temporary CIF is created (with prefix #T) to generate these listings. This CIF is deleted at TASK end.

CONSUMER = *ALL
The created CIF contains information on all listings that can be generated, depending on which compiler components (PREPROCESS, CHECK-SYNTAX, COMPILE) are run.

CONSUMER = list-poss(9): *BY-LISTING-PROPERTIES / *OPTIONS / *SOURCE / *PREPROCESSING-RESULT / *DATA-ALLOCATION-MAP / *CROSS-REFERENCE / *PROJECT-INFORMATION / *ASSEMBLER-CODE / *SUMMARY

A CIF containing information on the specified listings is created.

*BY-LISTING-PROPERTIES: CIF information is created for all listings requested with the MODIFY-LISTING-PROPERTIES statement.

INCLUDE-INFORMATION = *UNCHANGED / *NONE / *ALL / *USER-INCLUDES-ONLYThis option can be used to control whether and from which header files CIF information is to be generated for the source, preprocessor and cross-reference listings. By default, only the user-defined headers and not the standard headers are taken into account.

OUTPUT = *UNCHANGED
The value specified in the last MODIFY-CIF-PROPERTIES statement applies.

OUTPUT = *NONE
No permanent CIF is created.

OUTPUT = *STD-FILE
The CIF is written to a cataloged BS2000 file. The name of this file is derived from the name of the source program as follows:

Source	*SYSDTA	BS2000 file	PLAM library	POSIX file
Default name	CSTDCIF.CIF	file.CIF	lib-elem.CIF	file.CIF

If the source program is located in a PLAM library, the library and element name of the source are combined with a hyphen (lib-elem) and used in the default file name. The rules by which the compiler constructs default names are described in detail in the section “Default names for output containers”.

OUTPUT = *SOURCE-LOCATION
The output destination and name of the CIF are derived from the location and name of the source program as follows:

Source	*SYSDTA	BS2000 file	PLAM library	POSIX file
Output destination	BS2000 file	BS2000 file	Library of source	Directory of source
Default name	CSTDCIF.CIF	file.CIF	elem.CIF (type H)	file.cif

The rules by which the compiler constructs default names are described in detail in the section “Default names for output containers”.

OUTPUT = <filename 1..54>
The CIF is written to a cataloged BS2000 file with the specified name. This entry is invalid when compiling multiple source programs.

OUTPUT = <posix-pathname>

The CIF is written to a POSIX file.

Both a file name and a directory are permitted as <posix-pathname>. See "Compiler I/O in the POSIX file system (C/C++-Compiler, #18)" for a description of the term <posix-pathname>.

When a file name is specified, the CIF is stored under this name. Specification of a file name is invalid when compiling multiple source programs with one statement.

When a directory name dir is specified, the CIF for each compiled source program is written under the default name sourcefile.cif to the directory dir (see also section “Default names foroutput containers”).

The directories specified with <posix-pathname> must already exist.
CIF files can be processed further in the POSIX subsystem with the global listing generator cclistgen.

OUTPUT = *LIBRARY-ELEMENT(...)
This option specifies the PLAM library (LIBRARY=) and the element name (ELEMENT=) under which the CIF is to be stored. The elements are stored as elements of type H.

LIBRARY = *STD-LIBRARY
The CIF is written to the library SYS.PROG.LIB by default.

LIBRARY = *SOURCE-LIBRARY
The CIF is written to the PLAM library which contains the source program.
The *SOURCE-LIBRARY specification is invalid if the source program is read from a cataloged BS2000 file, a POSIX file or via SYSDTA.

LIBRARY = <filename 1..54>
The CIF is written to a PLAM library with the specified name.

ELEMENT = *STD-ELEMENT(...)
By default, the element name of the CIF is derived from the name of the source program as follows:

Source	*SYSDTA	BS2000 file	PLAM library	POSIX file
Default name	CSTDCIF.CIF	file.CIF	elem.CIF	file.CIF

The rules by which the compiler constructs default names are described in detail in the section “Default names for output containers”.

VERSION = *UPPER-LIMIT
If the element entry does not contain a version ID, the highest possible version is used by the compiler.

VERSION = <composed-name 1..24 with-under>
The CIF is written to the element with the specified version ID.

ELEMENT = <composed-name 1..64 with-under>(...)

The CIF is written to a library element (type H) with the specified name. This specification is invalid compiling multiple source programs.

VERSION = *UPPER-LIMIT / <composed-name 1..24 with-under>
The version can be specified as described above for ELEMENT=*STD-ELEMENT(...).