Defining Functions › Function Types, Message Types, and Function Fields › CRTOBJ Database Function

CRTOBJ Database Function

The Create Object (CRTOBJ) function defines a routine to add a record to a database file. The CRTOBJ function includes the processing to check that the record does not already exist prior to being written to the database. There are no device files associated with the CRTOBJ function; however, it does have action diagram user points.

A CRTOBJ function is provided by default for every database file. All CRTOBJ functions are attached to an Update (UPD) access path, or can be attached to a Physical (PHY) path.

Note: For more information on PHY, see the section Internal Database Functions and PHY Access Paths

The following table shows the parameters available.

The following table shows the function options available.

All fields from the UPD access path must be declared as parameters to the CRTOBJ function. To exclude certain fields from being written, you should specify them as Neither parameters. These fields are not automatically initialized. If you use Neither parameters, you should initialize the fields with blank or zero.

If the UPD access path to which the CRTOBJ function is attached does not contain all of the fields in the based-on file, the missing fields are set to blank or zero. You can change this by specifying a value on the Default Condition field of the Edit Field Details panel.

For more information on user points, see the chapter, "Modifying Action Diagrams."