APPX Runtime Subroutine API

This API can be used by an APPX designer to interact with the APPX Runtime Application (---) to gain access to extra functionality.

Overview

Release 5.1.0 of the APPX Utility includes a new standardized designer API which can be used to gain access to extended functionality from within an APPX application. This API provides APPX Designers with a robust set of subroutines which can be called to do a variety of tasks.

General Information

All of these new subroutines are defined in the (---) application and begin with a period (.). They all use a standard call interface and use the same framework for returning resuts and reporting errors. They are grouped by name prefix so that related subroutines are grouped together by function. Data is passed into and returned from these subroutines by use of the PASS statement. Failure information is returned by use of a work field with the same name os the subroutine. This failure code field is tokenized so ou can scan to see the failure reasons that can be returned.

Data Manipulation Subroutines

Conversion Routines

.CONVERT HEX PR TO NUM

Convert a hex pair of alpha characters to a decimal number.

.CONVERT NUM TO HEX PR

Convert a decimal number to a hex pair of alpha characters.

.CONVERT SPLIT NUMBER

Split a number into it's whole and fractional parts.

System Information Subroutines

Server Environment Routines

.ENV GET OS TYPE

Return the type of operating system Appx is running on.

.ENV GET PATH SEPERATR

Return the directory seperator character of the host operating system.

-- PeteBrower - 2011-08-12