Name

---

      CATSETDEFAULT

Purpose

---

      This function enables the caller to set existing system settings. The intention
      is to hide the mechanics of default storage from the caller.

Authors

---

        FANNING SOFTWARE CONSULTING BURRIDGE COMPUTING
        1645 Sheely Drive 18 The Green South
        Fort Collins Warborough, Oxon
        CO 80526 USA OX10 7DN, ENGLAND
        Phone: 970-221-0438 Phone: +44 (0)1865 858279
        E-mail: davidf@dfanning.com E-mail: davidb@burridgecomputing.co.uk

Category

---

      Programming.

Calling Sequence

---

      CatSetDefault, name, value

Arguments

---

        name: A string by which this value will be "known" to the system.
        value: An IDL variable that will be associated with the defaultName.
                    Can be any type of IDL variable.

Keywords

---

        DESTROY_ON_CLEANUP: If this keyword is set, then the value is destoyed by calling
                      the UNDEFINE command, whenever the Catalyst object that stores the
                      value is destroy. Othersize, a simple storage location is provided,
                      and the storage object takes no interest whatsoever in the IDL variable
                      that is stored there. If this variable is a heap variable, or an IDL
                      variable containing a heap variable, you will be responsible for destroying
                      the variable, unless this keyword is set on initialization.

Modification History

---

      Written by: David Burridge, 12th March 2003