Process Help |
Process Name |
Menu Path |
Link to Command Table |
INPDDF |
Data ribbon | Transfer | Text | Input from Datamine Text File |
Introduction
Inputs a complete file, including its Data Definition, in a standard format (as generated by the OUTPUT process) from a character external system file.
Files, Fields and Parameters
Input Files
Name |
Description |
I/O Status |
Required |
Type |
Output Files
Name |
I/O Status |
Required |
Type |
Description |
OUT |
Output |
Yes |
Table |
Database file to be created. If OUT is a catalogue file, then all files in the catalogue will be input. |
Parameters
Name |
Description |
Required |
Default |
Range |
Values |
|
>=1 to display each record (0). |
No |
0 |
0,1 |
0,1 |
Notes
The format of the file read by INPDDF is as follows:-
Data Definition
Contents |
Format |
<file name> |
20A4 (not used) |
<file description> |
20A4 |
<Total fields> |
<Explicit fields> 2I8 (words) |
For the total number of fields above, one record per field (or per 4
characters for alphanumeric fields):-
<Field name> |
N/A <length> |
<ISWD pointer> <Char default> |
2A4,1X,A1,2I4, |
<numeric default> |
4X,A4,E14.6 |
The character default is only set for alphanumeric fields; the numeric is only set for numeric fields. The ISWD pointer is absent (zero) for implicit fields, or the sequential word number in the file for explicit fields.
Data Records
Data records have entries for explicit fields only; all numeric fields
will be output in either F or E format, depending on magnitude. Each number
will be 12 characters long (e.g. F12.0). All alphanumeric fields will
be read in multiples of A4, without spaces, except where an alphanumeric
field follows a numeric field, in which case there will be 4 blanks left
before the start of the alphanumeric field.
Errors in the DD format will cause the process to be abandoned with an
error message; errors in the data format will cause each record in error
to be displayed with an error message, and the record ignored.
The maximum record width that may be handled is 240 characters.
The characters !! in positions 1 and 2 are used internally to terminate
the data; therefore no record should start with !!.
The following messages are output to the display when using INPDDF with
a catalogue file input:
>>> OPERATING ON A CATALOGUE FILE INPUT <<<
>>> COPYING IN FILE file1
>>> 99999999 RECORDS IN FILE file 1
>>> COPYING IN FILE file2
>>> 99999999 RECORDS IN FILE file 2
Example
!INPDDF &OUT(NEWFILE)
SYSFILE>alphdata.dat
Error and Warning Messages
Message |
Description |
Solution |
>>> SYSTEM FILE DOES NOT EXIST <<< |
The named file does not exist. Fatal; the process is exited. |
|
|
|
|
>>> ERR 1 <<<
( fileno) IN INDD |
The Data Definition was illegal and could not be interpreted. Fatal; the process is exited. |
|
|
|
|
>>> FORMAT STATEMENT TOO
LONG <<< |
The format statement, constructed from the Data Definition, occupied more than 80 characters (including brackets). Fatal; the process is exited. |
|
|
|
|
>>> FORMAT CONVERSION
ERROR <<< |
The given record did not match the format entered. Warning; the record is ignored. |
|
|
|
|