Element Name Considerations

The CDF2DDL utility will change the name of the elements it outputs under certain conditions. The names will be changed in the following cases:

Web Service element names that are too long
DDL object names are limited to 30 characters. If while converting a Web service element name to a DDL name, the resulting name is longer than 26 characters, the name will be truncated and a numeric sequence will be appended to the name.
Web service element name is a host language reserved word
If while converting a Web service element name to a DDL object name, the resulting name is the same as a host language reserved word, a 'Z' character is appended to the name.
A child element has the same name as the parent element
If a child element of a web service type has the same name as the type itself, the child element name is altered by appending a 'Z' character to the name

If any changes are made by the CDF2DDL utility, the changes are documented in the DDL source header. Sample documentation is shown below:

CODE

!                                                                              
! The following object names were altered to conform to DDL name              
! length restrictions.                                                        
!                                                                              
!   ThirdPartyProductDetailsItemCount -> ThirdPartyProductDetails01              
!                                                                              
!                                                                              
! The following object names were altered because they are reserved words      
! in one or more host languages.                                              
!                                                                              
!   page -> pagez                                                              
!   mode -> modez                                                              
!   type -> typez                                                              
!   sort -> sortz                                                              
!   Status -> Statusz                                                          
!   return -> returnz                                                          
!   author -> authorz                                                          
!                                                                              
!                                                                              
! The following child object names were altered because they were the          
! same as their parent definition name.                                        
!                                                                              
!   KeyPhrase -> KeyPhraseZ                                                    
!

To provide a DDL-compatible name that won't require changing by CDF2DDL, specify the 'ddlName' attribute on the <element> element in the CDF. For example:

CODE

<element name="ThirdPartyProductDetailsItemCount" type="unsignedNumeric" size="4"/>

produces this DDL:

CODE

02 ThirdPartyProductDetails01   PIC 9(4).

which, when output as COBOL, will look like this:

CODE

02 THIRDPARYPRODUCTDETAILS01    PIC 9(4).

whereas

CODE

<element name="ThirdPartyProductDetailsItemCount" type="unsignedNumeric" size="4" ddlName="THIRD-PARTY-PROD-DET-COUNT" />

produces this DDL:

CODE

02 THIRD-PARTY-PROD-DET-COUNT   PIC 9(4).

which, when output as COBOL, will look like this:

CODE

02 THIRD-PARTY-PROD-DET-COUNT   PIC 9(4).