HP 3000 Manuals HP 3000 Manuals
SDGetPrimaryName
Retrieves the primary name of an entity.
Syntax
SDGetPrimaryName (Dcb,EntityType,Entity,PrimaryName,Status)
Parameter
Dcb Required input; type = DcbType
This parameter passes information about the
dictionary to this intrinsic. It is
initialized by the SDOpen intrinsic.
EntityType Required input; type = NameOrNumberType
This parameter specifies the entity type of the
entity whose primary name is to be retrieved.
Entity Required input; type = NameOrNumberType
This parameter specifies the entity whose
primary name is to be retrieved.
PrimaryName Output; type = NameType
This parameter returns the primary name of the
entity.
Status Output; type = StatusType
This parameter contains information indicating
the success or failure of the intrinsic call.
This information is detailed in Table Table
3-1, located in Chapter 3 of this manual.
If this intrinsic is successful, the Status
parameter contains the following information,
in addition to the description contained in
Table Table 3-1.
----------------------------------------------------------------------
| | |
| Bytes | Contain |
| | |
----------------------------------------------------------------------
| | |
| 17 - 20 | Internal entity number for the specified primary |
| | name |
| | |
----------------------------------------------------------------------
Discussion
The following restrictions apply when using this intrinsic:
1. Open mode--The dictionary must be opened in Shared Read mode,
Shared Read-Only mode, Shared Update mode, or Exclusive Update
mode.
2. Security--The current scope must be either the Dictionary
Administrator scope or a scope with Read access to the entity.