|
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
xcall DD_TAG(dcs, DDTG_LIST, names_req, array, [start][, #names])
or
xcall DD_TAG(dcs, DDTG_INFO, name, tg_info)
Arguments
dcs
The repository control structure.
DDTG_LIST
Returns the current structure’s tag names.
names_req
The number of tag names requested. (d2)
array
Returned with the array of tag names. ((*)a30)
start
(optional) Contains the tag name at which to start. (a30)
#names
(optional) Returned with the number of tag names. (d2)
DDTG_INFO
Returns general tag information.
name
The unique tag name. (a30)
tg_info
Returned with the tag data. See the tg_info record definition in the ddinfo.def file.
Discussion
The DD_TAG subroutine returns information about tags for the current structure. There are two ways to call DD_TAG:
- DDTG_LIST enables you to retrieve the structure’s tag names.
- DDTG_INFO enables you to retrieve general information about a tag.
You must have previously set the current structure with the DD_STRUCT subroutine. The same DD_STRUCT call should also have told you the number of tags that exist.
DDTG_LIST
If you pass DDTG_LIST, the DD_TAG subroutine returns an array of tag names for the current structure. The names are returned in alphabetical order, starting with either the first name found or the specified name. DD_TAG returns as many tag names as are found or as are requested, whichever is smaller. The actual number of names in the array can be returned in #names.
You must ensure that the buffer passed is large enough to hold the number of names you are requesting.
DDTG_INFO
If you pass DDTG_INFO, this subroutine reads the specified tag. If that tag is not found, the relevant error code is returned in the control structure. If it is found, general tag information is returned in tg_info.
