APPXRuntimeSubroutineAPI < Main

Tags: view all tags
---+ APPX Runtime Subroutine API

_These APIs can be used by an APPX designer to interact with the APPX Runtime Application (---) to gain access to extra functionality. This page only lists the APIs that were introduced in Release 5.1. For a list of all APIs in the current release, go to [[FullAPIList][the full list]]._

<br />%TOC%

---++ 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. This API replaces the older subroutines that have been informally used, and all designers are encouraged to begin using the new subroutines.
---+++ 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 results 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 as the subroutine. This failure code field is tokenized so you can scan to see the failure reasons that can be returned. Note that the work field has a scope of 'Detached', and so will retain it's value from invocation to invocation, as well as across all invocation types.

If the subroutine accepts parameters (i.e., READ, WRITE, APPEND to --- .STREAM OPEN), the parameters are case insensitive.

If the subroutine has required parameters and you do not PASS the correct number of parameters, the subroutine will issue a CANCEL identifying which parameter was missing.

---++ General Subroutines
---+++ Application Routines
---++++ [[0LASubrAppBeginInitialSetup][.BEGIN INITIAL SETUP]]

Changes the current application to the 'Initial Setup' phase.
---++++ [[0LASubrAppBeginLiveOpn][.BEGIN LIVE OPERATIONS]]

Changes the current application to the 'Live Operations' phase.
---++++ [[0LASubrAppBeginRecovery][.BEGIN RECOVERY PROCESSING]]

Changes the current application to the 'Recovery Processing' phase.
---++++ [[0LASubrAppSelectDatabase][.SELECT DATABASE]]

Switches to the specified database.
---+++ 
---+++ Utility Routines
---++++ [[0LASubrUtilAddUser][.UTIL ADD USER]]

Adds a user to the Appx User file.
---++++ [[0LASubrUtilAddHook][.UTIL ADD HOOK]]

Adds a record to the Hook file.
---++++ [[0LASubrUtilCheckSecurity][.UTIL CHECK SECURITY]]

Checks the security code for the specified user.
---++++ [[0LASubrUtilChgAuxPass][.UTIL CHG AUX PASS]]

Changes the Auxiliary password for the specified user.
---++++ [[0LASubrUtilChgHook][.UTIL CHG HOOK]]

Changes fields on the Hook File.
---++++ [[0LASubrUtilChgUser][.UTIL CHG USER]]

Changes fields on the Appx User File.
---++++ [[0LASubrUtilClearPassList][.UTIL CLEAR PASS LIST]]

Clears any unfilled PASS requests.
---++++ [[0LASubrUtilCompileProc][.UTIL COMPILE PROC]]

Compiles the specified Process Type/Name or Application.
---++++ [[0LASubrUtilDelUser][.UTIL DEL USER]]

Deletes a user from the Appx User File.
---++++ [[0LASubrUtilDelHook][.UTIL DEL HOOK]]

Deletes a record from the Hook File.
---++++ [[0LASubrUtilFieldGet][.UTIL FIELD GET]]

Retrieves the value of the specified field name.
---++++ [[0LASubrUtilFieldSet][.UTIL FIELD SET]]

Sets a value into the specified field name.
---++++ [[0LASubrUtilGetEmName][.UTIL GET EM NAME]]

For a given Process Type/Name, returns the Em name.

---++++ [[0LASubrUtilGetHookRecords][.UTIL GET HOOK RECORDS]]

Copies the engine Hook records into a temporary file for modification.

---++++ [[0LASubrUtilLoadStackFile][.UTIL LOAD STACK FILE]]

Loads --- STACK with the current process stack.

---++++ [[0LASubrUtilMakeDynamicKey][.UTIL MAKE DYNAMIC KEY]]

Not Implemented
---++++ [[0LASubrUtilModeScrollBehav][.UTIL MOD SCROLL BEHAV]]

