VA FileMan V. 22.0 Getting Started HTML Manual Banner


Main Chapter Getting Started Manual Programmer Manual

System Management

NEW PERSON File for Standalone VA FileMan

In general, the files you need to run VA FileMan without Kernel are installed by the DINIT routines. However, one file that is referenced by VA FileMan is not included -- the NEW PERSON file (#200). The NEW PERSON file is supplied by Kernel.

This section describes the fields in the NEW PERSON file directly accessed by VA FileMan; this is a small subset of the fields in Kernel's NEW PERSON file. The fields described contain characteristics of the VA FileMan users. If you set up a file in the proper global location with these fields, you will enhance standalone VA FileMan's functionality. However, the NEW PERSON file is not required to run standalone VA FileMan.

The file that needs to be established is File #200 (NEW PERSON) with a global root of ^VA(200,. Use the information below when creating the file using the Modify File Attributes option. (See the "VA FileMan Functions" chapter for a description of the USER() function.)

The fields directly accessed are:

Field Name Field # Node;Piece Description
NAME .01 0;1 Identifies the user. It is pointed to and displayed in several places. A FREE TEXT field holding from 3 to 30 characters.
INITIAL 1 0;2 Used by the USER() function. A FREE TEXT field holding from 2 to 5 characters.
TITLE 8 0;9 Used by the USER() function. A POINTER TO A FILE that points to the TITLE file (#3.1) located at ^DIC(3.1,. You will need to define this file to use USER("T").
NICK NAME 13 .1;4 Used by the USER() function. A FREE TEXT field holding from 1 to 10 characters.
FILE RANGE 31.1 1;1 Used to assign numbers to newly created files. A FREE TEXT field with the format nnnnn-nnnnn.
TEXT TERMINATOR 31.2 1;4 Holds the default text terminator used by the Line Editor. A FREE TEXT field holding from 1 to 5 characters.
PREFERRED EDITOR 31.3 1;5 Holds the user's Preferred Editor. A POINTER TO A FILE that points to the ALTERNATE EDITOR file (#1.2).
TYPE AHEAD 200.09 200;9 Used to determine if "type ahead" is allowed for the user. A SET OF CODES field: "Y"=allowed; "N"=not allowed. Default is "N."

In addition to these fields accessed directly by VA FileMan, Kernel uses the NEW PERSON file to set up VA FileMan key variables. You can define additional NEW PERSON file fields to use to define these local variables as follows:

Field Name Field # Node;Piece Description
Internal Entry Number -- -- Used to set DUZ for the user. There is no defined .001 field on the NEW PERSON file.
FILE MANAGER ACCESS CODE 3 0;4 Used to set DUZ(0) for user. A FREE TEXT field from 1 to 15 characters.
LANGUAGE 200.07 200;7 Used to set DUZ("LANG"). A A POINTER TO A FILE that points to the LANGUAGE file (#.85) identifying the user's language.
TIMED READ (# OF SECONDS) 200.1 200;10 Used to set DTIME for the user. A NUMERIC field with a value of 1 to 99999.

When these additional fields are defined, you can use them in a signon routine to set these key variables.

Of course, you may choose to place additional information about your users in the NEW PERSON file (#200). If you add other fields to your NEW PERSON file, use field numbers greater than 10,000 and use subfile numbers with at least 5 digits following the decimal place. Also, place the fields in global nodes subscripted with numbers greater than 10,000. If you numberspace your data elements in this way, you will be able to avoid conflicts, if you later install Kernel's NEW PERSON file.


Reviewed/Updated: March 4, 2007