ASC2SRV v2.15  Copyright (c)1992-1993 Alcom Corporation. All rights reserved.

Purpose:
        ASC2SRV is used to add entries to the LanFax Redirector's
	phonebook from a comma-delimited ASCII file.


Requirements:
	- LanFax Redirector Server program (SRV_xxx.EXE)
	- LanFax Redirector Workstation program (WKS_xxx.EXE)


Syntax:
	The command line syntax for ASC2SRV is

	  ASC2SRV [flags] [d:][path]fname[.APB] [[d:][path]fname[.APB] ...]

	where

	  [flags] is one or more OPTIONAL command line flags. The
	    following list describes all valid flags:

	    /Q	    Quiet mode; does not display information on progress
		    unless necessary to resolve problems/errors.

	    /V:vis  Visibility for entries; 'vis' must be one of the
		    following:

		      PRV  Private (default)
		      SHR  Shared
		      PUB  Public

	    /F:c    Set field delimiter character to c. Default
		    field delimiter character is comma ",".

	    /E:c    Set escape character to c. Default escape
		    character is backslash "\".

	    /D:c    Set date separator character to c. Default
		    separator character is hyphen "-".

	    /T:c    Set time separator character to c. Default
		    separator character is colon ":".

	    /I:dis  Default disposition of invalid entries; 'dis' must be
		    one of the following:

		      ASK     Ask disposition (default)
		      ABORT   Abort
		      SKIP    Skip all
		      ACCEPT  Accept all

	    /2:dis  Default disposition of duplicate entries; 'dis' must be
		    one of the following:

		      ASK     Ask disposition (default)
		      ABORT   Abort
		      SKIP    Skip all
		      RENAME  Rename all
		      UPDATE  Update all

	    /G:name Create a phonebook group from the added entries.


	  [d:][path]fname[.APB] is the input file name. It may include
	    an extesion; if none is given, the default is ".APB". See
	    "File Format" below for a description of the file format.

	    You may specify as many input files as the MS-DOS prompt
	    allows you.


Remarks:
	You must be logged on the server before you can use this
	program.

	Only phonebook administrators can add public phonebook entries.

	The command line flags as well as their arguments are
	case-insensitive.


File Format:
	The input file consists of a field description line, and one or
	more record lines. The field description line must be the first
	line in the file, and has the format

	  field1 [,field2 [,...]]

	where

	  fieldx denotes the name of a phonebook database field. Valid
	    field names are:

	      Name	 Type	   Length  Description
	      ---------  -------   ------  -------------------------------
	      Name	 string    79	   Name of the person/fax phone
	      Company	 string    63	   Company name
	      Owner	 number 	   Owner ID
	      ID	 number 	   Identifier of this entry
	      FaxC	 phonenum  9	   Fax country code
	      FaxA	 phonenum  9	   Fax area code
	      FaxN	 phonenum  63	   Fax phone number
	      VoiceC	 phonenum  9	   Voice phone country code
	      VoiceA	 phonenum  9	   Voice phone area code
	      VoiceN	 phonenum  63	   Voice phone number
	      Time	 time		   Preferred time
	      PollCode	 string    31	   CCITT poll code
	      AuditInfo  string    31	   Auditing information
	      BFTFlag	 number 	   Binary transfer flag
	      Revise	 date		   Last revisision date of this entry
	      Fax	 phonenum  63	   Synonym for FaxN
	      Voice	 phonenum  63	   Synonym for VoiceN

	    The field types have the following formats:

	      string is an arbitrary sequence of characters up to a
		maximum length (see table above).

	      number is a 16-bit decimal (base 10, no prefix), octal
		(base 8, prefix "0"), or hexadecimal (base 16, prefix
		"0x") number.

	      phonenum is an arbitrary sequence of a limited set of
		characters:

		0 1 2 3 4 5 6 7 8 9 space + - # @ , . : ; / ( ) [ ]

		If the phone number is enclosed in { and }, its contents
		are accepted "as-is" the assumption being that then it
		denotes a valid IPM address. Upon encountering an
		invalid phone number, ASC2SRV gives you the choice of
		skipping or accepting the phone number "as-is".

	      time is a time on the 24-hour clock. It must be entered in
		the format

		  hh:mm[:ss]

		where

		  hh = hours (0-23)

		  mm = minutes (0-59)

		  ss = seconds (0-59, optional)

		You may change the separator character with the /T
		command line flag.

	      date is a date since 1st of January, 1980. It must be
		entered in the format

		  dd-mm-yyyy

		where

		  dd = day of month (1-31)

		  mm = month (1-12)

		  yyyy = year (1980-2099)

		You may change the separator character with the /D
		command line flag.

	Note that you may change the field delimiter character with the
	/F command line flag. The rest of the file consists of one or
	more records, each on contained on one line.

	Lets say you want to add the following person to the phonebook:

	  name:    Tapani Otala
	  company: Alcom Oy, Espoo
	  voice:   +358-0-4554230

	Now, the company name includes an embedded comma which is a
	reserved character (field delimiter). You may avoid this problem
	using any of these three methods:

	  - You may change the field delimiter character to, say, a
	    semicolon instead (use /F command line flag):
		Tapani Otala;Alcom Oy, Espoo;+358-0-4554230

	  - You may use the escape character (default is backslash, "\")
	    to temporarily override the comma delimiter:
		Tapani Otala,Alcom Oy\, Espoo,+358-0-4554230

	  - You may enclose the company name in double quotes in the
	    input file:
		Tapani Otala,"Alcom Oy, Espoo",+358-0-4554230
	    NOTE: If you need double quotes within the quoted text, use
	    the escape character described above.

	Note that you cannot prevent ASC2SRV from removing preceding
	and/or trailing blanks from fields.

