HELPLIB.HLB  —  RTL Routines, LIB$  LIB$INIT_DATE_TIME_CONTEXT
    The Initialize the Context Area Used in Formatting Dates and
    Times for Input or Output routine allows the user to initialize
    the context area used by LIB$FORMAT_DATE_TIME or LIB$CONVERT_
    DATE_STRING with specific strings, instead of through logical
    name translation.

    Format

      LIB$INIT_DATE_TIME_CONTEXT  user-context ,component

                                  ,init-string

1  –  Returns

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

2  –  Arguments

 user-context

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

    User context 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.

 component

    OpenVMS usage:longword_signed
    type:         longword (signed)
    access:       read only
    mechanism:    by reference

    The component of the context that is being initialized. The
    component argument is the address of a signed longword that
    indicates this component. Only one component can be initialized
    per call to LIB$INIT_DATE_TIME; these component codes are shown
    in the following list.

    o  LIB$K_MONTH_NAME

    o  LIB$K_MONTH_NAME_ABB

    o  LIB$K_FORMAT_MNEMONICS

    o  LIB$K_WEEKDAY_NAME

    o  LIB$K_WEEKDAY_NAME_ABB

    o  LIB$K_RELATIVE_DAY_NAME

    o  LIB$K_MERIDIEM_INDICATOR

    o  LIB$K_OUTPUT_FORMAT

    o  LIB$K_INPUT_FORMAT

    o  LIB$K_LANGUAGE

 init-string

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

    The characters that are to be used in formatting dates and times
    for input or output. The init-string argument is the address of a
    descriptor pointing to this string.
Close Help