Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

DEVICE^XUDHGUI(): GUI Device Lookup

Reference Type: Supported, Category: Device Handler, Integration Agreement: 3771

Description

This API allows VistA Graphical User Interface (GUI)-based applications to look up devices. This API retrieves the first 20 devices that meet the specifications passed. This API was made available with Kernel Patch XU*8.0*220.

Format

  DEVICE^XUDHGUI(.list,starting_point[,direction][,right_margin_range])

Input Parameters

.list:

(required) Named array to store output.

starting_point:

(required) This parameter indicates where to start the $ORDERing of the Global. "P" will only return devices whose name starts with "P"; "P*" will return up to 20 devices the first starting with "P".

direction:

(optional) This parameter indicates whether to $ORDER up or down from the starting_point parameter. The acceptable values are 1 and -1:

  • 1—Up

  • -1—Down
right_margin_range:

(optional) This parameter is used to specify a width range of devices:

  • Exact Width (e.g., "132-132")

  • At Least Width (e.g., "132")

  • Range (e.g., "80-132")

Output Parameters

.list:

The data is returned in this named array. Data is returned in the following format:

  IEN^NAME^DISPLAY NAME^LOCATION^RIGHT MARGIN^PAGE LENGTH

Example 1

In this example, we want to store/display a list of all devices that begin with "P" in an array (e.g., DEVICES), without passing a direction or right margin range parameter:

>K DEVICES
>D DEVICE^XUDHGUI(.DEVICES,"P")

The DEVICES array displays the following results:

  >ZW DEVICES
DEVICES(1)=358^P-MESSAGE-HFS^P-MESSAGE-HFS^HFS FILE=>MESSAGE^255^256
DEVICES(2)=350^P-MESSAGE-HFS-MSM^P-MESSAGE-HFS-MSM^HFS FILE==> MESSAGE^80^999
DEVICES(3)=348^P-MESSAGE-HFS-ONT^P-MESSAGE-HFS-ONT^HFS FILE==> MESSAGE^80^999
DEVICES(4)=274^P-MESSAGE-HFS-VXD^P-MESSAGE-HFS-VXD^HFS FILE==> MESSAGE^80^256
DEVICES(5)=292^P-RESMON^P-RESMON^IRM^132^64
DEVICES(6)=310^P-WINDOC^P-WINDOC^MWAPI WINDOW DOCUMENT BOX^80^256

 

Example 2

In this example, we want to store/display a list of all devices that begin with "P" in an array (e.g., DEVICES), without passing a direction parameter but including those devices with a right margin of an exact width of 80:

>K DEVICES
>D DEVICE^XUDHGUI(.DEVICES,"P",,"80-80")

The DEVICES array displays the following results:

  >ZW DEVICES
DEVICES(1)=350^P-MESSAGE-HFS-MSM^P-MESSAGE-HFS-MSM^HFS FILE==> MESSAGE^80^999
DEVICES(2)=348^P-MESSAGE-HFS-ONT^P-MESSAGE-HFS-ONT^HFS FILE==> MESSAGE^80^999
DEVICES(3)=274^P-MESSAGE-HFS-VXD^P-MESSAGE-HFS-VXD^HFS FILE==> MESSAGE^80^256
DEVICES(4)=310^P-WINDOC^P-WINDOC^MWAPI WINDOW DOCUMENT BOX^80^256

Example 3

In this example, we want to store/display a list of all devices that begin with "P" in an array (e.g., DEVICES), without passing a direction parameter but including those devices with a right margin width range of 80-132:

>K DEVICES
>D DEVICE^XUDHGUI(.DEVICES,"P",,"80-132")

The DEVICES array displays the following results:

  >ZW DEVICES
DEVICES(1)=350^P-MESSAGE-HFS-MSM^P-MESSAGE-HFS-MSM^HFS FILE==> MESSAGE^80^999
DEVICES(2)=348^P-MESSAGE-HFS-ONT^P-MESSAGE-HFS-ONT^HFS FILE==> MESSAGE^80^999
DEVICES(3)=274^P-MESSAGE-HFS-VXD^P-MESSAGE-HFS-VXD^HFS FILE==> MESSAGE^80^256
DEVICES(4)=292^P-RESMON^P-RESMON^IRM^132^64
DEVICES(5)=310^P-WINDOC^P-WINDOC^MWAPI WINDOW DOCUMENT BOX^80^256

Example 4

In this example, we want to store/display a list of up to 20 devices, the first of which starts with "P," in an array (e.g., DEVICES), without passing a direction or right margin range parameter:

>K DEVICES
>D DEVICE^XUDHGUI(.DEVICES,"P*")

The DEVICES array displays the following results:

  >ZW DEVICES
DEVICES(1)=358^P-MESSAGE-HFS^P-MESSAGE-HFS^HFS FILE=>MESSAGE^255^256
DEVICES(2)=350^P-MESSAGE-HFS-MSM^P-MESSAGE-HFS-MSM^HFS FILE==> MESSAGE^80^999
DEVICES(3)=348^P-MESSAGE-HFS-ONT^P-MESSAGE-HFS-ONT^HFS FILE==> MESSAGE^80^999
DEVICES(4)=274^P-MESSAGE-HFS-VXD^P-MESSAGE-HFS-VXD^HFS FILE==> MESSAGE^80^256
DEVICES(5)=292^P-RESMON^P-RESMON^IRM^132^64
DEVICES(6)=310^P-WINDOC^P-WINDOC^MWAPI WINDOW DOCUMENT BOX^80^256
DEVICES(7)=202^C6_SDD_MX3 ROUTINE^ROUTINE <C6_SDD_MX3 ROUTINE>^Next to Jean's Office^80^59
DEVICES(8)=428^SDD DUPLEX P10^SDD DUPLEX P10^SSD DUPLEX PRINTER NEXT TO JACK^80^60
DEVICES(9)=429^SDD P10^SDD P10^Printer next to Jack.^80^60
DEVICES(10)=329^C6_SDD_MX3 P10^SS10 <C6_SDD_MX3 P10>^Near Jean's Office^80^59
DEVICES(11)=330^C6_SDD_MX3 P12^SS12 <C6_SDD_MX3 P12>^Near Jean's Office^96^57
DEVICES(12)=331^C6_SDD_MX3 P16^SS16 <C6_SDD_MX3 P16>^Near Jean's Office^255^58
DEVICES(13)=349^C6_SDD_MX3 P16P8L^SS16P8L <C6_SDD_MX3 P16P8L>^Near Jean's Office^117^79
DEVICES(14)=202^C6_SDD_MX3 ROUTINE^SSR <C6_SDD_MX3 ROUTINE>^Next to Jean's Office^80^59
DEVICES(15)=427^SUP$PRT TEST^SUP$PRT TEST^DISK FILE^132^58
DEVICES(16)=283^SYS$INPUT^SYS$INPUT^SYS$INPUT;^132^64
DEVICES(17)=198^VMS FILE^VMS FILE^DISK^80^64
DEVICES(18)=349^C6_SDD_MX3 P16P8L^VPM <C6_SDD_MX3 P16P8L>^Near Jean's Office^117^79
DEVICES(19)=291^VTB255^VTB255^RMS FILE^255^99999
DEVICES(20)=288^ZBROWSE^ZBROWSE^RMS FILE^255^99999

 


VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.