Process Help

LISTC - list a Datamine file with alphanumeric fields

 

Process Name

Menu Path

Link to Command Table

LISTC

Command line only

Click here

 

Introduction

Displays any Datamine file with only alphanumeric fields.

How to use

If the file should contain numeric fields, then an automatic transfer is made to the LIST process. If the output line is longer than 80 characters, it is wrapped around. Each alphanumeric field occupies as many characters as required, but is preceded by 4 blanks to separate it from the previous field.

At the end of each page of output, the message:

>>> PRESS <RETURN> TO CONTINUE (OR ! TO TERMINATE) >

is displayed. If the response is !<return> then the LISTC process will be terminated. This allows part of the file to be displayed. This message does not appear if LISTC is being invoked from a macro.

The page length is controlled by the @PROMPT parameter. The default is 20 records; this may be altered to, say, 60 records by setting @PROMPT=60. @PROMPT= 0 removes all prompting, except following the Data Definition. Each page of data is headed by the field names.

If the @ECHO parameter is set to 1, the listing is copied to the printer or print file. This assumes a carriage width of 132 characters, rather than the 80 of the normal display.

Only explicit fields are listed. Implicit fields appear only in the Data Definition.

If an index file is being displayed, the data records will be displayed as if they were joined in a single file.


Files, Fields and Parameters

Input Files

Name

Description

I/O Status

Required

Type

IN

Character file to be displayed. If IN is a catalogue file, then all files in the catalogue will be displayed.

Input

Yes

Table

Output Files

Name

I/O Status

Required

Type

Description

Parameters

Name

Description

Required

Default

Range

Values

PROMPT

Page length for display; 0=infinite (20).

No

20

Undefined

Undefined


Notes

The alias L is the alias for the LISTC command; however, if the file should contain any numeric fields, then LISTC branches automatically to the LIST process.


Example

!LISTC &IN(MACROS)