9 115 GET_LOGICAL_LIST

LANSA Technical

9.115 GET_LOGICAL_LIST

Þ Note: Built-In Function Rules.

Retrieves a list of a physical files associated logical views and their descriptions from the data dictionary and returns them to the calling RDML function in a variable length working list.

Þ This is a Specialized Built-In Function for use in a Development Environment only.

For use with

LANSA for i

YES

 

Visual LANSA for Windows

YES

This Built-In Function is not supported if the X_RUN parameter DBII=*NONE.

Visual LANSA for Linux

NO

 

 

 

Arguments

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

Req

Physical file name.

1

10

 

 

2

A

Req

Physical file library.

1

10

 

 

 

 

Return Values

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

L

Req

Working list to contain logical file information.

List must not be more than:
32767 entries in Windows
9999 entries on IBM i.

The calling RDML function must provide a working list with an aggregate entry length of exactly 70 bytes.

Each returned list entry is formatted as follows:

From - To Description

 1 - 10    Logical file

11 - 20   Logical file library

21 - 60   Description

61 - 70    <<future expansion>>

70

70

 

 

2

A

Opt

Return code.

OK = list returned partially or completely filled with file details. No more logicals exist for this physical file.

OV = list returned completely filled, but more files than could fit in the list exist. Typically used to indicate "more" fields in page at a time style list displays.

NR = list was returned empty. Last file in the list is returned as blanks.

ER = Physical file not found. Last file in the list is returned as blanks.

2

2