Create DFU Display File (CRTDFUDSPF)

The Control Language (CL) command CRTDFUDSPF creates a DFU display file.

Error messages for CRTDFUDSPF

None

Parameters

Keyword Description Choices Notes
FILE Display file Qualified object name Required, Positional 1
Qualifier 1: Display file Name
Qualifier 2: Library Name, *CURLIB
SRCFILE Source file Qualified object name Required, Positional 2
Qualifier 1: Source file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
SRCMBR Source member Name, *FILE Optional, Positional 3
AUTH Authority Name, *CHANGE, *ALL, *USE, *EXCLUDE Optional
REPLACE Replace *YES, *NO Optional
PRINT Print source listing *NO, *YES Optional
TEXT Text 'description' Character value, *SRCMBRTXT, *BLANK Optional

Display file (FILE)

Specifies the name of the DFU display file to be created. The name must be the same as that of the program DFU created when you saved the DDS source.

*CURLIB
Type *CURLIB to use your current library to store the display file when it is created. If no current library exists in the library list QGPL is used.
library-name
Type the name of the library into which you want to create the DFU display file. The library must be the same one into which you created the original DFU program.
display-device-file-name
Type the name of the display device file that is to be created. The display device file name must match the name of the program with which the original device file was created.

Source file (SRCFILE)

Specifies the name of the source file that contains the DDS source.

The possible values are:

source-file-name
Type the name of the source file that contains the DDS for this display device file.
*LIBL
DFU will use your library list to search for a specified source file.
*CURLIB
Type *CURLIB to use your current library to locate the source file. If no current library entry exists in the library list, QGPL is used.
library-name
Type the qualified name of the library where the source file is located.

Source member (SRCMBR)

Specifies the name of the member in the source file that contains the DDS for this DFU display file.

*FILE
DFU will use the name specified on the FILE parameter as the source file member name.
source-file-member-name
Type the name of the member that contains the DDS source.

Authority (AUTH)

Specifies the authority that you are giving to the display file.

The possible values are:

*LIBCRTAUT
Sets the public authority of the display file to the value specified in the CRTAUT parameter of the library when the display file is created. If the CRTAUT value for the library changes after the display file is created, the new value does not affect any existing objects in the library.
*CHANGE
Allows others to perform all operations on the display file except those limited to the owner or controlled by object existence authority or object management authority. Others can perform basic functions on the file. Change authority provides object operational authority and all data authority.
*ALL
Allows others to perform all operations on the display file except those limited to the owner or controlled by authorization list management authority. Others can control the file's existence, specify security for it, change the file, and so on. Others cannot transfer ownership of the file.
*USE
Allows others to perform basic operations such as reading the file. Others may not change the file.
*EXCLUDE
Prevents others from accessing the display file. Others have no authority.
authorization-list-name
You can specify the name of an authorization list whose authority is used for the display file.

Replace (REPLACE)

Specifies that a new display file is created when a display file of the same name already exists in the same library.

*YES
Leave *YES to replace the existing file and re-create the new file.

You must delete the original (before tailoring) DFU display file before you request to create the new one, if REPLACE is specified as *NO.

*NO
Type *NO if you do not want to replace the existing file.

Print source listing (PRINT)

Specifies to print the listing that is produced when the file is created.

*NO
Leave *NO if you do not want this list printed.
*YES
Type *YES to print a list of the source statements (DDS) used to create the display file. Any errors that occur will also be printed.

Text 'description' (TEXT)

Specifies a character string that briefly describes the display file and its function.

*SRCMBRTXT
DFU takes the text from the source file member that was used to create the display file.
*BLANK
No text is specified.
'description'
You may enter up to 50 characters, enclosed in apostrophes, to briefly describe the display file.

Examples

None

Error messages

None