ceebldtx - Transform message source files into assembler source files
Format
- ceebldtx
-
[-C csect_name][-I secondary_file_name]
[-P] [-S] [-c class] [-d APOST | ' | QUOTE | "]
[-l BAL | C | COBOL | FORTRAN | PLI] [-s id]
in_file out_file
Description
The ceebldtx utility creates several files from the message source file. It creates an assembler source file, which can be assembled into an object (text) file and link-edited into a module in an MVS load library. When the name of the module is placed in a message module table, the Language Environment® message services can dynamically access the messages. For more information about creating a message module table, see Creating a message module table in z/OS Language Environment Programming Guide.
The
ceebldtx utility optionally creates secondary input files (COPY or
INCLUDE), which contain declarations for the condition tokens associated with each message in the
message source file. When a program uses the secondary input file, the condition tokens can then be
used to reference the messages from the message table. The :msgname.
tag indicates
the symbolic name of the condition token.
For information about creating message source files and other corresponding information, see Using and handling messages in z/OS Language Environment Programming Guide.
Operands
- in_file
- The name of the file containing the message source.
- out_file
- The name of the resulting assembler source file containing the messages, inserts, and others items, suitable for input into the High Level Assembler. An 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.
- -I secondary_file_name
- The -I (uppercase i) option provides 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 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 and is used in combination with the
-l (lowercase L) COBOL option. By default, APOST is used as the delimiter.
Quotation marks should be escaped in order to prevent them from being treated as shell metacharacters, for example:
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
- The -l (lowercase L) option is used to specify the language to be used in
generating a secondary input file and is used in combination with the
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 lowercase and uppercase. 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.
Examples
ceebldtx -l PLI -I exmplcop example exmplasm
Where the
in_file is example, the
out_file is exmplasm.s, and the PL/I
secondary_file_name is exmplcop.copy. as exmplasm.s
and the binder can be used to link-edit it into an MVS load
library: ld -o "//mylib(exmplasm)" -e// -u//exmplasm exmplasm.o
A CSECT name
greater than 8 characters requires the use of the High Level Assemble GOFF option for assembling the
primary output file.Exit values
-1
- REXX terminated execution due to lack of storage. (For more information about the
IRX0005I message, see TSO/E terminal messages (IKJ...) in z/OS TSO/E Messages.) Attempt one of the following options:
- Increase the virtual storage space available on the system.
- Split up the script in_file, into two or more files, and adjust the Message Module Table for the corresponding split.
0
- Successful completion.
5
- Error reading file ssssssss.
6
- Error erasing file ssssssss.
7
- Error writing file ssssssss.
8
- Bad file name ssssssss: forward slash not allowed at the end of a file name.
9
- Option x requires an argument.
10
- Invalid option = x. Valid options are: CIPScdls.
11
- Bad data set name ssssssss.
20
- CSECT name ssssssss is greater than 63 characters.
21
- CSECT name ssssssss does not begin with a letter, $, #, @ or underscore (_).
28
- ssssssss SCRIPT not found on any accessed disk.
40
- Error on line nnn in message nnnn. Insert number greater than mmmm.
44
- Error on line nnn. Duplicate: FACID. tags found with the given script file.
48
- No :FACID. tag found within the given script file.
52
- Error on line nnn. Message number nnnn found out of range mmmm to mmmm.
56
- Number of hexadecimal digits not divisible by 2 on line nnn in message nnnn.
60
- Invalid hexadecimal digits on line nnn in message nnnn.
64
- Number of DBCS bytes not divisible by 2 on line nnn in message nnnn.
68
- PLAS out_file name must be longer than the message facility ID pppp.
72
- Message facility ID pppp on line nnn was longer than 4 characters.
76
- Message class on line nnn was not a valid message class type: IWESCFA.
80
- Tag not recognized on line nnn.
84
- The first tag was not a :FACID. tag on line nnn.
88
- Unexpected tag found on line nnn.
92
- Duplicate tags ttt found on line nnn.
96
- No :MSGNO. tags found within the given SCRIPT file.
98
- No :MSGCLASS. (or :MSGCL.) tag found for message nnnn.
100
- Insert number was not provided or was less than 1 on line nnn.
104
- Message subid was out of the range mmmm to mmmm on line nnn.
108
- Existing secondary file, ssssssss, found, but not on A-disk.
112
- The current ADDRESS environment not CMS, TSO/E, or z/OS® UNIX.
nnn
- Undefined error number nnn issued. Contact your service representative.