This subroutine allows the user to select a record on a scrolling display by just clicking it.
---++++ [[0LASubrUtilProcssDd][.UTIL PROCESS DD]]

Processes the Data Dictionary for the selected Application or File.
---++++ [[0LASubrUtilProcssQueryRec][.UTIL PROCESS QRY REC]]

Writes the current record to the Query pointer file.

---++++ [[0LASubrUtilPutHookRecords][.UTIL PUT HOOK RECORDS]]

Activates the hooks in the temporary file.

---++++ [[0LASubrUtilSleep][.UTIL SLEEP]]

Pauses for the specified number of seconds.

---++++ [[0LASubrUtilSleepWithTimer][.UTIL SLEEP WITH TIMER]]

Pauses for the specified number of seconds with a countdown timer.
---++++ [[0LASubrUtilSwitchUser][.UTIL SWITCH USER]]

Changes to a different user.
---++++ [[0LASubrUtilTimeoutExit][.UTIL TIMEOUT EXIT]]

Exits or logout a user after a set timeout period.
---++++ [[0LASubrUtilTimeoutSet][.UTIL TIMEOUT SET]]

Sets the keyboard timeout value.
---++++ [[0LAUtilUpdateDocument][.UTIL UPDATE DOCUMENT]]

Update process documentation via ILF
---+++ Web Processing Routines
---++++ [[0LASubrImportCgiData][.IMPORT CGI DATA]]

Populates Appx Variables from STDIN.
---+++ WIDGET Routines
---++++ [[0LASubrWidgetApplyTheme][.WIDGET APPLY THEME]]

Applies a GUI Theme to the current image.
---++++ [[0LASubrWidgetCnvClrToRgb][.WIDGET CNV CLR TO RGB]]

Converts an alpha/hex color code to decimal.
---++++ [[0LASubrWidgetCnvRgbToClr][.WIDGET CNV RGB TO CLR]]

Converts a decimal color code to alpha/hex.
---++++ [[0LASubrWidgetDelByName][.WIDGET DEL BY NAME]]

Deletes selected widgets.
---++++ [[0LASubrWidgetDelModeBtn][.WIDGET DEL MODE BTN]]

Deletes the mode buttons from the toolbar.
---++++ [[0LASubrWidgetDelScrollBtn][.WIDGET DEL SCROLL BTN]]

Deletes the scroll buttons from the toolbar.
---++++ [[0LASubrWidgetDelStdMenus][.WIDGET DEL STD MENUS]]

Deletes the standard pull down menus.
---++++ [[0LASubrWidgetHideByName][.WIDGET HIDE BY NAME]]

Hides selected widgets.
---++++ [[0LASubrWidgetHideModeBtn][.WIDGET HIDE MODE BTN]]

Hides the mode buttons on the toolbar.
---++++ [[0LASubrWidgetHideScrolBtn][.WIDGET HIDE SCROL BTN]]

Hides the scroll buttons on the toolbar.
---++++ [[0LASubrWidgetHideStdMenus][.WIDGET HIDE STD MENUS]]

Hides the standard pull down menus.
---++++ [[0LASubrWidgetMissingTheme][.WIDGET MISSING THEME]]

Finds all Inputs/Menus that do not use .WIDGET APPLY THEME.
---++++ [[0LASubrWidgetSetFromMwdgt][.WIDGET SET FROM MWDGT]]

Copies the memory file to --- WIDGET.
---++++ [[0LASubrWidgetSetIntoMwdgt][.WIDGET SET INTO MWDGT]]

Copies the current --- WIDGET file to a memory file.
---++++ [[0LASubrWidgetSetTheme][.WIDGET SET THEME]]

Sets the current Theme Name.
---++++ [[0LASubrWidgetShowByName][.WIDGET SHOW BY NAME]]

Shows previously hidden widgets.
---++++ [[0LASubrWidgetShowModeBtn][.WIDGET SHOW MODE BTN]]

