Invalid syntax for Script Function CREATE_OBJECT Variable in documentation

Products

• CA Automic Workload Automation - Automation Engine

Issue/Introduction

Error Message :
U00020619 Runtime error in object 'SCRI.CREATE_VAR', line '00001': Attribute 'STATIC' not valid!

The Variable section in the documentation that describes using the Script Function CREATE_OBJECT contains an invalid “Description/Format” for the “Object Type” Syntax.
 
Invalid Object Type Description/Format:
 
Syntax
CREATE_OBJECT(Object Type, Object Name, [Folder], [Title], [Error Handling], [Data Type], [Validity])

Syntax	Description/Format
Object Type	Short Label of the object type Allowed value:  STATIC, XML   To create a static Variable object of the type XML, enter its short name.

 
Correct Object Type Description/Format:

Syntax
CREATE_OBJECT(Object Type, Object Name, [Folder], [Title], [Error Handling], [Data Type], [Validity], [Variable Type])
 

Syntax	Description/Format
Object Type	Short Label of the object type Allowed value:  VARA   To create a static Variable object of the type XML, enter its short name.
Variable Type	Parameter to define the type of Variable object you want to create. (optional)   Allowed values: “STATIC” or “XML” Default value:  “STATIC”

NOTE:  An additional variable has been added after [Validity] called [Variable Type] to allow an optional parameter of XML or STATIC to be set.  STATIC will be the default value, if the parameter is not set.
 
Investigation

Using the invalid syntax:

 CREATE_OBJECT(Object Type, Object Name, [Folder], [Title], [Error Handling], [Data Type], [Validity]) 

1. Run a command similar to this:

:SET &RET# = CREATE_OBJECT("STATIC","OUTPUT.XML.VARA","SUPPORT/INC0011XXXX/INC00119XXX/INC00119636","test xml vara","I","F","FREE") 
 

2. An error message similar to the one above will be displayed.  
 

References
 

Automation Engine 11 Documentation

Automation Engine Script Guide > Ordered by Function > Handle Objects > CREATE_OBJECT

Automation Engine 12 Documentation

Automation Engine Script Guide > Ordered by Function > Handle Objects > CREATE_OBJECT
 

Environment

OS Version: N/A

Cause

Cause type:
Defect
Root Cause: Online documentation contains incorrect syntax for how to use the object type variables in the Script Function CREATE_OBJECT

Resolution

Update to a fix version listed below or a newer version if available.

Fix Status: Released

Fix Version(s):
Automation.Engine 12.1.0 - Available
Automation Engine 12.0.1 - Available
Automation Engine 11.2.3 – Available

Additional Information

Workaround :
For static VARA : use "VARA" as the object type similar to this:
 

:SET &RET# = CREATE_OBJECT("VARA","OUTPUT.XML.VARA","SUPPORT/INC0011XXXX/INC00119XXX/INC00119636","test xml vara","I","F","FREE")