Please enable JavaScript to view this site.

This program allows you to retrieve information that you have stored in the Cobwebb General Directory. The General Directory may be maintained via the “Work with Directory” option in CPPD and selecting “3. Work with general directory”.

Up to three KEY entries may be passed into this program with KEY 2 & 3 being optional. The KEY entries may be up to 20 characters in length as set out in the table below. The General directory data is returned in PARM1 and may be up to 132 characters in length.

Parameter

In

Len

Out

Len

PARM1

KEY 1

20

General directory data

132

PARM2

KEY 2

20

-

 

PARM3

KEY 3

20

-

 

PARM4

-

 

-

 

PARM5

-

 

-

 

PARM6

- See Note#1

 

-

 

Note#1: From version 6.2.85.

If PARM6 is blank then one lookup will be performed using all three Key fields. This is how the program has always worked.

If you want to return more than one result then, by using PARM6 in the following way, you can retrieve the data based on the supplied key parameters KEY1, KEY2 & KEY3.

If all three key parameters are populated then use all three to lookup the data - this will obviously only ever return one record

If only the first two key parameters are populated then just use these two to lookup the data

if only the first key parameter is populated then just use this to lookup the data

PARM6

When to use

What is returned

*FIRST

When you want to set the pointer to retrieve new information using the supplied keys KEY1, KEY2 & KEY3.

Use this the first time you call the program to retrieve multiple records or if you wish to change the key information.

Return the first matching record in PARM1. If no match found then '*NORECS' is returned in PARM1.

If '*NORECS' is passed back then the program will end and there is no need to call it with *LAST.

*NEXT

When you want to retrieve the next matching entry base on the supplied keys KEY1, KEY2 & KEY3.

Only use this until '*NORECS' is passed back.

Return the next matching record in PARM1. If no more matches are found then '*NORECS' is returned in PARM1.

If '*NORECS' is passed back then the program will end and there is no need to call it with *LAST.

*LAST

Use this call to end the program.

Only required if you wish to end the program before '*NORECS' has been passed back in PARM1.

No parameters are returned.