Default names for output containers

This section summarizes the rules by which the compiler constructs default names for output containers of the following compilation results:

• Result of a preprocessor run (PREPROCESS)

• Compiler listings (MODIFY-LISTING-PROPERTIES)

• Diagnostic messages (MODIFY-DIAGNOSTIC-PROPERTIES)

• CIF information (MODIFY-CIF-PROPERTIES)

Default names are generated, i.e. derived from the source program name, when the following entries are made in the OUTPUT options listed above:

OUTPUT=*STD-FILE
OUTPUT=*SOURCE-LOCATION
OUTPUT=*LIB-ELEM(LIB=...,ELEM=*STD-ELEMENT)
OUTPUT=<posix-pathname> (name of a POSIX file directory)

Construction of default names for cataloged BS2000 files

The output is placed in cataloged BS2000 files with default names

• whenever OUTPUT=*STD-FILE is specified;

• if OUTPUT=*SOURCE-LOCATION is specified and the source program is read from a BS2000 file or SYSDTA.

  1. The following source program name components, if present, are not used to construct the default file name and are therefore dropped:

     • name components for the catid and userid in BS2000 file and library names.Exception: If the source program entered with OUTPUT=*SOURCE-LOCATION is catalogued as a BS2000 file, then catid and userid will be kept.

     • directory names in POSIX pathnames

     • the suffixes .C , .CPP, .CXX, .CC and .I if the source program exists as a cataloged BS2000 file or PLAM library element

     • the suffixes .c, .C , .cpp, .CPP, .cxx, .CXX, .cc, .CC, .c++, .C++, .i and .I if the source program exists as a POSIX file

  2. If the source program exists as a cataloged BS2000 file or a POSIX file, the remaining portion of the name is truncated from the right to 33 characters.

  3. For OUTPUT=*STD-FILE only:

     If the source program exists as a PLAM library element, the library and element names are combined with a hyphen and used in the default name as shown below:libraryname-elementnameIf this name (including the hyphen) exceeds 33 characters, the library name and, if required, also the element name, are both truncated to 16 characters from the right, starting with the library name.

  4. Special characters not allowed in file names are always converted to “$”. The permitted special characters are $, @, #, . (period) and - (hyphen).

  5. Lowercase letters (in POSIX source file names) are converted to uppercase.

  6. The name truncated to 33 characters is then extended with the appropriate suffix, i.e.:.I , .LST , .CIF or .DIAG.

Summary

	Source program input from
Contents	*SYSDTA	BS2000 file	PLAM library	POSIX file
PREPROCESS	CSTDEXP.I	file.I	lib-elem.I	file.I
LISTING	CSTDLST.LST	file.LST	lib-elem.LST	file.LST
DIAGNOSTIC	CSTDDIAG.DIAG	file.DIAG	lib-elem.DIAG	file.DIAG
CIF	CSTDCIF.CIF	file.CIF	lib-elem.CIF	file.CIF

Default names for cataloged BS2000 files, depending on input source and contents

Construction of default names for PLAM library elements

The output is placed in PLAM library elements with default names

• if OUTPUT=*LIB-ELEM(ELEMENT=*STD-ELEMENT) is specified;

• if OUTPUT=*SOURCE-LOCATION is specified and the source program exists as a PLAM library element.

If the output location is specified as OUTPUT=*LIB-ELEM(LIB=*STD-LIBRARY), the elements are written to the PLAM library with the default name SYS.PROG.LIB.

1. The following source program name components, if present, are not used to construct the default element name and are therefore dropped:

   • name components for the catid and userid in BS2000 file and library names

   • directory names in POSIX path names

   • the suffixes .C , .CPP, .CXX, .CC and .I if the source program exists as a cataloged BS2000 file or PLAM library element

   • the suffixes .c, .C , .cpp, .CPP, .cxx, .CXX, .cc, .CC, .c++, .C++, .i and .I if the source program exists as a POSIX file

2. The remaining portion of the source program name is truncated from the right to 59 characters.

3. Special characters not allowed in element names are always converted to “$”. The permitted special characters are $, @, #, . (period), - (hyphen), and _ (underscore).

4. Lowercase letters (in POSIX source file names) are converted to uppercase.

5. The name truncated to 59 characters is then extended with the appropriate suffix .I, .LST, .CIF or .DIAG.

Summary

	Source program input from
Contents	*SYSDTA	BS2000 file	PLAM library	POSIX file
PREPROCESS	CSTDEXP.I, S	file.I, S	elem.I, S	file.I, S
LISTING	CSTDLST.LST, P	file.LST, P	elem.LST, P	file.LST, P
DIAGNOSTIC	CSTDDIAG.DIAG, D	file.DIAG, D	elem.DIAG, D	file.DIAG, D
CIF	CSTDCIF.CIF, H	file.CIF, H	elem.CIF, H	file.CIF, H

Default names for PLAM library elements, depending on input source and contents

Construction of default names for POSIX files

The output is placed in POSIX files with default names

• if OUTPUT=*SOURCE-LOCATION is specified, and the source program exists as a POSIX file;

• if OUTPUT=<posix-pathname> is specified, and if <posix-pathname> specifies the name of a POSIX file directory (without file name).

  1. The following suffixes in source program names, if present, are not used to construct default names and are therefore dropped: .C , .CPP, .CXX, .CC or .I (for BS2000 files) and .c, .C , .cpp, .CPP, .cxx, .CXX, .cc, .CC, .c++, .C++, .i or .I (for POSIX files).

  2. The name is extended with the appropriate suffix, i.e.: .i (C compilation), .I (C++ compilation), .lst, .cif or .diag.

  3. Lowercase letters and other special characters are accepted unaltered. No name truncation occurs.