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

    The Set Default State routine sets and/or returns the current
    default state for a key table.

    Format

      SMG$SET_DEFAULT_STATE  key-table-id [,new-state] [,old-state]

1 - Returns

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

2 - Arguments

 key-table-id

    OpenVMS usage:identifier
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Specifies the key table in which you are setting or inquiring
    about a default state. The key-table-id argument is the address
    of an unsigned longword that contains the key table identifier.

    The key table identifier is returned by the SMG$CREATE_KEY_TABLE
    routine.

 new-state

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

    Specifies the new default state for the entire key table. The
    new-state argument is the address of a descriptor pointing to
    the new state string. The specified state name is converted to
    uppercase and stripped of trailing blanks before use.

 old-state

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

    Receives the existing default state name of the specified key
    definition table. The old-state argument is the address of a
    descriptor pointing to the string into which the old state string
    is written.