Process Help INPDDF - input data definition and data produced by OUTPUT

 

Process Name	Menu Path	Link to Command Table
INPDDF	Data ribbon | Transfer | Text | Input from Datamine Text File	Click here

 

• Introduction

• Files, Fields and Parameters

• Notes

• Example

• Errors

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
PRINT	>=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 >>>  ILLEGAL DD IN FILE <<<	The Data Definition was illegal and could not be interpreted. Fatal; the process is exited.
>>>  FORMAT STATEMENT TOO LONG <<<         (listing of format) >>>  ERR 130 <<< ( n) IN DEFFMT >>>  ILLEGAL FILE FORMAT <<<	The format statement, constructed from the Data Definition, occupied more than 80 characters (including brackets). Fatal; the process is exited.
>>>  FORMAT CONVERSION ERROR <<<         (listing of record) >>>  ERR 80 <<< ( 0) IN FMTDCW	The given record did not match the format entered. Warning; the record is ignored.

 

---