DI*21.0*30 (751)    BUILD (9.6)

Name Value
NAME DI*21.0*30
DATE DISTRIBUTED 1997-01-31 00:00:00
PACKAGE FILE LINK VA FILEMAN
TYPE SINGLE PACKAGE
DESCRIPTION OF ENHANCEMENTS
Description:
file is installed, too.
           Select Installation Option: Install Package(s) 
           Select INSTALL NAME: DI*21.0*30 
                                ==========
 
Answer 'NO' to 'Want to DISABLE Scheduled Options, Menu Options, and 
Protocols?' question. 
 
7.  MSM Sites - Answer YES to the question 'Want to MOVE routines to 
other CPUs?'. Then enter the names of your other Compute and Print 
server(s).
 
 
8.  KIDS will load the patch without further intervention.  During the
KIDS install, KIDS will produce the following messages:
 
        Data Dictionary for File #.403 not installed.
 
        Data Dictionary for File #.404 not installed.
 
These message do NOT indicate an error condition.  They are reporting that
new Data Dictionaries for the Form and Block files are not being installed
A.  Import Data option
although data for those files is being updated.  This is correct.
 
The new option is the Import Data option found on the Other Options 
submenu (DIOTHER) on the VA FileMan menu.  This option invokes a 
ScreenMan form used to define the import.  In addition to moving data 
from a host file into a VA FileMan file, the Import Tool produces a 
report of the import activity.
 
============
Documentation of the Import Tool is located in a revised Chapter 18 of 
the VA FileMan User Manual.  Previously, that chapter documented the 
Data Export Tool.  Now, Chapter 18 documents both the Import and Export 
Tools.  The National Center for Documentation will be distributing this 
revised chapter.  Acrobat versions of both the change pages, and the 
User Manual updated with the change pages, are available at
 
 http://www.vista.domain.ext/softserv/infrastr.uct/fileman/docs/
 
The new chapter is also available in HTML format at:
 
 
 http://www.vista.domain.ext/softserv/infrastr.uct/fileman/docs/u2/
 (access the Import/Export Tools chapter)
 
B. FILE^DDMP API
 
The programmer API consists of a single call: FILE^DDMP.  Functionally, 
it is equivalent to the user option.  The API allows the programmer to 
specify the parameters of the data import.
 
This patch implements new VA FileMan functionality: the Import Tool.  
Documentation in HTML format for the API can be found at:
 
http://www.vista.domain.ext/softserv/infrastr.uct/fileman/docs/
      pm/ft_ddmpf.htm
 
C. Import Template file
 
