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

$$LAST^XPDUTL(): Last Software Patch

Reference Type: Supported, Category: KIDS, ICR#: 10141

Description

The $$LAST^XPDUTL extrinsic function returns the last patch and the date it was applied to the software. The patch also includes 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.

 

Examples

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 9.0 the expected result should be -1.