Levels for name/token pairs
Name/token pairs have a level attribute associated with them. The
level defines the relationship of the creating program (that is, the
program that creates the name/token pair) to the retrieving program
(that is, the program that retrieves the data). Depending on the level
you select, the retrieving program can run under the same task as
the creating program, or in the same home address space, in the same
primary address space, or in the same system.
- A task-level name/token pair allows the creating program and the retrieving program to run under the same task.
- A home-address-space-level name/token pair allows the creating program and the retrieving program to run in the same home address space.
- A primary-address-space-level name/token pair allows the creating program and the retrieving program to run in the same primary address space.
- A system-level name/token pair allows the creating program and the retrieving program to run in the same system. That is, the two programs run in separate address spaces.
The various name/token levels allow for sharing data between programs
that run under a single task, between programs that run within an
address space, and between programs that run in different address
spaces. Some examples of using name/token levels are:
- Different programs that run under the same task can share data through the use of a task-level pair.
- Any number of tasks or SRBs that run within an address space can share data through use of an address-space-level pair.
- Programs that run in different address spaces can share data through the use of a system-level pair.