DD_TAG

Retrieve tag information

WSupported on Windows
USupported on Unix
VSupported on OpenVMS
NSupported in Synergy .NET
xcall DD_TAG(dcs, DDTG_LIST, names_req, array, [start][, #names])

or

xcall DD_TAG(dcs, DDTG_INFO, name, tg_info)

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.

The DD_TAG subroutine returns information about tags for the current structure. There are two ways to call DD_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.