D_msg - messages of D-commands

[ English | Japanese ]

[visit D-home]

DESCRIPTION

D-commands are rather taciturn programs which do not produce unnecessary messages. But, still they have some warning messages as well as error messages.

Format of a message is

command: message-text.

where command is in the form you typed, and message-texts are listed in the following section.

NO MESSAGE, NO OUTPUT

This is the hardest case. You may suspect the command doesn't work. Before that, you should check

1. if it is waiting for an input.
Even the author often makes mistake like:

Djoin -o xx file-1 file-2
DfromLine file-1

in both cases, mandatory argument is missing. The command takes file-1 as field name argument and tries to read standard input.
2. if it is still processing normally.
For example, Dfd, Dfreq, Dmeans, or Dsort does not produce output until it reads all the input records and process them. It can consume considerable time when the input file is really big. You can estimate the processing time with feeding smaller input file to the same command.
3. if it is a bug.
You can write to the author, or you can fix it by yourself (if you have the source program).

MESSAGE LISTING BY ALPHABET ORDER

A

absolute position of the field field is not allowed in Dpack/Dunpack.
(D-command: Dpack, Dunpack). It is by these command specifications. You might make a mistake in format string.
-a option must be 'f' or 'nXXX'.
{D-command: DfromXml). It is the specification of the command. You might make a mistake in command spelling.

B

C

