DINUM documentation?

[kdt...@gmail.com]

Can anyone point me to the documentation on DINUM?

I just tried to do some research on this and found these posts;
http://www.mail-archive.com/hardhats...@lists.sourceforge.net/msg15040.html
http://www.mail-archive.com/hardhats...@lists.sourceforge.net/msg00852.html

I realize that 2 yrs later, I am still having a hard time wrapping my
head around this.

What is a little bit different now, is that I realize that fields
other than the .01 can be a DINUM field.

What is DINUM doing? Is it an internal variable that Fileman uses to
set the IEN of the record? What is it's function in non-.01 fields?

Kevin

[kdt...@gmail.com]

I found this brief mention.

http://www.hardhats.org/fileman/pm/cl_dicn1.htm

I wonder, does all fileman filling go through this same API, so what
is true in that documentation is for other filing (say, through
Database Server Calls)?

But it still doesn't explain why, for example, file 790.71 has ALL
it's fields DINUM'd. And while the "why" may be from a file-creator
that just copied the input transform over. But I don't understand
what Fileman does with the DINUM variable in that case.

Kevin

On Feb 28, 11:32 pm, "kdt...@gmail.com" <kdt...@gmail.com> wrote:
> Can anyone point me to the documentation on DINUM?
>
> I just tried to do some research on this and found these posts;

> http://www.mail-archive.com/hardhats-memb...@lists.sourceforge.net/msg15040.html
> http://www.mail-archive.com/hardhats-memb...@lists.sourceforge.net/msg00852.html

[kdt...@gmail.com]

Oops. Please ignore this. A bit of bad code was making it look like
other fields (other than .01) were DINUM.

Actually, only the .01 fields are DINUM'd.

Sorry
Kevin


On Feb 28, 11:47 pm, "kdt...@gmail.com" <kdt...@gmail.com> wrote:
...

[John McCormack]

See page 1-36 VA FileMan V. 22.0 Programmer Manual March 1999 Revised
December 2007

DINUM
(Optional) Identifies the subscript at which the data is to be stored,
that is, the internal entry number of the new record, shown as follows.
(This means that DINUM must be a canonic number and that no data exists
in the global at that subscript location.)

$D(@(DIC_DINUM_")"))=0

If a record already exists at the DINUM internal entry number, no new
entry is made. The variable Y is returned equal -1.

Alternatively use search function in Acrobat Reader for DINUM

It's a way for application code to indicate to FileMan that a record
will be created at a specific subscript in the file. Depending on the
file it a technique to keep the entries in one file "in sync" with
another file. It should only be used when the pointed to file has a 1:1
relationship.

[Skip Ormsby]

Kevin, I just did a search of the pdf programmer manual and found (if I counted correctly) 18 references to DINUM.  I think of DINUM this way.  In FileMan there is a normally 'hidden' field, NUMBER(#.001) and in my mind, when I look at a spread sheet it equates to the Row.  In the spread sheet programs I use when do an export, I have to tell it to export the Row Number.  Same gig.

-skip
Montani Semper Liberi