z/OS UNIX interface

The syntax is as follows:

 ceebldtx   [-C csect_name] [-I secondary_file_name]
	           [-P] [-S] [-c class] [-d delimiter]
            [-l BAL | C | COBOL | FORTRAN | PLI] [-s id]
            in_file out_file

Note: ceebldtx utility is lowercase in the z/OS® UNIX interface and only works with z/OS UNIX files; MVS™ data sets are not applicable.

Operands

in_file: Required. The name of the file containing the message source.
out_file: Required. The name of the resulting assembler source file containing the messages, inserts, and other items, suitable for input into the High Level Assembler. Extension of ".s" is assumed if none is present.

Options

-C csect_name

This option is used to explicitly specify the CSECT name. An uppercase version of the CSECT name will be used. By default, the CSECT name is the output file base name.

A CSECT name greater than 8 characters requires the use of the GOFF option when assembling the out_file.

-I secondary_file_name

The name of the secondary input file generated for the language specified with the -l (lowercase L) option. If no suffix is present in the secondary_file_name specified, the extension will be ".h" for C, ".fortran" for Fortran, and ".copy" for all others.

-P

This option is used to save previous prologs, if files being generated already exist in the directory and contain prologs. By default, previous prologs are not reused.

-S

This option is used to indicate sequence numbers should be generated in the files produced. By default, no sequence numbers are generated.

-c class

This option is used to specify the default value for :msgclass. in cases where the tag is not coded.

-d APOST | ' | QUOTE | "

This option is used to specify which COBOL delimiter to use. Used in combination with the -l (lowercase L) COBOL option. By default, APOST is used as the delimiter.

Note: Quotation marks should be escaped to avoid them being treated as shell meta characters.

Examples:

ceebldtx -l COBOL -I secondary_file_name -d \' in_file out_file
ceebldtx -l COBOL -I secondary_file_name -d \" in_file out_file
ceebldtx -l COBOL -I secondary_file_name -d QUOTE in_file out_file

-l BAL | C | COBOL | FORTRAN | PLI

This options is used to specify the language to be used in generating a secondary input file. Used in combination with the -I (uppercase i) secondary_file_name option. The file will contain declarations for the condition tokens associated with each message in the message source file. The language is accepted in lower and upper case.

Note: C370 is also supported.

-s id

This option is used to specify the default value for :msgsubid. in cases where the tag is not coded.