Files > DEVICE

This file defines all input/output devices that can be accessed from this CPU (definitions are not account-specific). Each device is identified with a unique name. Each is associated with a $I value which may correspond with a hardware port or, on layered systems, a host file or directory. If there are several devices for the same volume set and $I, one may be given sign-on system status. Devices may also be assigned to hunt groups to share work. This file is cross-referenced by name, $I, volume set(CPU), and sign-on/system device. It is also cross-referenced by hunt group, local synonym, mnemonic, subtype, and form currently mounted.
.01name(+)0;1FREE TEXTBThis is the name of the device. It is used at the 'DEVICE' prompt to select this device. It should not be the internal name for the device but a logical one. It must start with 1 uppercase and not contain lowercase.
.02location of terminal(+)1;1FREE TEXTThis is a free text description of where the device is located, e.g. Ward 2A nurse station, etc.
.03mnemonicMN;0MULTIPLE3.501These are alternate names which may be used to select the device.
.04local synonym1;4FREE TEXTLSYNThis is an alternate name which may be used to select the device. When using the LOCAL SYNONYM to select the device, selection can only occur on the local CPU. For example, if you assigned a LOCAL SYNONYM to one device on the local CPU, and the same name to a device on the remote CPU, selection using the LOCAL SYNONYM will return the device on the local CPU.
.13purge old print queue files0;13BOOLEANY:YES
This field determines whether old HFS files associated with entries in the PRINT QUEUE JOB (#3.52) file should be deleted. It only applies to devices of the PRINT QUEUE type. For print queues, an intermediate host file is created in the PRINT_QUEUES subdirectory. Normally, these files are automatically deleted once they have been submitted to the print queue. For those files that are not automatically deleted, there is a scheduled option that will periodically delete host files that have been somehow left in existence past their usefulness. Setting this field to NO will prevent the purge option from deleting HFS files created via this device. Setting this field to NO should only be done on a temporary basis while troubleshooting a problem involving a print queue. The default value for this field is YES.
1$i(+)0;2FREE TEXTCThis field holds the Hardware port name that the OS can identify when referencing a port on a CPU. On layered systems where opening of host files is supported, this field may hold the host file name. When defining a spool device entry(TYPE="SPL") on VAX DSM or MSM-Unix, enter the name of directory where spool host files will be created.
1.9volume set(cpu)0;9FREE TEXTThis field holds the name of the CPU to which this device belongs. This field holds the name of the CPU where the physical port resides. On DSM-11, VAX DSM, this field may hold the name of the Volume Set. On M/11+, this field may hold the name of the Directory Set. If no name has been entered for this field, this device is assumed to be accessible from all CPUs in the network. In other words, when this device is referenced, the device handler will operate as if this device is resident on the local CPU. For example, if there is a device that uses the same $I on each CPU, one entry can be made in the Device File by leaving the 'Volume Set(CPU)' Field null. This shortcut will work only if the same $I has been associated with this device on every CPU.
1.95sign-on/system device0;11BOOLEAN1:YES
If answered 'YES', this field identifies that this entry is the primary device among those device entries that have the same $I with the same VOLUME SET(CPU). Among those device entries that have a common $I and CPU, only one of these entries can have this field set to 'YES'. If none of the common device entries are set to 'YES', the default device will be identified by the first device on the CPU x-ref. The default device is used when the device handler is invoked with $I as the device to be selected.
This field has the general type of device on the CPU. 'TRM' is the most common entry. TRM -- Terminal devices such as most crts and printers should be associated with a corresponding device entry with a type of 'TRM'. HFS -- Host File Server is only available on mumps platforms that exists on a layered system(e.g.: VMS, UNIX, NT, etc.). This type and the associated functionality provides the vehicle to read and write to host level files. Instead of directing reports to a printer, the results could be placed into a VMS, NT or UNIX file. This would allow a non-mumps based statistical package or spreadsheet to use data produced by the mumps based application by simply extracting data from the host file. VTRM -- Virtual Terminal Server devices are those that are associated with a dynamically created mumps port identification($I). A generic device entry with a device type of 'VTRM' can be established for users who log into the system through terminal servers. RES -- Resources is a type used for special sequencing of tasks that do not require a particular device. CHAN -- Network Channels are high speed devices that use network protocols such as TCP/IP. OTH -- Other devices that do not fit a particular category should be given a type of 'OTH'. MT -- Magtape device should have a type of 'MT'. SPL -- Spool device is a predefined allocated disk space similar to SDP. However, access to the spool device can be achieved from multiple users simultaneously. BAR -- Bar code reader. This type identifies the device as a barcode reader. SDP -- Sequential Disk Processor is a predefined allocated disk space used for sequential processing. On DSM-11 and M/11+ systems, devices 59 thru 62 are reserved for SDP. On MSM, the Sequential Block Processor(SBP) is essentially the same as SDP. This has been replaced with HFS. IMPC -- Imaging work station device(reserved for future use for DHCP Imaging Project). PQ -- Print Queues. This type of device will be used on Cache/VMS,Linux, or Unix systems to create host files and pass them to a print server. Print Queue devices are not used on Windows systems.
3subtype(+)SUBTYPE;1POINTER3.2This field tells what type of terminal is on a terminal port. It has a great impact on whether the proper terminal control codes get sent to the terminal.
4ask device0;3BOOLEAN1:YES
This field controls if the 'DEVICE' question is asked when a call is made to ^%ZIS.
5ask parameters0;4BOOLEAN1:YES
On devices of TYPE 'TRM' and 'VTRM', this field controls if the 'RIGHT MARGIN' question is asked after selecting the device. On devices of TYPE 'MT', 'SDP', 'BAR', and 'OTH', this field controls if the 'ADDRESS/PARAMETERS' question is asked after selecting the device.
5.1ask host file1;5BOOLEAN1:YES
Answer 'yes' if 'HOST FILE NAME:' should be asked when the device is selected. TYPE must be 'HFS'. Only applicable on layered systems that support host files.
5.2ask hfs i/o operation1;6BOOLEAN1:YES
For systems that support host files, this field may be used instead of 'ADDRESS/PARAMETERS' to specify more general parameters. If 'Ask Parameters' is null or 'NO', set this field to 'YES' and the device handler will ask for INPUT/OUTPUT OPERATION upon selecting a device.
5.5queuing0;12SET OF CODES0:ALLOWED
When this field is set to FORCED and queuing is allowed by the calling program (%ZIS["Q"), the Device Handler will return IO("Q")=1 upon device selection and the job will be queued. That is, the user does not need to enter "Q" to invoke queuing and will not be prompted with the question about wanting output queued. If the program does not allow queuing (%ZIS'["Q"), the user will see the following message: Sorry, QUEUING is required for this device. Set this field to NOT ALLOWED if queuing is not possible or desired for this device. Set this field to ALLOWED if queuing is possible for this device. When this field is set to ALLOWED, the application/user will determine if queuing is desired. Setting this field to null is the same as setting this field to ALLOWED.
6out-of-service date90;1DATE-TIMEIf entered then this device cannot be selected if the current date is greater than, or the same as, the date specified.
7nearest phone90;2FREE TEXTThe location of the telephone nearest to this device.
8key operator90;3FREE TEXTThe name of the person who usually uses this device.
9margin width91;1NUMERICThis field if it has data will override the Right Margin field value from the Terminal type file. Leave this field blank unless you are sure that you need to have a different Right Margin than what is in the terminal type file.
11page length91;3NUMERICThis field, if it has data, will override the Page Length field value from the Terminal type file. Leave this field blank unless you are sure that you need to have a different Page Length than what is in the terminal type file. If this is a CRT then this is the number of lines which can be displayed on the screen, otherwise, for printers, it is the number of print lines per page.
11.2suppress form feed at close1;11BOOLEAN1:YES
This field is used flag devices that should not have form feeds issued at the time the device is closed. This field should be answered 'YES' for label printers.
15security95;E1,99FREE TEXTThe users DUZ(0) (fileman access) must contain at least one of the characters in this field for the user to be able to select this device.
16closest printer99;1POINTER3.5This is the name of the nearest printer, it is selected at the "DEVICE" prompt simply by entering "P".
17form currently mountedF;1FREE TEXTFThis describes the type of form currently in the printer.
19open parametersIOPAR;1FREE TEXTThese parameters are used to open a device with specified characteristics/addresses. This field is primarily used with non-terminal devices such as magtape and SDP. For SDP, use (block:0) on M/11; (0:block:drive) on DSM. For Magtape, use ("VAL4":0:2048) on both M/11 and DSM.
19.3close parametersIOCPAR;1FREE TEXTThis field holds the parameters to be used in a MUMPS CLOSE statement.
19.5use parametersIOUPAR;1FREE TEXTThis field holds the parameters to be used in a MUMPS USE statement.
19.7pre-open executePOX;E1,245FREE TEXTThis is the Xecutable MUMPS code which is used by %ZIS before opening the device. Setting %ZISQUIT=1 in the PRE-OPEN EXECUTE code will signal %ZIS to reject the selected device.
19.8post-close executePCX;E1,245FREE TEXTThis is the Xecutable MUMPS code which is used by %ZISC after closing the device.
20baud rateCOMPUTEDThis field returns the Baud Rate (i.e. speed) of this device, but only if it is a terminal from which such information can be determined.
21micom printer contention port1;7BOOLEAN1:YES
This field is reserved for future use to determine whether the device uses printer contention. It would be a preliminary check to decide whether it is necessary to invoke the printer contention programs.
23modem0;6POINTER3.2If this device is connected to a modem, this is the name of the type of modem, as found in the TERMINAL TYPE file. Modem names must begin with "M-". This field is used by MailMan for controlling the auto-dialer. If the device is used only for dial-in (receives calls only, never places them), then this field is not necessary.
25priority at run time0;5NUMERICThis field, if set, will be used by the Task Manager to set a job's operating system run priority. Lowest priority is 1, and 10 is the highest.
26taskman print a header page0;7BOOLEANy:YES
If this field is set to YES then, Taskman will print a header page before the job is started to form a break between reports.
27password1;2FREE TEXTPasswords are used for an additional level of security on devices such as modems. If a value is entered in this field, all users trying to log on to this device will be prompted for the password before being prompted for the access code.
28slaved from device0;8POINTER3.5This field may permit queuing to slaved devices. Given hard-wiring such that a display terminal may be identified with a device name, queuing may take place to the slaved device ($I=0). Enter the device name of the display terminal in this field.
31auto despool1;8BOOLEAN1:YES
Answer 'YES' if the report is to be automatically despooled.
32despool devicesSPL;0MULTIPLE3.532This is the list of printers that reports will be printed during the despool process for the named spool device.
33generate spl doc name1;9BOOLEAN1:YES
Answer 'YES' to this field if the spool document name is to be automatically generated.
35resource slots1;10NUMERICEnter a value that will identify the limit of concurrent jobs that may own the same resource. If no data is entered, the device handler will use a default value of 1.
36global lockGBL;1BOOLEAN0:No
This field tells the device handler if it should use a global lock to control access to a device.
51open count5;1NUMERICThis field holds a count of the number of times that %ZIS has successfully open this device. The reason is to find LAT devices that are still in use.
51.1timed read (# of seconds)XUS;10NUMERICThe number of seconds for timed reads at this device. It is overridden by the Timed Read specification in the USER File.
51.12*reservedXUS;12FREE TEXT
51.13*reservedXUS;13FREE TEXT
51.14*reservedXUS;14FREE TEXT
51.15*reservedXUS;15FREE TEXT
51.2# of attemptsXUS;2NUMERICThe number of sign-on attempts before the device is locked from use. This may be ignored by setting the BYPASS DEVICE LOCK-OUT field in the KERNEL SITE PARAMETERS File. The minimum value is set by the VA INFORMATION SYSTEM ACCOUNT AND PASSWORD MANAGEMENT POLICY.
51.3lock-out timeXUS;3NUMERICThis is the amount of time that the device must be idle before the lock will release. This may be ignored by setting the BYPASS DEVICE LOCK-OUT field in the KERNEL SITE PARAMETERS File. The minimum value is set by the VA INFORMATION SYSTEM ACCOUNT AND PASSWORD MANAGEMENT POLICY.
51.4multiple sign-onXUS;4SET OF CODES0:NOT ALLOWED
Specifies whether or not the user of this device can be already signed on the system. It is overridden by the Multiple Sign-on specification in the USER File.
51.5ask device type at sign-onXUS;5SET OF CODES1:YES, ASK
This field (if filled in) will over ride the ones in the KERNEL site parameter file. This is overridden by the same specification in the NEW PERSON File. It controls if the user/terminal should be asked for a terminal type during sign-on. If set to YES then a is sent to the terminal to collect the answer back message, if valid the terminal type is set to this. Otherwise the user is prompted. If set to NO then the one from the Last Sign-on field or device subtype will be used.
This field controls whether the Auto-menu function will be turned on for this device. If it is turned on, it acts just as if the user types a "?" before each prompt. This is overridden by the same specification in the USER File.
51.7*reservedXUS;7FREE TEXT
51.8tied routineXUS;8FREE TEXTThis field, if filled in, has the name of a routine that is run before the 'ACCESS CODE' question is asked. Use with care.
Should the user of this device have 'Type-Ahead' turned on or off. This will be overridden by the same specification in the USER File.
51.91perform device checkingXUS;11BOOLEAN0:NO
This field, if set, will override the default in the KERNEL SITE PARAMETERS File. Device checking involves checking for device lockout, prohibited access times, etc. If turned off, logon will be faster.
52secondary $i2;1FREE TEXTThis field holds the $IO value to be used if this is the secondary system in a mixed OS environment. It is not used otherwise. It is only used for output devices.
61lat server nodeVMS;1FREE TEXTThis is the DECserver/terminal server node name that the device is on. It is used by XTLATSET to build data files for VMS startup.
62lat server portVMS;2FREE TEXTThis is the port on the DECserver/terminal server that this device is connected to. It can be entered in the LC-2-5 form or 31 form. On EQUINOX it is in the PORT_31 form. This field is used by XTLATSET to build VMS datafiles for startup.
63vms device typeVMS;3SET OF CODESn:NOT SPOOLED
This is a flag that is passed into the file LT_PTR.DAT by the routine XTLATSET to select how this port should be setup in VMS by the SYS$MANAGER:SYSPRINT.COM file when it runs.
64lat port speedVMS;4SET OF CODES300:3
This field holds the value that will be passed to the TSC_LOAD.COM file for loading the DECserver permanent database.
65print server name or addressVMS;5FREE TEXTThis field contains the FQDN (fully qualified domain name) or specific TCP/IP address of a remote server (e.g., for LPD/LPR printing) or device (e.g., for telnet printer).
66telnet portVMS;6NUMERICThis field contains the telnet port of a remote device (e.g., a telnet printer). The allowable range is a number between 2000 and 65534.
67remote printer nameVMS;7FREE TEXTThis is the Name of the Remote Printer that is referenced by the "PRINT SERVER NAME OR ADDRESS" and "TELNET PORT" fields.
75windows network printer nameWIN;1FREE TEXTThis is the Windows network name for the printer (e.g., '\\vhaistfpc4\IST-HP4525-1'). It is used by Windows applications that interact with VistA and need a printer identified for output purposes.
101lab label printer101;1POINTER3.5This field is used only if the current device has a label printer associated with it.
201primary menu option201;1POINTER19This field, if filled in, contains the primary menu that is run from this device. It overrides the user's primary menu.
646barcode avail646;1BOOLEANY:YES
This field is used by Augie Turano's pharmacy barcode software.
2007current unsuccessful attemptsCOMPUTEDThis is a count of the current number of unsuccessful attempts that have been made on this device. If it exceeds the DEFAULT # OF ATTEMPTS in the KERNEL SITE PARAMETERS File, the device will be locked for the duration specified in DEFAULT LOCKOUT TIME in the KERNEL SITE PARAMETERS. This field is maintained internally by the KERNEL.
2008last sign-on userCOMPUTEDThis is the name of the last user who signed on to this device. It is controlled internally by the KERNEL.
2009prohibited times for sign-onTIME;1FREE TEXTThis field allows a device to be locked out for certain periods of the day. The time period for which logons will be prohibited is specified in the form HHMM-HHMM. For example, 1630-0800 would lock out the device from 4:30 PM to 8:00 AM. If device checking is bypassed for this device, these times are ignored.
2009.5use timeout on opensTIME;3BOOLEANn:NO
This field determines whether a timeout will be used to open the device.
2010open timeoutTIME;2NUMERICIf a specific timeout is needed when an open is performed, enter the value of the timeout into this field. This will enable %ZIS to "hang" for the number of seconds specified in this field to achieve a connection rather than using the default of zero.
18000nvs passover flagNV;1BOOLEAN1:YES
This field is a flag which will allow for the devices so selected to be skipped in the NVS TEST ACCOUNT initialization process. If the test database has a different path to the device in question, some editting may be needed.

Referenced by 47 types

  1. FAILED ACCESS ATTEMPTS LOG (3.05) -- device
  2. SIGN-ON LOG (3.081) -- device
  3. LINE/PORT ADDRESS (3.23) -- device
  4. DEVICE (3.5) -- closest printer, slaved from device, lab label printer
  5. PRINT QUEUE JOB (3.52) -- device
  6. TASKS (14.4) -- device file entry
  7. OPTION (19) -- server device
  8. HOSPITAL LOCATION (44) -- autofinish clinic printer
  9. PHARMACY PRINTED QUEUE (52.9) -- failed device
  10. INPATIENT USER PARAMETERS (53.45) -- label printer pointer
  11. CLINIC DEFINITION (53.46) -- missing dose printer, pre-exchange report device
  12. BCMA REPORT REQUEST (53.69) -- output device
  13. BCMA BACKUP PARAMETERS (53.71) -- default mar printer
  14. WARD GROUP (57.5) -- atc device pointer
  15. DRUG ACCOUNTABILITY STATS (58.8) -- default green sheet printer, default report printer, default label printer, emergency order printer
  16. OUTPATIENT SITE (59) -- scriptalk device
  17. GROUP DISPLAY (59.3) -- display device
  18. INPATIENT WARD PARAMETERS (59.6) -- ward label printer pointer, pharmacy label printer pointer, pre-exchange report device
  19. PHARMACY SYSTEM (59.7) -- pmis printer
  20. AUTO INSTRUMENT (62.4) -- echo device, direct device
  21. INTERIM REPORTS (64.6) -- device
  22. LABORATORY SITE (69.9) -- log printer for routine lc
  23. RAD/NUC MED PROCEDURES (71) -- required flash card printer
  24. RAD/NUC MED DIVISION (79) -- resource device
  25. IMAGING LOCATIONS (79.1) -- flash card printer name, jacket label printer name, report printer name, request printer name, dosage ticket printer, cancelled request printer
  26. OE/RR LIST (100.21) -- device
  27. REQUEST SERVICES (123.5) -- service printer
  28. HEALTH SUMMARY PARAMETERS (142.99) -- spool device
  29. NURS PARAMETERS (213.9) -- cno printer
  30. IB SITE PARAMETERS (350.9) -- cms-1500 auto printer, ub-04 auto printer, eob auto printer, mra auto printer
  31. RECALL REMINDERS TEAM (403.55) -- printer assign
  32. TEAM (404.51) -- default team printer
  33. CMOP INTERFACE (553) -- cmop device
  34. HBHC SYSTEM PARAMETERS (631.9) -- transmit report printer
  35. PROSTHETICS SITE PARAMETERS (669.9) -- purchasing device, orthotic lab device, restoration clinic device, shoe last clinic device, wheelchair repair shop device, inventory device
  36. EAS MT PARAMETERS (713) -- primary print device
  37. PCE DATA SOURCE (839.7) -- interface device
  38. HL LOWER LEVEL PROTOCOL PARAMETER (869.2) -- hllp device, x3.28 device
  39. HL LOGICAL LINK (870) -- hllp device, x3.28 device
  40. ENGINEERING COMPUTER PORT (6910.1) -- device #
  41. ENGINEERING SECTION LIST (6922) -- device
  42. NOIS OFFICE (7105.3) -- resource
  43. NOIS PARAMETER (7109) -- default resource
  44. TIU PRINT PARAMETERS (8925.93) -- progress notes default printer
  45. TIU DIVISION PRINT PARAMETERS (8925.94) -- progress notes batch printer
  46. TIU DOCUMENT PARAMETERS (8925.95) -- default printer
  47. PARAMETERS (8989.5) -- entity