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

Output Parameters

  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