Funcktion
This method returns all program definitions that meet the selectioncriteria entered.
For example, when you enter approval years "1980-1990", then all programdefinitions are listed that were approved in these years.
For more detailed information on the program definitions determined inthis way, call the object list
.

Notes
The function supplies a table with program IDs (that is, the key fieldsPROGRAM andAPPROVALYEAR ) thatsatisfy the selection criteria. These criteria are transferred in theRANGES_PROGRAM and RANGES_APPROVALYEAR tables, which are similar toRANGES tables in ABAP programming.
Before returning the values it finds, the system carries out anauthorization check. It returns only those program IDs, for which thereis display authorization. If there is no display authorization for anyof the program definitions found, the system issues an error message.

Further Information
For more information, see the SAP Library IM, Investment ProgramsPrograms.

Meaning
Table of program definitions that satisfy the selection criteria.
The line structure of the table contains the key fields of theprograms:
,,PROGRAM,,,,,,- Program name.
,,APPROVALYEAR,,- Approval year.

Meaning
The RANGES table transfers the selections options for the approval year(APPROVALYEAR field).
The line structure of the table contains the following fields:
,,SIGN,,- Include/exclude criterion
,,OPTION,,- Selection operator
,,LOW,,,,- Single value or lower limit for values of APPROVALYEAR
,,HIGH,,- Upper limit for value of APPROVALYEAR

Meaning
The RANGES table transfers the selections options for the program names(PROGRAM field).
The line structure of the table contains the following fields:
,,SIGN,,- Include/exclude criterion.
,,OPTION,,- Selection operator.
,,LOW,,,,- Single value or lower limit for values of PROGRAM.
,,HIGH,,- Upper limit for value of PROGRAM.

Meaning
Overview of the most important return messages (TYPE.ID.NUMBER):
E.AP.120 : There is no display authorization for any of theprogram definitions.
INCLUDE IM_APBAPI036 OBJECT DOKU ID TX(RANGES_PROGRAM-LOW, RANGES_PROGRAM-HIGH or RANGES_APPROVALYEAR-LOW,RANGES_APPROVALYEAR-HIGH fields)
INCLUDE IM_APBAPI037 OBJECT DOKU ID TX(RANGES_PROGRAM-LOW, RANGES_PROGRAM-HIGH or RANGES_APPROVALYEAR-LOW,RANGES_APPROVALYEAR-HIGH fields)
INCLUDE IM_S&026 OBJECT DOKU ID TX(RANGES_PROGRAM-SIGN or RANGES_APPROVALYEAR-SIGN field)
INCLUDE IM_S&027 OBJECT DOKU ID TX(RANGES_PROGRAM-OPTION or RANGES_APPROVALYEAR-OPTION field)