Open topic with navigation
WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
xcall DD_FORMAT(dcs, DDM_INFO, name, type, format)
xcall DD_FORMAT(dcs, DDM_LIST, names_req, array, [start][, #names])
xcall DD_FORMAT(dcs, DDM_SINFO, sname, stype, sformat)
The repository control structure.
Returns general global or predefined format information.
The unique global or predefined format name. (a30)
Returned with the global format type. (a1)
Returned with the global format string. (a30)
Returns the current structure’s format names.
The number of structure‑specific format names requested. (d4)
Returned with the array of structure‑specific format names. ((*)a30)
(optional) Contains the structure‑specific format name at which to start. (a30)
(optional) Returned with the number of structure‑specific format names. (d4)
Returns general structure‑specific format information.
The structure‑specific format name. (a30)
Returned with the structure‑specific format type. (a1)
Returned with the structure‑specific format string. (a30)
The DD_FORMAT subroutine returns information about global, predefined, and structure‑specific format definitions. (Predefined formats are the date and time formats.) There are three ways to call DD_FORMAT:
You must have previously set the current structure with the DD_STRUCT subroutine to access information about structure‑specific formats. You should know the number of structure‑specific formats that exist from that same DD_STRUCT call.
If you pass DDM_INFO, this subroutine reads the specified global or predefined date or time format. (It searches for a predefined format first.) If that format is not found, the relevant error code is returned in the control structure. If it is found, information about the format is returned.
If you pass DDM_LIST, this subroutine returns an array of format names for the current structure. The names are returned in alphabetical order, starting with either the first name found or the specified name. DD_FORMAT returns either as many format names as it finds or as you request, depending on which is smaller. The actual number of names in the array can be returned in #names.
If you pass DDM_SINFO, this subroutine reads the specified structure‑specific format. If that format is not found, the relevant error code is returned in the control structure. If the format is found, information about the format is returned.