VMS Help RTL Routines, LIB$, LIB$GET_DATE_FORMAT  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Get the User's Date Input Format routine returns information
    about the user's choice of a date/time input format.

    Format

      LIB$GET_DATE_FORMAT  format-string [,user-context]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 format-string

    OpenVMS usage:char_string
    type:         character string
    access:       write only
    mechanism:    by descriptor

    Receives the translation of LIB$DT_INPUT_FORMAT. The format-
    string argument is the address of a descriptor pointing to this
    format string.

 user-context

    OpenVMS usage:context
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference

    Context variable that retains the translation context over
    multiple calls to this routine. The user-context argument is the
    address of an unsigned longword that contains this context. The
    initial value of the context variable must be zero. Thereafter,
    the user program must not write to the cell.

    The user-context argument is optional. However, if a context cell
    is not passed, LIB$GET_DATE_FORMAT may abort if two threads of
    execution attempt to manipulate the context area concurrently.
    Therefore, when calling this routine in situations where
    reentrancy might occur, such as from AST level, Compaq recommends
    that users specify a different context cell for each calling
    thread.