Set Application Default Entry (CHGAPPDFT)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Set Application Default Entry (CHGAPPDFT) command Changes or creates an entry in a previously specified Application defaults file (create by the CRTDFTFILE command). The entry can be retrieved using the Application Defaults functions provided in the RPG IV *SRVPGM COZAPPDFT or by using the RTVAPPDFT CL command. Application Defaults are stored in a database file. The purpose it to allow applications to either customize their interface for specific users or to save settings for the next time the application is run. For example, you could save the OUTPUT QUEUE where the application creates its output between calling the program so the end-user doesn't need to constantly set it to a different output queue.

Top

Parameters

Keyword Description Choices Notes
NAME Default Name Name Required, Positional 1
VALUE New value Not restricted Required, Positional 2
DFTFILE Applications Defaults file Single values: *SYS
Other values: Qualified object name
Optional, Positional 3
Qualifier 1: Applications Defaults file Name, *USER
Qualifier 2: Library Name, *CURLIB, *LIBL
Top

Default Name (NAME)

Specifies the application defaults entry name. Names may be up to 32 character in length--upper/lower case is ignored when retrieving or changing the entry name, however the name is stores as it is specified.

This is a required parameter.

name
Specify the name of application default entry being modified.
Top

New value (VALUE)

Specifies the value assigned to the application defaults entry name. Entry values may be up to 64 characters in length.

This is a required parameter.

unrestricted-value
Specify the entry value. Any literal or CL variable may be specified.
Top

Applications Defaults file (DFTFILE)

Specifies the application defaults file where the entry is stored. the default value is *USER meaning the COZTOOLS User File COZAPPDFT is located on the library list and used as the applications defaults file. However, any file created using the CRTDFTFILE command may be specified. NOTE: In order to view this parameter while prompting this command, you must press the F10 key, or select "All parameters" if prompting through the web interface.

Single values

*SYS
The internal system application defaults file is used. This is for COZTOOLS application-use only and is refreshed whenever COZTOOLS is updated.

Qualifier 1: Applications Defaults file

*USER
The file COZAPPDFT is located on the library list and used as the application defaults name.
name
Specify the name of a file created by the CRTDFTFILE CL command.
Top

Examples

None
Top

Error messages

Unknown
Top