ddsRegPostRefreshTrigger

ddsRegPostRefreshTrigger(
t_function
)
=> t / nil

Description

Registers a user-defined SKILL function that is called after completion of the Refresh command using CIW - File - Refresh or the ddsRefresh SKILL function.

The user-defined SKILL function is passed a tag value of 'cv or 'CDF to indicate that a list of database IDs has been provided to the function for the cellview or CDF IDs, respectively.

Arguments

t_function

Name of the SKILL callback function. The callback function has the following three arguments: g_type specifies the type of data being refreshed. Supported value: 'cv l_good lists IDs of the data that successfully refreshed successfully. l_bad lists IDs the data that failed to refresh.

Value Returned

t	The specified function is registered successfully.
nil	The operation failed.

Example

; Registers the function myRefreshCB, which is called after the Refresh command is complete. 

procedure( myRefreshCB( tag goodList badList )

   case( tag

       ('cv

           foreach( cv goodList

               info("**** %s %s %s was refreshed\n"

                   cv~>libName cv~>cellName cv~>viewName)

           )

           foreach( cv badList

               info("==== %s %s %s failed to refresh\n"

                   cv~>libName cv~>cellName cv~>viewName)

           )

       )

       (t

           info("**** Received unknown refresh tag - %L\n" tag)

       )

   )

)

ddsRegPostRefreshTrigger( "myRefreshCB" )

Related Topics

ddsRefresh

Return to top