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

$$LAST^XPDUTL(): Last Software Patch

Reference Type: Supported, Category: KIDS, Integration Agreement: 10141

Description

This extrinsic function returns the last patch and the date it was applied to the software. The patch will also include the Sequence # if the last patch was a released patch.

NOTE: This API can be used outside of KIDS.

Format

  $$LAST^XPDUTL(x[,y][,z])

Input Parameters

x:

(required) Software name or software namespace entered within quotes (e.g., "KERNEL" or "XU").

y:

(optional) Full software version number with decimal point entered within quotes (e.g., "8.0"). The current version is assumed if this parameter is not supplied.

z:

(optional) This parameter was added with Kernel Patch XU*8.0*559. If set to 1, then only the last released patch information is returned.

Output

returns:

Returns the last patch information in a caret-delimited string:

  • nnn^yyymmdd—Unreleased patch, where "nnn" = patch number and "yyymmdd" = date in VA FileMan format.

  • nnn Seq #nnn^yyymmdd—Released patch, where "nnn" = patch number, "Seq #nnn" = sequence number for released patch, and "yyymmdd" = date in VA FileMan format.

  • -1—If either the software or version does not exist or no patches have been applied.

Example 1

>S X="KERNEL"

>S Y="8.0"

>W $$LAST^XPDUTL(x,y)
543^3110503
 

Example 2

>S X="KERNEL"
>S Y="8.0"
>S Z=1
>W $$LAST^XPDUTL(X,Y,Z)
431 SEQ #453^3110425.122831

Example 3

>S X="KERNEL"
>S Y="9.0"
>S Z=1
-1

For this example, since there is no Kernel Version 9.0 the expected result should be -1.


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.