Skip to main content
Omnitracs Knowledge Base

Refresh Local Macro Template Definitions API

The IIMACRFSH CL-based API provides a low-touch, on-demand macro template synchonization mechanism, which can be directly called from a command line or submitted to batch. The utility works as follows...

  • Initialization & Re-synchronization - All the toolkit's local macro template definitions may be initialized as part of the toolkit's post installation initialization (or anytime for that matter) by calling the new IIMACRFSH utility. The utility will call a web service to retrieve the list of all the customer's macros currently defined on the portal and then another web service to retrieve the macro template definition details for each one before storing them locally in the toolkit's database.
  • Ad Hoc - If desired, the utility may also be used at any time to synchronize the template for a single specific macro, although this is not expected to be a common use case.

The calling interface for the utility is as follows:


API Name: IIMACRFSH

Parameter Interface:

 

Parameter

 

 

Direction

 

 

Type

 

 

Length

 

 

Precision

 

 

Description

 

Macro Direction

Input

Character

1

n/a

"F" = Forward, 'R" = Return, "A" = All (forward and return)

Macro Number

Input

Character

2

n/a

Macro number "1" to "63" or "0" if macro direction "A" (All) specified

Completion Status String

Output

Character

200

n/a

Blank if successful or error string if failure encountered

  • Was this article helpful?