Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX Runtime Subroutine APIThese 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 the full list.
OverviewRelease 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 InformationAll 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 SubroutinesApplication Routines.BEGIN INITIAL SETUPChanges the current application to the 'Initial Setup' phase..BEGIN LIVE OPERATIONSChanges the current application to the 'Live Operations' phase..BEGIN RECOVERY PROCESSINGChanges the current application to the 'Recovery Processing' phase..SELECT DATABASESwitches to the specified database.Utility Routines.UTIL ADD USERAdds a user to the Appx User file..UTIL ADD HOOKAdds a record to the Hook file..UTIL CHECK SECURITYChecks the security code for the specified user..UTIL CHG AUX PASSChanges the Auxiliary password for the specified user..UTIL CHG HOOKChanges fields on the Hook File..UTIL CHG USERChanges fields on the Appx User File..UTIL CLEAR PASS LISTClears any unfilled PASS requests..UTIL COMPILE PROCCompiles the specified Process Type/Name or Application..UTIL DEL USERDeletes a user from the Appx User File..UTIL DEL HOOKDeletes a record from the Hook File..UTIL FIELD GETRetrieves the value of the specified field name..UTIL FIELD SETSets a value into the specified field name..UTIL GET EM NAMEFor a given Process Type/Name, returns the Em name..UTIL GET HOOK RECORDSCopies the engine Hook records into a temporary file for modification..UTIL LOAD STACK FILELoads --- STACK with the current process stack..UTIL MAKE DYNAMIC KEYNot Implemented.UTIL MOD SCROLL BEHAVThis subroutine allows the user to select a record on a scrolling display by just clicking it..UTIL PROCESS DDProcesses the Data Dictionary for the selected Application or File..UTIL PROCESS QRY RECWrites the current record to the Query pointer file..UTIL PUT HOOK RECORDSActivates the hooks in the temporary file..UTIL SLEEPPauses for the specified number of seconds..UTIL SLEEP WITH TIMERPauses for the specified number of seconds with a countdown timer..UTIL SWITCH USERChanges to a different user..UTIL TIMEOUT EXITExits or logout a user after a set timeout period..UTIL TIMEOUT SETSets the keyboard timeout value..UTIL UPDATE DOCUMENTUpdate process documentation via ILFWeb Processing Routines.IMPORT CGI DATAPopulates Appx Variables from STDIN.WIDGET Routines.WIDGET APPLY THEMEApplies a GUI Theme to the current image..WIDGET CNV CLR TO RGBConverts an alpha/hex color code to decimal..WIDGET CNV RGB TO CLRConverts a decimal color code to alpha/hex..WIDGET DEL BY NAMEDeletes selected widgets..WIDGET DEL MODE BTNDeletes the mode buttons from the toolbar..WIDGET DEL SCROLL BTNDeletes the scroll buttons from the toolbar..WIDGET DEL STD MENUSDeletes the standard pull down menus..WIDGET HIDE BY NAMEHides selected widgets..WIDGET HIDE MODE BTNHides the mode buttons on the toolbar..WIDGET HIDE SCROL BTNHides the scroll buttons on the toolbar..WIDGET HIDE STD MENUSHides the standard pull down menus..WIDGET MISSING THEMEFinds all Inputs/Menus that do not use .WIDGET APPLY THEME..WIDGET SET FROM MWDGTCopies the memory file to --- WIDGET..WIDGET SET INTO MWDGTCopies the current --- WIDGET file to a memory file..WIDGET SET THEMESets the current Theme Name..WIDGET SHOW BY NAMEShows previously hidden widgets..WIDGET SHOW MODE BTNShows previously hidden mode buttons on the toolbar..WIDGET SHOW SCROL BTNShows previously hidden scroll buttons on the toolbar..WIDGET SHOW STD MENUSShows the previously hidden standard pull down menus..WIDGET VIEW RUNTIMEShows properties of the current --- WIDGET file.Data Manipulation SubroutinesConversion Routines.CONVERT BYTES TO HEXConverts a field to hexadecimal characters..CONVERT HEX PR TO NUMConverts a hex pair of alpha characters to a decimal number..CONVERT NUM TO HEX PRConverts a decimal number to a hex pair of alpha characters..CONVERT SPLIT NUMBERSplits a number into its whole and fractional parts..CONVERT TEXT TO HTMLConverts a text field to HTML encoding.CONVERT TRANSLATEConverts a string from one language to another.Text Routines.TEXT CREATE PADFills a field with a single character..TEXT CUT AT POSRemoves characters from a text/alpha field..TEXT FINDFind the position of text in a text/alpha field..TEXT FIND AND REPLACEFind and replace text in a text/alpha field..TEXT GET LENGTHDetermine the length of a text/alpha field..TEXT INSERT AT POSInserts characters into a text/alpha field..TEXT LOWER TO UPPERConvert lower case to upper case in a text/alpha field..TEXT PARSE LINEParse a string into separate fields..TEXT UPPER TO LOWERConvert upper case to lower case in a text/alpha field.System Information SubroutinesServer Environment Routines.ENV GET APPXPATHReturns the path to the location of Appx data files..ENV GET CMD LINE PARMReturns the value of a command line parameter..ENV GET CONFIG INFOPopulates PDF fields with configuration information..ENV GET ENV VARIABLEReturns the value of an environment variable..ENV GET OS TYPEReturn the type of operating system Appx is running on..ENV GET PARENT PROCReturns the name and type of the parent process..ENV GET PATH NAMEReturns the pathname of the requested APPX data file..ENV GET PATH SEPReturns the directory separator character of the host operating system..ENV GET SCREEN SIZEReturns the size of the Appx screen in rows and columns..ENV SET ENV VARIABLESets the value of an environment variable (not yet implemented)..ENV VIEW LICENSE INFODisplays the APPX license info for the current application.Client Routines.CLIENT CHECK FOR GUIReturns a flag to indicate if the user is running the Desktop Client..CLIENT CHECK VERSIONReturns the version of the Desktop Client..CLIENT DOWNLOAD FILEDownloads a file to the user's PC..CLIENT GET CLIPBOARDGets the current content of the system clipboard..CLIENT GET CONSTANTReturns the value of a client constant.CLIENT LOAD URLLoads a URL, document, runs a command on the user's PC or changes a client setting..CLIENT PLAY SOUNDPlays a .wav file on the user's PC..CLIENT SET CLIPBOARDPuts data on the system clipboard..CLIENT UPLOAD FILEUploads a file from the Client to the server.File System Utilities SubroutinesFile Manipulation RoutinesThese 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)..FILE COPYCopies a file from one location to another, creating any required directories..FILE CREATECreates the specified file..FILE CREATE ARCHIVECreates an archive of the specified files, in either TAR or TGZ format..FILE DELETEDeletes the given file from the filesystem..FILE EXISTSTests for the existence of the given file in the filesystem..FILE EXTRACT ARCHIVEExtracts all the files from a previously created archive..FILE MAKE DIRCreates the given directory and parent directories in the filesystem..FILE MOVEMoves a file or directory from one location to another, creating any required directories.FILE RESTRUCTRestructures the specified file. | ||||||||
Changed: | ||||||||
< < | .FILE SPLIT FILENAME | |||||||
> > | .FILE SPLIT FILENAME | |||||||
Splits the filename from the file extension and returns both. | ||||||||
Changed: | ||||||||
< < | .FILE SPLIT PATHNAME | |||||||
> > | .FILE SPLIT PATHNAME | |||||||
Splits the filename from the path and returns both.
Stream File RoutinesThe stream routines provide a way to work directly with text files, or to get the standard output of a command (via pipes)..STREAM CLOSECloses a file stream and frees up the stream resources for that file..STREAM CLOSE ALLCloses all file streams and frees up the stream resources for those files..STREAM OPENOpens a stream to the given file creating the file and path as needed..STREAM READRead data from the given stream..STREAM WRITEWrite data to the given stream. -- PeteBrower - 2011-08-12 \ No newline at end of file |