can't allocate necessary memory!
(D-command: Ded, Dpr, Dselect, Dtail, Dupdate). During the initial process of programs, or Dl interpretation, by some reason, it failed to allocate memory. Usually, this does not occur. Or in Dpr, this may occur during page output process. In this case, giving smaller -x or -y value may solve the problem.
can't allocate storage for storage-name="size".
(D-command: all). During initialization process, the program failed to allocate the named storage. This does not occur under normal conditions.
can't create tmpfile number.
(D-command: Dsort). Dsort has failed to create the numbered temporary file. Probably, the disk is full, or you provided wrong directory for temporary file directory (either by -T option or TMPDIR, TEMP environment).
can't open file-name.
(D-command: all). Popular message for the failure of opening file. You might mistyped the file name, or make a mistake in options and the option is regarded as a file name...
can't resize storage-name
(D-command: all). When this message comes, your record is really too big to fit in the available memory, or the process needs too large memory, e.g., too many same key records for Djoin, etc. This will also happen when you give non existent field names for the key field of above commands (by mistake), as all the records will have NULL key value. If you really want to run it, you may setup larger virtual memory for your OS, though, it hardly is practical. There is few things to do with this message, unless it is issued by just a bug. It is recommended to seek a detour.
C-format is not allowed with f option in the field field-name.
(D-command: DfromLine, Dpack, Dtie, DtoLine, Dunpack, Duntie). It is by the D-format specification.
C-format (printf) error in the field field-name.
(D-command: Dpack, Dtie, DtoLine). Output C-format must have just one "%", or you used unsupported conversion type. See D_fmt for the detail.
C-format (scanf) error in the field field-name.
(D-command: DfromLine, Dunpack, Duntie). Input C-format must have just one "%", or you used unsupported conversion type. See D_fmt for the detail.
code error in D-file file-name(rec#).
(D-command: all). It means the input D-file is not correctly coded under the current locale. This happens when you read a D-file made in different locale.
code error in the type argument.
(D-command: all). It means the type argument is not correctly coded under the current locale. This happens when you invoke a shell script written in different locale. Or, you might read a binary file by an error.
code error in the option option.
(D-command: all). The option is not correctly coded under the current locale. This happens when you invoke a shell script written in different locale.
code error in the file file-name(line).
(D-command: Ded, Dgrep, DfromLine, DfromCsv, Dselect). It means the line line of the file file-name is not correctly coded under the current locale. This happens when your Dl-input-file of Ded, Dselect, pattern-file of Dgrep or input-file of DfromLine or DfromCsv is not a text file, or edited under different locale. Or, your data might use private extension in the undefined position of the code space.

D

-D name is unknown.
(D-command: all). -D takes name=value form. You mistyped the name, or the form was wrong. Check the command argument after -D.

E

encoding name is not supported by iconv.
(D-command: DfromHtml). You can't use this encoding. Check if you misspelled the encoding name. Or, search compatible and available encoding name. Available encoding name is given with command iconv -l in most UNIX. In WINDOWS, see README.txt of the distribution.
encoding name in the input file file name is not supported by iconv.
(D-command: DfromHtml). Charset given in the file name is unknown encoding. It must be really unpopular encoding, or the charset in the input file is misspelled. You can give encoding by -e option. Available encoding name is given with command iconv -l in most UNIX. In WINDOWS, see README.txt of the distribution.
end position and * conflicts in the format of the field field-name.
(D-command: DfromLine, Dunpack, Duntie). It is by specification of D-format. You might make mistake in format specification.
exclusive list is not allowed for -L/S option.
(D-command: Dunbundle, Dtie). In leading field algorithm or sequence break algorithm, the leading field or field sequence must be explicitly specified. Exclusive field-list can not give this information. You have to specify all the fields in the leaf-field-list. See D_lsa. Or, if your field name has `^', you have to escape it by `\'.
exclusive list is not allowed in argument.
(D-command: DfromLine, Dpr, Drename, DtoLine, Duntie). Identification fields or field-formats, or rename-list must be given explicitly. Or you might make a mistake in options. Or, if your field name has `^', you have to escape it by `\'.

F

field field-name C-format conversion failed at file-name(rec#).
(D-command: DfromLine, Dunpack, Duntie). In the input format, when the command attempts scanf() with the C-format specification, no value could be obtained. You may made an error in the C-format specification.
field field-name current position exceeds end position at file-name(rec#).
(D-command: DtoLine, Dpack, Dtie). In the output format, when the command attempts to output the field, output line was already longer than the specified end position. You might make a mistake in the format for preceding fields.
field field-name end position is smaller than the start at file-name(rec#).
(D-command: DfromLine, Dunpack, Duntie). In the input format, when the command attempts to input the field, current position was already beyond the specified end postion. You might make a mistake in the format for preceding fields.
field field-name start position exceeds the end of line at file-name(rec#).
(D-command: DfromLine, Dunpack, Duntie). In the input format, when the command attemts to input the field, input line was shorter than the start position. Input might not be what you assumed, or you might make a mistake in the column calculation. Note that position is counted by characters, not by bytes.
field field-name start position over at file-name(rec#).
(D-command: DtoLine, Dpack, Dtie). In the output format, when the command attempts to output the field, output line was already longer than the specified start position. You might make a mistake in the format for preceding fields.
field field-name truncated by the end of line at file-name(rec#).
(D-command: DfromLine, Dunpack, Duntie). In the input format, input line was shorter than the specified end position or length. Input data might not be what you think, or you might make a mistake in the format.
field-format-list is missing.
(D-command: DfromLine, Dpack, Dunpack, Duntie). Mandatory command argument field-format-list is missing. Check the command arguments.
field-list is missing.
(D-command: Dmeans, Dorder, Dproj). Mandatory command argument field-list is missing. Check the command arguments.
field-list is required for -g/p.
(D-command: Dpr). These field-lists can not be null.
field-name is missing.
(D-command: Duntie). Mandatory command argument field-name is missing. Check the command arguments.
field-rename-list is missing.
(D-command: Drename). Mandatory command argument field-rename-list is missing. Check the command arguments.
f option of the field field-name is not allowed in Dpack/Dunpack.
(D-command: Dpack, Dunpack). It is by specification of these commands. You might make a mistake in format option. Or you have given f option with -z option.
format delimiter or pattern matches null in the field field-name.
(D-command: DfromLine, Dunpack, Duntie). In the input format, delimiter (/../) or pattern (@..@) must not matches to null string. (Otherwise, it produces only null string values). For example, /\ */ (zero or more spaces) matches null string. Use /\ +/ (one or more spaces) for such case. Check your format delimiter pattern.
format syntax error in the field field-name at 'char'.
(D-command: Dunbundle, DfromLine, DtoLine, Dpack, Dunpack, Dtie, Duntie, Dpr). Study the manual of D_fmt. Escaping special character is tricky. Consider using -t option.

G

H

HTML read error in file name: detail.
(D-command: DfromHtml. While reading file name file, an error described in detail is detected. This is usually caused by input file character code error. In that case, you may give encoding name with -e option.

I

input-file is missing.
(D-command: Djoin, Dpaste, Dupdate). Mandatory command argument input-file is missing. You might forget key-field-list. In the case of Dpaste, you need at least one input-file. Check the command arguments.
insufficient storage-name
(D-command: all). You won't see this message in the current version in normal condition. Please contact to the author.
insufficient xmem(size) at file-name(rec#).
(D-command: Dsort). Working memory is not large enough to accommodate the rec# record in the file-name. Give larger xmem size (-D xmem=), or input file might not be what you expected.
invalid datautf value (value).
(D-command: all). datautf value must be 0, 8, 16 or 32. Minus value is allowed only in idatautf. Check Ddatautf environment and -D datautf= option. See UTF I/O feature.
invalid idatautf value (value).
(D-command: all). idatautf value must be 0, 8, 16, 32, -16 or -32. Check Didatautf environment and -D idatautf= option. See UTF I/O feature.
invalid left hand of '=' for Dselect.
(D-command: Ded, Dselect). Assignment operator may be used in Dselect, but only VAR or STATIC can be assigned value.
invalid odatautf value (value).
(D-command: all). odatautf value must be 0, 8, 16 or 32. Minus value is allowed only in idatautf. Check Dodatautf environment and -D odatautf= option. See UTF I/O feature.
invalid option -option
(D-command: all). Check the option.

J

K

key-field-list is missing.
(D-command: Dbundle, Dfreq, Djoin, Dmax, Dsort, Dupdate). Mandatory command argument key-field-list is missing. Check the command arguments.
key sequence error, stop at file-name(rec#)!
(D-command: Djoin, Dupdate). In these commands, all input files must be sorted by the given key order. The command reports that the rec# record of the file file-name was not in proper order.

L

leaf-field-list is missing.
(D-command: Dtie, Dunbundle). Mandatory command argument leaf-field-list is missing. Check the command options.
locale encoding name is not supported by iconv.
(D-command: DfromHtml, DfromXml). This must be rare case. You must be using old version of the operating system. Change your locale to some other one might be help.

M

missing '}' after … .
(D-command: Ded, Dselect). There is "{", but not corresponding "}" in the give Dl. Note that these tokens must be separated by spaces.
missing arg after 'CONST' at … .
(D-command: Ded, Dselect). The last word of given Dl is the "CONST"" which requires following word. Check if you made a mistake in continuation line. Or, to use these words as a constant or a field name, these words must come after proper keyword.
missing field name after 'FIELD' at … .
(D-command: Ded, Dselect). The last word of given Dl is the `FIELD' which requires following word. Check if you made a mistake in continuation line. Or, to use these words as a constant or a field name, these words must come after proper keyword.
missing variable name at … .
(D-command: Ded, Dselect). The last word of given Dl is the `VAR', or 'STATIC' which requires following word. Check if you made a mistake in continuation line. Or, to use these words as a constant or a field name, these words must come after proper keyword.

N

-N must be prefix=URI.
(D-command: DfromXml). Check your command arguments.
new-field-name is missing.
(D-command: Dtie). Mandatory command argument new-field-name is missing. Check the command options.
no new field name for the field field-name.
(D-command: Drename). Field-rename-list is old-name:new-name.

O

OUTPUT is not allowed in Dselect.
(D-command: Dselect). You can't use OUTPUT in Dselect.

P

pattern is missing.
(D-command: Dgrep). Mandatory command argument pattern is missing. Check the command arguements.
pattern is not allowed in output format in the field field-name.
(D-command: Dunbundle, DfromLine, DtoLine, Dpack, Dunpack, Dtie, Duntie, Dpr). Check the format-list, or you might mistyped the command.
program error (identifier).
(D-command: Ded, Dselect). Please write to the author.

Q

R

-r and -g is exclusive.
(D-command: Dmeans). This is by Dmeans specification. If you want both, run the command twice with -r and -g.
record-number-list syntax error at position.
(D-command: Dextract). Check your mistype, or you might mistyped the command.
regular expression error (detail) in position
(D-command: Ded, DfromLine, Dgrep, Dselect, Dunpack, Duntie). Regular expression patterns are compiled when necessary. During compilation, error showed by detail has found. The position shows the regular expression itself, file name and rec#, or option name etc.

S

skips a NULL character in the file file-name(rec#).
(D-command: Ded, Dgrep, DfromLine, Dselect). It means the rec# line of the file file-name contains a null character, and removed from the input. This happens when your pattern-file of Dgrep or input-file of DfromLine is not a text file, or edited under different locale. In the case of Ded or Dselect, file-name is "QX operator" and means the command of QX oerator output null character.
Note that null characters are not reported in the input D-files. They are just discarded without any message.
start > end error in the field field-name.
(D-command: Dunbundle, DfromLine, DtoLine, Dpack, Dunpack, Dtie, Duntie, Dpr). Format of the field-name field has absolute positioning and its start is greater than end.
syntax error at the arguemnt number (value).
syntax error at the end of arguemnt (number).
syntax error at line number, char position.
(D-command: Ded, Dselect). Dl syntax error. Check if field names or constants are reserved words. Check if operators and parentheses are popoerly quoted.
-t delimiter matches null string.
(D-command: DfromLine, Dunpack, Duntie). In the input format, -t delimiter pattern, as well as other delimiters or patterns, must not matches to null string. (Otherwise, it produces only null values). For example, /\ */ (zero or more spaces) matches null string. Use /\ +/ (one or more spaces) for such case. Check your -t delimiter.

T

tmpfile exhausted (number).
(D-command: Dsort). This means number of temporary files exceeds 21176! Your file system must be extraordinary big. You should increase xmem, if it is truly so.
too long -i fields!
(D-command: Dpr). Identification field(s) is too long to fit in a page width. The field may not be what you expect.
too small page size, stop!
(D-command: Dpr). Page height ( -y option) is not big enough to accommodate header lines. Use larger -y value, or giveup some title lines.

U

unexpected eof after continuation line at file-name(rec#).
(D-command: DfromLine). During input with -c option, the last line of a file was continuation line. The last line is discarded from the input.
unexpected eof in QUOTATION MARK at file-name(rec#).
(D-command: DfromCsv). In the input file, EOF encountered before closing QUOTATION MARK.
unknown key flag 'flag' in position.
(D-command: Dcat, Dfd, Dfreq, Dbundle, Dmeans, Dsort, Djoin, Dupdate, Dpr). Key flag must be combination of `b', `d', `f', `i', `n', `r'.
unknown token word at … .
(D-command: Ded, Dselect). In Dl, non reserved word word appears out of context position. You may mistyped one of the keywords.
unknown qualifier.
(D-command: Ded, Dselect). Directly after a field-name of Dl, only numeric qualifier :n can be placed. It is not key flag or format.
unterminated quotation from line number char position.
(D-command: Ded, Dselect). Quoting is not closed properly in the Dl-input-file. It must be mistype of QUOTATION MARK, APOSTROPHE or REVERSE SOLIDUS.
UTF is not supported in this locale (name)
(D-command: DfromHtml, DfromXml). In SOLARIS operating system, usage of UTF I/O feature is restricted. You have to change your locale to UTF-8 locale.

V

W

with -c option, -o option's top must be '1'.
(D-command: Djoin). It is Djoin's specification that te first input file record must be included in the output.

X

XML parser can't successfully parse file name.
(D-command: DfromXml). file name is not valid xml file. You might fed wrong file. If you know well, you can fix it with some xml tools. If you don't, consult a book or an expert.
XML read error in file name: detail.
(D-command: DfromHtml, DfromXml). While reading file name file, an error described in detail is detected. This is usually caused by input file character code error or by essential external resource reference from the file name document. In the case of charcater code, you may give encoding name with -e option. In the case of external reference, you may ignore it, unless what you want is in the external resource. If you really need the external resource, you have to retrieve and process it separately.
XPath error: detail.
(D-command: DfromHtml, DfromXml). While parsing -p Xpath expression, an error described in detail is detected. Give valid Xpath expression.
XPath evaluation error in file name: detail.
(D-command: DfromHtml, DfromXml). While searching XPath expression in file name file, an error described in detail is detected.

Y

Z

-z option error 'character'.
(D-command: Dunbundle, DfromLine, DtoLine, DtoCsv, Dpack, Dunpack, Dtie, Duntie, Dpr). It's not a valid format option. See D_fmt.
zero division at file-name(rec#).
(D-command: Ded, Dselect). Division by zero (DIV or MOD operation) occurred during the evaluation of an expression. If file-name and rec# is not shown, it has occurred during initial constant evaluation.
zero length field repeats in the field field-name.
(D-command: DfromLine, Dunpack, Duntie). Input format length may be zero only when it does not repeat, otherwise it loops.

SEE ALSO

Dintro.

AUTHOR

MIYAZAWA Akira

miyazawa@nii.ac.jp
2003-2007