XPDUTL    ICR (10141)

The routine XPDUTL contains multiple calls to support
the Kernel Installation and Distribution System.  All of the calls can only be
used in the context of the KIDS software, during the installation of software,
unless noted differently in the describitions that follow.

The following calls can be used anywhere during the install process:
$$VERSION(X) ;X=package name or package namespace
;Returns the current Version number
** This call can be used outside of KIDs **

$$VER(X) ;X=Build name from Build file or Install file
;Returns version number

$$PKG(X) ;X=Build name from Build file or Install file
;Returns package name

$$PATCH(X) ;X=Patch from Install file, (aaaa*nn.nn*nnn)
;Return 1 if patch X was installed, 0 if not installed
** This call can be used outside of KIDs **

$$LAST(X,Y,Z) ;X=Package name or namespace, Y=Version (optional, current if
not supplied), Z=1 released patch (optional, last released patch)
;Returns Last Patch and Date applied to a package
;PATCH will include Seq # if a released patch is last
;PATCH #^DATE,  ("nnn^yyymmdd" or "nnn Seq #nn^yyymmdd")
;-1 will be returned if either Package or Version do not exist
;   or No patches have been applied
** This call can be used outside of KIDs **

$$INSTALDT(X,.Y) ;X=Name from Install file, variable passed by reference
;Returns all installs for X in Install file
;Return array in Y, Y=number of records in array
;Y(internal date/time) = TEST # ^ SEQ #
** This call can be used outside of KIDs **

The following function can only be used in the Environment Check Routine
$$RTNUP(X,Y) ;X=routine name, Y= 1-delete, 2-skip
;changes the install action of a routine to delete or skip
;Returns 1 if successfull, 0 for failure


The following calls can be used during the Pre-Install or Post-Install
routines: $$PRODE(XPDN,XPD) ;XPDN=protocol name, XPD=1-enable, 0-disable
;enable/disable protocols
;Returns 1 if successfull, 0 for failure

$$OPTDE(XPDN,XPD) ;XPDN=option name, XPD=1-enable, 0-disable
;enable/disable options
;Returns 1 if successfull, 0 for failure

MES(X) ;X=message or an array passed by reference
;write message to Install file

BMES(X) ;X=message or an array passed by reference
;add blank line before writing message to Install file

$$NEWCP(XPD,XPDC,XPDP) ;XPD=check point name, XPDC=call back, XPDP=parameters
;create new check point
;Returns ien of check point, 0 for error

$$UPCP(XPD,XPDP) ;XPD=check point name or ien, XPDP=parameters
;update check point
;Returns ien of check point, 0 for error

$$COMCP(XPD) ;XPD=check point name or ien
;complete check point
;Returns date/time of completion, 0 for error

$$VERCP(XPD) ;XPD=check point name or ien
;verify check point, returns 1=completed, 0=not
;Returns 1 for completed, 0 for not completed, -1 for doesn't exist

$$PARCP(XPD,XPDF) ;XPD=check point name or ien, XPDF="PRE" if you want a
;Pre-Install check point while your in the Post-Install routine
;Returns parameters of check point

$$CURCP(XPDF) ;XPDF flag - 0=externel, 1=internal
;Returns current check point