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. |