Converts a binary timestamp to a local binary OpenVMS format
    time, using the host system's time differential factor.

    Format

      #include <utc.h>

      int utc_vmslocaltime(*timadr, *utc)

         const utc_t *utc;
         long *timadr;

1 - Parameters

    Input

 *utc

    Binary timestamp.

    Output

 *timadr

    Binary OpenVMS format time expressing local time.

2 - Description

    The VMS Local Time routine converts a binary timestamp to a
    binary OpenVMS format time; the output value represents the
    local time of the host system. The system's offset from UTC
    and the local time value are defined by the time zone rule in
    sys$timezone_rule, which is created by the system configuration
    process sys$manager:net$configure.com.

3 - Returns

     0   Indicates that the routine executed successfully.
    -1   Indicates an invalid time argument or invalid results.

4 - Example

    See the sample program for the vmsgmtime routine.

5 - Related Functions

    Function: utc_vmsmklocaltime