MAG access top-level and BUILD COMPONENTS data ICR (4897)

Name

Value

NUMBER

4897

IA #

4897

FILE NUMBER

9.6

GLOBAL ROOT

XPD(9.6

DATE CREATED

2006/09/05

CUSTODIAL PACKAGE

KERNEL

USAGE

Controlled Subscription

TYPE

File

DBIC APPROVAL STATUS

APPROVED

NAME

MAG access top-level and BUILD COMPONENTS data

GENERAL DESCRIPTION

Imaging is reading the ALPHA/BETA TESTING field #20 to
utilize a Version Control function that will not allow versions of Imaging
client software to connect to the DataBase if they are no longer supported.

- If the Server Version (that will not support Client X) is in Alpha/Beta
status, Client X will be shown a warning message.  - If the Server Version
(that will not support Client X) is Released, Client X will be forced to
abort.

Update June 23rd 2022:
----------------------
This Integration Agreement (IA) has been updated to access the BUILD
COMPONENTS sub-file for routine components. The VistA Imaging (VI) application
will use the $$FIND1^DIC to lookup the VI build.

VI will use the GETS^DIQ VA FileMan utility to return data specific to the
routine BUILD COMPONENTS (#9.67).

GLOBAL REFERENCE

FIELD NUMBER

GLOBAL DESCRIPTION

XPD(9.6,

FIELD NUMBER	ACCESS	FIELD DESCRIPTION	FIELD NAME	LOCATION
.01	Read w/Fileman	Contains package name or patch name.	NAME	0;1
20	Read w/Fileman	Set of codes: yes - alpha/beta testing or no alpha/beta testing.	ALPHA/BETA TESTING	ABPKG;1

This access is restricted to the specific fields at the
top level of the BUILD (#9.6) file.

XPD(9.6,D0,'KRN',

FIELD NUMBER	ACCESS	FIELD DESCRIPTION	FIELD NAME	LOCATION
10	Read w/Fileman	ENTRIES is a multiple of each BUILD COMPONENT being exported in a VI build.	ENTRIES	10;0

ENTRIES is a multiple for each BUILD COMPONENT being
exported in a VI build. There are fields under the ENTRIES multiple that will
be returned by the software approved to use this IA.

XPD(9.6,D0,'KRN',D1,

FIELD NUMBER	ACCESS	FIELD DESCRIPTION	FIELD NAME	LOCATION
.01	Read w/Fileman	The name of the build component being sent.	ENTRIES	0;1
.02	Read w/Fileman	The build component must exist in a specific pointed-to file. This field contains the VA FileMan file for this build component entry.	FILE	0;2
.03	Read w/Fileman	This is the action you want performed at the installing site on the entry of the build component you are sending for this package.	ACTION	0;3
.04	Read w/Fileman	This field contains the checksum for this build component.	CHECKSUM	0;4

This ENTRIES (#9.68) multiple is a list of each record
that is being sent for a build component. This particular IA focuses on the
routine build component. The VI software using this IA will assume a static D1
value of 9.8 (ROUTINE file number) to return routine specific data to the VI
application.

XPD(9.6,D0,'KRN',D1,'NM','B',

FIELD NUMBER	ACCESS	FIELD DESCRIPTION	FIELD NAME	LOCATION
.01	Read w/Fileman	This global reference will allow the return of the specific build component entry (routines) collated.	ENTRIES	0;1

This is a list of the routine(s) being sent as a build
component.

STATUS

Active

KEYWORDS

alpha/beta testing
MAG BUILD COMPONENTS (KIDS)

XPD(9.6

SUBSCRIBING PACKAGE

SUBSCRIBING PACKAGE	SUBSCRIBING DETAILS
IMAGING	VI is granted permission to read the BUILD (#9.6) and specific sub-files within the BUILD file for the purposes of version control.

DATE ACTIVATED

2022/07/06