Posted by Jim Guerber on May 02, 2008 at 01:37:30:
In Reply to: Re: EVENTSUB question posted by Keith Smith on May 01, 2008 at 22:57:13:
Here is an excerpt from the Comet 2002 documentation.....
"...SNAPSHOT subprogram
The SNAPSHOT subprogram (located in the UTL directory) is a subprogram you can ENTER from your own application/utility in order to inquire on the status of your CometServe server. The subprogram takes a "snapshot" of the Comet file server and creates a CometServe activity log (a keyed file).
To get CometServe to generate the activity log file, create a keyed file with a record size of 1024 and a key size of 64. This file should be located in any directory on the server you want to inquire on. Open the file on logical unit number 32, and then ENTER "SnapShot", DIR="UTL". For example:
FileName$ = "NETDATA" ! sample file name
DirName$ = "DSK" ! sample directory (located on target server)
ERASE FileName$,DIR=DirName$,EXCP=CreateLogFile
CreateLogFile:
CREATE FileName$,1024,K,64,DIR=DirName$
OPEN (32) FileName$
ENTER "SNAPSHOT", DIR="UTL"
.
When control returns to your program (following the ENTER statement), the keyed file will contain either snapshot records or it will return an error message in a record keyed by "*".
There are four types of snapshot records:
· Connection record, keyed by "C" and the connection number, which includes the node name (profile name), network address, number of partitions, name of first partition and terminal, and workstation ID
· Partition record, keyed by "P" + connection number + partition number, which includes the name of the current program and the value of the ENTERLEVEL system variable
· LUN status record, keyed by "L" + connection number + partition number + logical unit number, which includes the path, name, and directory of the open file, and the value of the extracted key (if any)
· Version record, keyed by "V", which includes the server type (CometServeNLM or CometServe32), the CometServe version, and a date/time stamp
The key to each record is the first 64 bytes of the record.
The SNAPSHOT.INC file in the XTL directory is an include file that contains FORMAT statements for the four record types, along with definitions of all of the fields returned by the SNAPSHOT subprogram...."
I found the above in a much longer document referenced below. There is SO MUCH we have put into the comet system in the last few years that many of you don't know about. Most of it is documented (somewhere).
I really like Steve Auerbach's idea about wiki style documentation. One of these days, We will implement it.
Each file can be a maximum of 1MB in length Uploaded files will be purged from the server on a regular basis.