Directives
SETFID Set FID( ) Definition
   
Format SETFID [(chan)] fid_def$
 
Where:
 
  chan Optional channel or logical file number.
   
  fid_def$ String value to define FID(0). Its maximum length is 12 characters. String expression.
   
Description Use the SETFID directive to make dynamic changes in the value returned by the FID( ) function. Any open channel may have its FID value changed. If chan is not provided, it defaults to affect channel 0. This is most commonly used to change the FID value of channel 0 (i.e., the terminal) for legacy applications that require unique FID values.
By default, ProvideX uses the value of the operating system environment variable PVXFID0 as the value for FID(0). If this environment variable is not defined, ProvideX will dynamically assign a value starting at T0 (T zero).
   
See Also FID( ) Function.
   
Example In this example, the value in the WHO system variable is something like "SMITHJ":

0010 ! START_UP
0020 OPEN (1)"MYCONFIG"
0030 READ (1,KEY=WHO,ERR=0050)X$
0040 SETFID X$
0050 CLOSE (1)

The following example defines a unique session and terminal FID in a Windows environment, given a directory called C:\FIDS with the files "T5", "T5", "T6", "T7", "T8", and so on. (This could also be done with terminal IDs of 3 characters or more.)

In a START_UP program,

0010 OPEN (1) "C:\FIDS"
0020 READ (1,END=1000) ID$
0030 IF ID$(1,1)="." GOTO 0020 ! Skip "." and ".."
0040 %FID_FILE=GFN
0050 OPEN LOCK (%FID_FILE,TIM=0,ERR=0020) PTH(1)+DLM+ID$
0060 SETFID ID$
0070 CLOSE (1)
....
1000 MSGBOX "Sorry. There is no free FIDs for this station."
1010 QUIT

This logic will open and leave open a file pertaining to the station FID. Once the task ends, the file will be available for another session.