+---------------------------------------------------------------+ | | | Property of the US Government. | | No permission to copy or redistribute this software is given. | | Use of unreleased versions of this software requires the user | | to execute a written test agreement with the VistA Imaging | | Development Office of the Department of Veterans Affairs, | | telephone (301) 734-0100. | | | | The Food and Drug Administration classifies this software as | | a medical device. As such, it may not be changed in any way. | | Modifications to this software may result in an adulterated | | medical device under 21CFR820, the use of which is considered | | to be a violation of US Federal Statutes. | | | +---------------------------------------------------------------+ This file will contain an entry for every network storage location, as well as MUSE (EKG) network location(s). This file maps logical device names to physical device names, allowing continued operation even when network storage devices are done. The Imaging site parameters has a number of fields pointing to this file to locate where on the network different files are written. Because the Imaging System operates in a distributed environment, an object may be stored on one or more of the network storage devices. These include multiple magnetic file servers, one or more optical jukeboxes, and possibly additional network devices accessed through a gateway. Each logical location in the Network Location file is mapped to a physical device. Every physical device on the network that will be used for objects must have at least one entry in the Network Location file. The Operational Status field allows rapid software reconfiguration in the event of failure of one of the object storage devices. Each network storage device has a type, such as magnetic or optical. This allows "automatic file migration," where an object resides on a fast magnetic disk until 30 days since its last access, then it is moved to slower, less expensive optical media. Three fields in the Image file (2005) are used to indicate the storage device(s) on which the object resides. For example, an object may originally be captured to MAG1, the first magnetic server. Within seconds, an abstract is created and stored on this same device; the Disk & Vol, Abstract field will be set to MAG1 also. Next, the Image file will be copied to the optical jukebox (if present on the network), creating an immediate backup copy. The Disk & Vol, Optical field will now be set to point to the optical device used for the optical copy. The Network Location file was designed to allow access across a gateway. This type of access has not been required at the test sites. We recommend using names for magnetic devices that begin with the three letters, MAG, followed by sequential numbers. We recommend that images be stored in directories named IMAGE at the first level. Do not store any files in this directory that are not objects handled by File 2005. Logical names for Write Once Read Many (WORM) optical devices should start with the four letters, WORM.
.01network location(+)0;1FREE TEXTBThis is the alias name of an Imaging share.
.04place(+)0;10POINTER2006.1This field identifies the SITE PARAMETER file entry. The Site parameter entry defines all of the attributes of Vista Imaging local area network. This includes facility user preferences, network write locations, etc.
1physical reference0;2FREE TEXTACThis is the physical network location where the image is stored. This is the Universal Naming Convention (UNC) path for the Image Storage. For example: \\SERVER01\IMAGE1\ This is a required field for all entries except for an entry defined with a RAID-GROUP STORAGE TYPE (#6). Duplicate PHYSICAL REFERENCE values within the same VistA Imaging configuration PLACE (#.04) are not allowed.
2total space0;3NUMERICThis is the total available formatted space of this network location. The information in this field is dependent on the connectivity of the share and may be set to zero if the share is not available. This field is maintained by the RPC MAGQ FS CHNGE.
3space used0;4NUMERICThis is the amount of space which has been used for this network location - this value is device dependent.
4free space0;5NUMERICThis is the amount of available space remaining for this network location. The information in this field is dependent on the connectivity of the share and may be set to zero if the share is not available. This field is maintained by the RPC MAGQ FS CHNGE.
5operational status(+)0;6SET OF CODES0:Off-Line
This field tells the Imaging software whether or not this network location, where images are stored, is online. The default is online if the field is null.
5.5read only1;6BOOLEAN0:NO
This field enables applications to filter shares that are designated as read only by active VistA Imaging applications.
6storage type(+)0;7SET OF CODESMAG:MAGNETIC
EThis field describes the media type of this network location. It should be MAGNETIC for a magnetic disk server. Jukeboxes should be WORM-DG for Data General Jukeboxes under OpenNetware or WORM-PDT for Pegasus Jukeboxes or WORM-OTG for OTG Disk Extender. WORM-DG and WORM-PDT are for backward compatibility only. Note: WORM stands for Write Once, Read Many. The GCC type refers to the Generic Carbon Copy (GCC) utility. URL is used for Web based file access. Type 'RTR' should be used to identify network entries that are used for Routing images. Type 'GRP' will identify a group entry and will allow sites to group network locations. This functionality is useful for the Background Processor and Verifier applications.
7hash subdirectory0;8BOOLEANY:YES
Control whether subdirectory should be hashed.
This field is a flag indicating whether or not a network location supports ABSTRACT image files'.
This field is a flag indicating whether or not a network location supports FULL image files.
This field is a flag indicating whether or not a network location supports BIG image files.
This field is a flag indicating whether or not a network location supports TEXT image files.
This field is a flag indicating whether or not a network location supports DICOM image files.
14compression1;7SET OF CODESNONE:None
This field indicates which type of compression, if any, is to use while transmitting files to this network location.
15user name2;1FREE TEXTThis field is for a user name used to establish a connection with the network location.
16password2;2FREE TEXTThis field is a password used with a user name to establish a connection with this network location.
18max # retry on connect3;2NUMERICThis field indicates the number of attempts to make to connect with the network location. When no connection can be established within this number of attempts, the status of the network location will be set to 'Off-Line'.
19max # retry on transmit3;3NUMERICThis field indicates the number of attempts to make to transmit a file. When a file cannot be transmitted within this number of attempts, its status will be set to 'FAILED'.
This field is a code for the syntax that describes the actual (physical) name of the network location.
21subdirectory4;2FREE TEXTFiles are typically not stored in root directories. This field is the name of a subdirectory where files are to be stored. The value of this field is concatenated to the name of the network location (the 'physical name') to create the complete path-name for the location where files are to be stored. When "directory hashing" iS active, additional subdirectory names will be added to the above-mentioned path-name before the file name is appended.
23retention period3;1NUMERICThis field indicates the number of days to retain routed image files at the location identified by this entry in the NETWORK LOCATION file. When Images are present for more than this number of days, they are candidates for automatic removal.
24last purge date3;4DATE-TIMEThis field indicates the date and time of the most recent purge at this network location. An automatic purge will be executed at most once per day; the value of this field determines whether or not a purge has already taken place.
25site3;5FREE TEXTThis field is a code for the site of the 'network location. This code is typically a three-letter abbreviation\acronym (WAS for Washington DC, STL for St. Louis, etcetera). For stations 'at home', a longer code that starts with "HOME" is entered.
This boolean value is used to designate certain network location shares as routing shares. This is necessary to allow clinical WS applications access to images on these shares but to prevent the background processor from designating this share as the current write location.
27time offline3;6DATE-TIMEThis field is a time stamp indicating when the equipment in question most recently went off-line. This time stamp is used by the Routing software to decide whether or not to attempt to reconnect to a destination that was not reachable at an earlier stage.
28muse site #6;1NUMERICIf this is a MUSE EKG network location, enter the MUSE site number for this location. Typically, a site with a single MUSE server that holds EKGs for one site uses 1. If a MUSE server stores EKGs for more than one site, then Marquette assigns each site a MUSE site number.
29muse version #6;2POINTER2006.17Enter the MUSE version number if this network location is a MUSE EKG storage type.
30share group7;0MULTIPLE2005.22This subfile identifies the entries that are part of a Shared Group Imaging sites can use this functionality to group their network shares.
31group member1;8POINTER2005.2This field identifies the Group name that this network location is part of. Only entries that have a Storage Type of 'GRP' can be selected.

Referenced by 7 types

  1. IMAGE (2005) -- disk & volume, magnetic, disk & volume, abstract, disk & volume, worm, big magnetic path, big jukebox path
  2. IMAGE AUDIT (2005.1) -- disk & vol,magnetic, disk & volume. - abstract, disk & vol.: worm, big magnetic path, big jukebox path
  3. NETWORK LOCATION (2005.2) -- group member
  4. IMAGE ACTIONS (2005.86) -- export location
  5. SEND QUEUE (2006.035) -- destination
  6. IMAGING SITE PARAMETERS (2006.1) -- image network write location, current raid group, gcc export loc, image network import location, pacs directory, pacs image write location, jukebox write location, net update directory, net update test directory, net site service
  7. ARTIFACT INSTANCE (2006.918) -- disk volume