HP 3000 Manuals

BKVERSION [ KSAM/3000 Reference Manual ] MPE/iX 5.0 Documentation


KSAM/3000 Reference Manual

BKVERSION 

Retrieves the version, update number and fix number of the current
KSAM/3000.

       CALL BKVERSION(status, message).

A call to BKVERSION retrieves a printable string of characters that
identifies the current version of the KSAM/3000 procedures used to
process KSAM files.  The string of characters returned by BKVERSION can
be printed.

PARAMETERS 

status           A four-character string variable to which is returned
                 the code that indicates whether or not the call to
                 BKVERSION was successful and if not, why not.  The first
                 character is set to zero when the call succeeds, to
                 another value if it fails.  (Refer to the Status
                 Parameter discussion earlier in this section.)
                 (Required parameter)

message          A string variable to which is returned the
                 identification of the current KSAM/3000 procedures.  It
                 is in the form:

                  *  version.update.fix 

                 where version is an ASCllletter, update is an ASCII
                 integer, and fix is also an ASCII integer.  The three
                 terms are separated by periods.  (Required parameter)

USING BKVERSION 

You may call BKVERSION in order to get the version, update, and fix
numbers of the KSAM/3000 currently being used.  This identification can
be compared to the version, update, and fix numbers that identify the
version in which a KSAM file was created, as returned by the VERIFY
command of program KSAMUTIL (refer to section II). The following example
illustrates use of BKVERSION. Note that two strings are needed.

        10 DIM S$(4) <-------- status 
        20 DIM V$(72) <---- message 
        :
        100 CALL BKVERSION(S$,V$)
        110 PRINT "THE CURRENT KSAM/3000 IS HP32208.";V$
        :
        RUN
        THE CURRENT KSAM/3000 IS HP32208.A.1.23
                                        \-----/
                                            |
                                   contents of V$



MPE/iX 5.0 Documentation