Deciding what name/token level you need

To determine the level to use, consider the relationship between the code that creates the pair and the code that retrieves the pair:
  • If the retrieving code will be running under the same task as the creator's code, use the task level
  • If the retrieving code will have the same home address space but run under a different task or SRB, use the home level
  • If the retrieving code will be running in the same primary address space but run under a different task or SRB, use the primary level
    Note: This level is intended for code running with a primary address space different than the home address space (that is, a cross memory environment).
  • If the token will be retrieved by programs in many address spaces, use the system level.