Shows previously hidden mode buttons on the toolbar.
---++++ [[0LASubrWidgetShowScrolBtn][.WIDGET SHOW SCROL BTN]]

Shows previously hidden scroll buttons on the toolbar.
---++++ [[0LASubrWidgetShowStdMenus][.WIDGET SHOW STD MENUS]]

Shows the previously hidden standard pull down menus.
---++++ [[0LASubrWidgetViewRuntime][.WIDGET VIEW RUNTIME]]

Shows properties of the current --- WIDGET file.
---++ Data Manipulation Subroutines
---+++ Conversion Routines
---++++ [[0LASubrConvertBytesToHex][.CONVERT BYTES TO HEX]]

Converts a field to hexadecimal characters.
---++++ [[0LASubrConvertHexPrToNum][.CONVERT HEX PR TO NUM]]

Converts a hex pair of alpha characters to a decimal number.
---++++ [[0LASubrConvertNumToHexPr][.CONVERT NUM TO HEX PR]]

Converts a decimal number to a hex pair of alpha characters.
---++++ [[0LASubrConvertSplitNumber][.CONVERT SPLIT NUMBER]]

Splits a number into its whole and fractional parts.

---++++ [[0LASubrConvertTextToHtml][.CONVERT TEXT TO HTML]]

Converts a text field to HTML encoding

---++++ [[0LASubrConvertTranslate][.CONVERT TRANSLATE]]

Converts a string from one language to another.
---+++ Text Routines
---++++ [[0LASubrTextCreatePad][.TEXT CREATE PAD]]

Fills a field with a single character.
---++++ [[0LASubrTextCutAtPos][.TEXT CUT AT POS]]

Removes characters from a text/alpha field.
---++++ [[0LASubrTextFind][.TEXT FIND]]

Find the position of text in a text/alpha field.
---++++ [[0LASubrTextFindAndReplace][.TEXT FIND AND REPLACE]]

Find and replace text in a text/alpha field.
---++++ [[0LASubrTextGetLength][.TEXT GET LENGTH]]

Determine the length of a text/alpha field.
---++++ [[0LASubrTextInsertAtPos][.TEXT INSERT AT POS]]

Inserts characters into a text/alpha field.
---++++ [[0LASubrTextLowerToUpper][.TEXT LOWER TO UPPER]]

Convert lower case to upper case in a text/alpha field.
---++++ [[0LASubrTextParseLine][.TEXT PARSE LINE]]

Parse a string into separate fields.
---++++ [[0LASubrTextUpperToLower][.TEXT UPPER TO LOWER]]

Convert upper case to lower case in a text/alpha field.
---++ System Information Subroutines
---+++ Server Environment Routines
---++++ [[0LASubrEnvGetAppxpath][.ENV GET APPXPATH]]

Returns the path to the location of Appx data files.

---++++ [[0LASubrEnvGetCmdLineParm][.ENV GET CMD LINE PARM]]

Returns the value of a command line parameter.

---++++ [[0LASubrEnvGetConfigInfo][.ENV GET CONFIG INFO]]

Populates PDF fields with configuration information.

---++++ [[0LASubrEnvGetEnvVariable][.ENV GET ENV VARIABLE]]

Returns the value of an environment variable.

---++++ [[0LASubrEnvGetOsType][.ENV GET OS TYPE]]

Return the type of operating system Appx is running on.

---++++ [[0LASubrEnvGetParentProc][.ENV GET PARENT PROC]]

Returns the name and type of the parent process.

---++++ [[0LASubrEnvGetPathName][.ENV GET PATH NAME]]

Returns the pathname of the requested APPX data file.
---++++ [[0LASubrEnvGetPathSep][.ENV GET PATH SEP]]

Returns the directory separator character of the host operating system.

---++++ [[0LASubrEnvGetScreenSize][.ENV GET SCREEN SIZE]]

Returns the size of the Appx screen in rows and columns.

---++++ [[0LASubrEnvSetEnvVariable][.ENV SET ENV VARIABLE]]