A new file is added by this patch: the Import Template file (#.46).  The 
file's data is stored in an existing global -- root: ^DIST(.46.  No data 
for the file is contained in this patch.  
The Import Tool will move data from an ASCII host file into a VA FileMan 
 
Routine Summary:
================
 
The following routines are included in this patch.  Checksums are 
CHECK^XTSUMBLD results.
 
 Routine Name         Before Patch     After Patch     Patch List
 ============         ============     ===========     ==========
 DDMP                 <NEW>            11685139        30
file.  The uses and limitations of the Import Tool are described in the 
 DDMP1                <NEW>            9723042         30
 DDMP2                <NEW>            9285380         30
 DDMPSM               <NEW>            7179788         30
 DDMPSM1              <NEW>            3485759         30
 DDMPU                <NEW>            8199841         30
 DII1                 455555           468832          30
 DINIT6               3176942          3570355         30
 
 
The DDMP* routines contain the Import Tool.  DII1 is included to add the 
documentation. The location of the documentation is given below.
Import Data option to the Other menu when VA FileMan is accessed from 
Programmer mode.  DINIT6 assures that the Data Import option will not be 
removed from the Kernel menus if ^DINIT is rerun.  It is NOT necessary 
to rerun ^DINIT to implement this patch.
 
Installation Instructions: 
==========================
  
1.  Neither of the pre-existing routines in this patch are typically 
mapped. It is NOT recommended that any of the DDMP* routines be mapped.
 
 
2.  Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This 
option will load the KIDS package onto your system.
 
3.  The patch has now been loaded into a transport global on your 
system.  You now need to use KIDS to install the transport global.  
 
4.  On the KIDS menu, under the 'Installation' menu, use the following 
options: 
 
The Import Tool consists of a new option and a programmer API.  A new 
           Print Transport Global 
           Compare Transport Global to Current System 
           Verify Checksums in Transport Global 
           Backup a Transport Global 
 
5.  Users may remain on the system when this patch is installed.  
TaskMan should remain running.
 
6.  On the KIDS menu, under the 'Installation' menu, use the following 
option: 
TRACK PACKAGE NATIONALLY NO
FILE
  • UPDATE THE DATA DICTIONARY:   NO
    SEND SECURITY CODE:   NO
    SEND FULL OR PARTIAL DD:   FULL
    RESOLVE POINTERS:   YES
    DATA COMES WITH FILE:   YES
    SITE'S DATA:   OVERWRITE
    MAY USER OVERRIDE DATA UPDATE:   NO
    SCREEN TO SELECT DATA:   I $P(^DIST(.403,Y,0),U)["DDMP"
  • UPDATE THE DATA DICTIONARY:   NO
    SEND SECURITY CODE:   NO
    SEND FULL OR PARTIAL DD:   FULL
    RESOLVE POINTERS:   YES
    DATA COMES WITH FILE:   YES
    SITE'S DATA:   OVERWRITE
    MAY USER OVERRIDE DATA UPDATE:   NO
    SCREEN TO SELECT DATA:   I $P(^DIST(.404,Y,0),U)["DDMP"
  • UPDATE THE DATA DICTIONARY:   YES
    SEND SECURITY CODE:   YES
    SEND FULL OR PARTIAL DD:   FULL
    DATA COMES WITH FILE:   NO
BUILD COMPONENTS
  • ENTRIES:
    • DDMP SPECIFY IMPORT FILE #.46
      FILE:   IMPORT TEMPLATE
      ACTION:   SEND TO SITE
  • ENTRIES:
    • 312
      ACTION:   SEND TO SITE
    • 1831
      ACTION:   SEND TO SITE
    • 1833
      ACTION:   SEND TO SITE
    • 1841
      ACTION:   SEND TO SITE
    • 1842
      ACTION:   SEND TO SITE
    • 1844
      ACTION:   SEND TO SITE
    • 1845
      ACTION:   SEND TO SITE
    • 1846
      ACTION:   SEND TO SITE
    • 1850
      ACTION:   SEND TO SITE
    • 1860
      ACTION:   SEND TO SITE
    • 1862
      ACTION:   SEND TO SITE
    • 409
      ACTION:   SEND TO SITE
    • 1870
      ACTION:   SEND TO SITE
    • 525
      ACTION:   SEND TO SITE
    • 1805
      ACTION:   SEND TO SITE
    • 1810
      ACTION:   SEND TO SITE
    • 1812
      ACTION:   SEND TO SITE
    • 1820
      ACTION:   SEND TO SITE
    • 1821
      ACTION:   SEND TO SITE
    • 1822
      ACTION:   SEND TO SITE
  • ENTRIES:
    • DDMP IMPORT
      ACTION:   SEND TO SITE
    • DIOTHER
      ACTION:   USE AS LINK FOR MENU/ITEM/SUBSCRIBERS
  • ENTRIES:
    • DDMP
      ACTION:   SEND TO SITE
      CHECKSUM:   B53786029
    • DDMP1
      ACTION:   SEND TO SITE
      CHECKSUM:   B37404358
    • DDMP2
      ACTION:   SEND TO SITE
      CHECKSUM:   B52978757
    • DDMPSM
      ACTION:   SEND TO SITE
      CHECKSUM:   B27486073
    • DDMPSM1
      ACTION:   SEND TO SITE
      CHECKSUM:   B6673866
    • DII1
      ACTION:   SEND TO SITE
      CHECKSUM:   B1032872
    • DINIT6
      ACTION:   SEND TO SITE
      CHECKSUM:   B6243575
    • DDMPU
      ACTION:   SEND TO SITE
      CHECKSUM:   B20848526