Application Commands Overview

Reference:

This topic lists the platform-independent application (APP) commands that enable you to control the application environment.

You can use the following wildcard characters in the file name and file type references for the APP commands COPYFILE, MOVEFILE, DELETEFILE, and RENAMEFILE.

Reference: APP Commands Quick Reference

Click any command in the following charts to access detailed information, including the required syntax.

Search Path Management Commands

Command

Description

APP PATH

Sets or resets the application search path.

APP PREPENDPATH

Temporarily adds application names to the beginning of an existing APP PATH search path.

APP APPENDPATH

Temporarily adds application names to the end of an existing APP PATH search path.

APP MAP

Defines a virtual application that points to a physical location outside of the approot structure. This command makes the virtual application available for addition to the search path. It does not automatically add it to the APP PATH.

APP SET METALOCATION_SAME

Indicates whether corresponding Master and Access files must be in the same application directory.

APP ? METALOCATION_SAME

Retrieves the value of APP SET METALOCATION_SAME.

APP SHOWPATH

Lists all the currently active applications in the search path.

Application Management Commands

Command

Description

APP COPY

Copies the contents of one application to a second application.

APP CREATE

Creates an application under the approot location.

APP DELETE

Deletes an application.

APP MOVE

Moves the contents of one application to a second application.

APP PROPERTY CODEPAGE

Specifies a code page for files in an application.

APP RENAME

Renames an application.

File Management Commands

Command

Description

APP COPYF[ILE]

*Copies a single component or component type from one application to another.

APP MOVEF[ILE]

*Moves a single component or component type from one application to another.

APP RENAMEF[ILE]

*Renames a single component or component type in an application.

APP DELETEF[ILE]

*Deletes a single component or component type from an application.

* The shortened form of the APP commands is used in the remainder of this document.

Output Redirection Commands

Command

Description

APP HOLD

Controls where output files are created for any HOLD, SAVE, SAVB, or APP QUERY HOLD process in the application, unless a FILEDEF command has been used to allocate data files.

APP HOLDDATA

Designates an application as the location for temporary data files created with the HOLD, SAVE, or SAVB command.

APP HOLDMETA

Designates an application as the location for temporary Master and Access Files created with the HOLD command.

APP FI[LEDEF]

This command has been deprecated and aliased to FILEDEF.

Help Commands

Command

Description

APP HELP

Displays a list of APP commands with a brief description of each.

Reference: Application Metadata Commands and Metadata Tables

Click any command in the following chart to access detailed information, including the required syntax.

Command

Description

STATEapp/file.extension

Check file existence

APP LIST app [HOLD]

Lists the applications under approot.

If the HOLD option is used, it lists the applications under approot and writes the output to a temporary file called focappl.ftm, which you can then use in a report request.

APP QUERY app [HOLD]

Lists all files in the application.

If the HOLD option is used, it lists all files in the application and writes the output to a temporary file called focappq.ftm, which you can then use in a report request.

catalog/sysfiles

Table, list of accessible app name objects on path for a given type (default MASTER).

catalog/sysdirs

Table, recursive list of physical files under a physical directory.

catalog/sysapps

Table, metadata for physical objects on path.

catalog/systables

Table, app name of tables (and related metadata) on path.


Information Builders