Sets the value of an environment variable (not yet implemented).

---++++ [[0LASubrEnvViewLicenseInfo][.ENV VIEW LICENSE INFO]]

Displays the APPX license info for the current application.
---+++ Client Routines

---++++ [[0LASubrClientCheckForGui][.CLIENT CHECK FOR GUI]]

Returns a flag to indicate if the user is running the Desktop Client.

---++++ [[0LASubrClientCheckVersion][.CLIENT CHECK VERSION]]

Returns the version of the Desktop Client.

---++++ [[0LASubrClientDownloadFile][.CLIENT DOWNLOAD FILE]]

Downloads a file to the user's PC.

---++++ [[0LASubrClientGetClipboard][.CLIENT GET CLIPBOARD]]

Gets the current content of the system clipboard.

---++++ [[0LASubrClientGetConstant][.CLIENT GET CONSTANT]]

Returns the value of a client constant

---++++ [[0LASubrClientLoadUrl][.CLIENT LOAD URL]]

Loads a URL, document, runs a command on the user's PC or changes a client setting.

---++++ [[0LASubrClientPlaySound][.CLIENT PLAY SOUND]]

Plays a .wav file on the user's PC.

---++++ [[0LASubrClientSetClipboard][.CLIENT SET CLIPBOARD]]

Puts data on the system clipboard.

---++++ [[0LASubrClientUploadFile][.CLIENT UPLOAD FILE]]

Uploads a file from the Client to the server.

---++ File System Utilities Subroutines
---+++ File Manipulation Routines

These subroutines provide you with a way to manipulate files on the file system without having to check the O/S type (i.e., using 'cp' vs 'copy', or different kernel calls).
---++++ [[0LASubrFileCopy][.FILE COPY]]

Copies a file from one location to another, creating any required directories.
---++++ [[0LASubrFileCreate][.FILE CREATE]]

Creates the specified file.
---++++ [[0LASubrFileCreateArchive][.FILE CREATE ARCHIVE]]

Creates an archive of the specified files, in either TAR or TGZ format.
---++++ [[0LASubrFileDelete][.FILE DELETE]]

Deletes the given file from the filesystem.
---++++ [[0LASubrFileExists][.FILE EXISTS]]

Tests for the existence of the given file in the filesystem.
---++++ [[0LASubrFileExtractArchive][.FILE EXTRACT ARCHIVE]]

Extracts all the files from a previously created archive.
---++++ [[0LASubrFileMakeDir][.FILE MAKE DIR]]

Creates the given directory and parent directories in the filesystem.

---++++ [[0LASubrFileMove][.FILE MOVE]]

Moves a file or directory from one location to another, creating any required directories
---++++ [[0LASubrFileRestruct][.FILE RESTRUCT]]

Restructures the specified file.
---++++ [[0LASubrFileSplitFilename][.FILE SPLIT FILENAME]]

Splits the filename from the file extension and returns both.
---++++ [[0LASubrFileSplitPathname][.FILE SPLIT PATHNAME]]

Splits the filename from the path and returns both.
---+++ Stream File Routines

The stream routines provide a way to work directly with text files, or to get the standard output of a command (via pipes).
---++++ [[0LASubrStreamClose][.STREAM CLOSE]]

Closes a file stream and frees up the stream resources for that file.
---++++ [[0LASubrStreamCloseAll][.STREAM CLOSE ALL]]

Closes all file streams and frees up the stream resources for those files.
---++++ [[0LASubrStreamOpen][.STREAM OPEN]]

Opens a stream to the given file creating the file and path as needed.
---++++ [[0LASubrStreamRead][.STREAM READ]]

Read data from the given stream.
---++++ [[0LASubrStreamWrite][.STREAM WRITE]]

Write data to the given stream.

-- Main.PeteBrower - 2011-08-12
Topic revision: r59 - 2021-05-07 - MisaghKarimi