| # | Name | Location | Type | Details | Index | Description |
|---|---|---|---|---|---|---|
| .01 | name(+) | 0;1 | FREE TEXT | B | This 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. | |
| .02 | location of terminal(+) | 1;1 | FREE TEXT | This is a free text description of where the device is located, e.g. Ward 2A nurse station, etc. | ||
| .03 | mnemonic | MN;0 | MULTIPLE | 3.501 | These are alternate names which may be used to select the device. | |
| .04 | local synonym | 1;4 | FREE TEXT | LSYN | This 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. | |
| .13 | purge old print queue files | 0;13 | BOOLEAN | Y:YES N:NO | 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;2 | FREE TEXT | C | This 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.9 | volume set(cpu) | 0;9 | FREE TEXT | This 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.95 | sign-on/system device | 0;11 | BOOLEAN | 1:YES 0:NO | 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. | |
| 2 | type(+) | TYPE;1 | SET OF CODES | TRM:TERMINAL OTH:OTHER MT:MAGTAPE SDP:SDP SPL:SPOOL BAR:BARCODE READER HFS:HOST FILE SERVER VTRM:VIRTUAL TERMINAL RES:RESOURCES CHAN:NETWORK CHANNEL IMPC:IMAGING WORK STATION PQ:PRINT QUEUE | 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. | |
| 3 | subtype(+) | SUBTYPE;1 | POINTER | 3.2 | This 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. | |
| 4 | ask device | 0;3 | BOOLEAN | 1:YES 0:NO | This field controls if the 'DEVICE' question is asked when a call is made to ^%ZIS. | |
| 5 | ask parameters | 0;4 | BOOLEAN | 1:YES 0:NO | 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.1 | ask host file | 1;5 | BOOLEAN | 1:YES 0:NO | 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.2 | ask hfs i/o operation | 1;6 | BOOLEAN | 1:YES 0:NO | 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.5 | queuing | 0;12 | SET OF CODES | 0:ALLOWED 1:FORCED 2:NOT 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. | |
| 6 | out-of-service date | 90;1 | DATE-TIME | If entered then this device cannot be selected if the current date is greater than, or the same as, the date specified. | ||
| 7 | nearest phone | 90;2 | FREE TEXT | The location of the telephone nearest to this device. | ||
| 8 | key operator | 90;3 | FREE TEXT | The name of the person who usually uses this device. | ||
| 9 | margin width | 91;1 | NUMERIC | This 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. | ||
| 11 | page length | 91;3 | NUMERIC | This 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.2 | suppress form feed at close | 1;11 | BOOLEAN | 1:YES 0:NO | 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. | |
| 15 | security | 95;E1,99 | FREE TEXT | The 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. | ||
| 16 | closest printer | 99;1 | POINTER | 3.5 | This is the name of the nearest printer, it is selected at the "DEVICE" prompt simply by entering "P". | |
| 17 | form currently mounted | F;1 | FREE TEXT | F | This describes the type of form currently in the printer. | |
| 19 | open parameters | IOPAR;1 | FREE TEXT | These 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.3 | close parameters | IOCPAR;1 | FREE TEXT | This field holds the parameters to be used in a MUMPS CLOSE statement. | ||
| 19.5 | use parameters | IOUPAR;1 | FREE TEXT | This field holds the parameters to be used in a MUMPS USE statement. | ||
| 19.7 | pre-open execute | POX;E1,245 | FREE TEXT | This 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.8 | post-close execute | PCX;E1,245 | FREE TEXT | This is the Xecutable MUMPS code which is used by %ZISC after closing the device. | ||
| 20 | baud rate | COMPUTED | This 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. | |||
| 21 | micom printer contention port | 1;7 | BOOLEAN | 1:YES 0:NO | 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. | |
| 23 | modem | 0;6 | POINTER | 3.2 | If 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. | |
| 25 | priority at run time | 0;5 | NUMERIC | This 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. | ||
| 26 | taskman print a header page | 0;7 | BOOLEAN | y:YES n:NO | 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. | |
| 27 | password | 1;2 | FREE TEXT | Passwords 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. | ||
| 28 | slaved from device | 0;8 | POINTER | 3.5 | This 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. | |
| 31 | auto despool | 1;8 | BOOLEAN | 1:YES 0:NO | Answer 'YES' if the report is to be automatically despooled. | |
| 32 | despool devices | SPL;0 | MULTIPLE | 3.532 | This is the list of printers that reports will be printed during the despool process for the named spool device. | |
| 33 | generate spl doc name | 1;9 | BOOLEAN | 1:YES 0:NO | Answer 'YES' to this field if the spool document name is to be automatically generated. | |
| 35 | resource slots | 1;10 | NUMERIC | Enter 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. | ||
| 36 | global lock | GBL;1 | BOOLEAN | 0:No 1:Yes | This field tells the device handler if it should use a global lock to control access to a device. | |
| 51 | open count | 5;1 | NUMERIC | This 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.1 | timed read (# of seconds) | XUS;10 | NUMERIC | The number of seconds for timed reads at this device. It is overridden by the Timed Read specification in the USER File. | ||
| 51.12 | *reserved | XUS;12 | FREE TEXT | |||
| 51.13 | *reserved | XUS;13 | FREE TEXT | |||
| 51.14 | *reserved | XUS;14 | FREE TEXT | |||
| 51.15 | *reserved | XUS;15 | FREE TEXT | |||
| 51.2 | # of attempts | XUS;2 | NUMERIC | The 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.3 | lock-out time | XUS;3 | NUMERIC | This 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.4 | multiple sign-on | XUS;4 | SET OF CODES | 0:NOT ALLOWED 1: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.5 | ask device type at sign-on | XUS;5 | SET OF CODES | 1:YES, ASK 0:NO, DON'T 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 | |
| 51.6 | auto menu | XUS;6 | SET OF CODES | 0:NO MENUS GENERATED 1:MENUS GENERATED | 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 | *reserved | XUS;7 | FREE TEXT | |||
| 51.8 | tied routine | XUS;8 | FREE TEXT | This field, if filled in, has the name of a routine that is run before the 'ACCESS CODE' question is asked. Use with care. | ||
| 51.9 | type-ahead | XUS;9 | SET OF CODES | Y:ALLOWED N:NOT ALLOWED | 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.91 | perform device checking | XUS;11 | BOOLEAN | 0:NO 1:YES | 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. | |
| 52 | secondary $i | 2;1 | FREE TEXT | This 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. | ||
| 61 | lat server node | VMS;1 | FREE TEXT | This is the DECserver/terminal server node name that the device is on. It is used by XTLATSET to build data files for VMS startup. | ||
| 62 | lat server port | VMS;2 | FREE TEXT | This 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. | ||
| 63 | vms device type | VMS;3 | SET OF CODES | n:NOT SPOOLED y:YES SPOOLED m:HOSTSYNC/NOWRAP l:LAB INSTRUMENT w:NOWRAP p:PASTHRU/NOWRAP | 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. | |
| 64 | lat port speed | VMS;4 | SET OF CODES | 300:3 1200:12 2400:24 4800:48 9600:96 19200:192 | This field holds the value that will be passed to the TSC_LOAD.COM file for loading the DECserver permanent database. | |
| 65 | print server name or address | VMS;5 | FREE TEXT | This 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). | ||
| 66 | telnet port | VMS;6 | NUMERIC | This field contains the telnet port of a remote device (e.g., a telnet printer). The allowable range is a number between 2000 and 65534. | ||
| 67 | remote printer name | VMS;7 | FREE TEXT | This is the Name of the Remote Printer that is referenced by the "PRINT SERVER NAME OR ADDRESS" and "TELNET PORT" fields. | ||
| 75 | windows network printer name | WIN;1 | FREE TEXT | This 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. | ||
| 101 | lab label printer | 101;1 | POINTER | 3.5 | This field is used only if the current device has a label printer associated with it. | |
| 201 | primary menu option | 201;1 | POINTER | 19 | This field, if filled in, contains the primary menu that is run from this device. It overrides the user's primary menu. | |
| 646 | barcode avail | 646;1 | BOOLEAN | Y:YES N:NO | This field is used by Augie Turano's pharmacy barcode software. | |
| 2007 | current unsuccessful attempts | COMPUTED | This 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. | |||
| 2008 | last sign-on user | COMPUTED | This is the name of the last user who signed on to this device. It is controlled internally by the KERNEL. | |||
| 2009 | prohibited times for sign-on | TIME;1 | FREE TEXT | This 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.5 | use timeout on opens | TIME;3 | BOOLEAN | n:NO y:YES | This field determines whether a timeout will be used to open the device. | |
| 2010 | open timeout | TIME;2 | NUMERIC | If 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. | ||
| 18000 | nvs passover flag | NV;1 | BOOLEAN | 1: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. |