Create Console Display File (CRTS36RPGR)

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

The Create System/36 RPGR command (CRTS36RPGR) is used to create a CONSOLE display file.

Top

Parameters

Keyword Description Choices Notes
SRCMBR Source member Name Required, Positional 1
SRCFILE Source file Qualified object name Optional, Positional 2
Qualifier 1: Source file Name, QS36SRC
Qualifier 2: Library Name, *CURLIB
OUTLIB Output library Name, *CURLIB Optional, Positional 3
FMTSRCF File to receive S/36 formats Single values: *NONE
Other values: Qualified object name
Optional, Positional 4
Qualifier 1: File to receive S/36 formats Name, *SRCFILE
Qualifier 2: Library Name, *SRCLIB
FMTMBR Member to receive formats Name, *CRTDFT Optional, Positional 5
DDSSRCF File to receive DDS Single values: *NONE
Other values: Qualified object name
Optional
Qualifier 1: File to receive DDS Name, *SRCFILE
Qualifier 2: Library Name, *SRCLIB
DDSMBR Member to receive DDS Name, *CRTDFT Optional
GEN Generate console formats *YES, *NO Optional
REPLACE Replace output members *YES, *NO Optional
AUT Authority Name, *LIBCRTAUT, *ALL, *CHANGE, *USE, *EXCLUDE Optional
Top

Source member (SRCMBR)

Specifies the source member that contains the RPG II program specifications.

source-file-member-name
Enter the name of the member containing the source program.
Top

Source file (SRCFILE)

Specifies the file that contains the RPG II source member and the library that contains the file.

QS36SRC
Specifies the default file name.
source-file-name
Enter the name of the source file containing the source member.
*CURLIB
The current library will be used. If you have not specified a current library, #LIBRARY will be used.
library-name
Enter the name of the library in which the source file is stored.
Top

Output library (OUTLIB)

Specifies the library that contains the display format object member.

*CURLIB
The current library will be used. If you have not specified a current library, #LIBRARY will be used.
output-library-name
Enter the name of the library in which the object member will be stored.
Top

File to receive S/36 formats (FMTSRCF)

Specifies the file in which the member containing the S and D specifications will be stored and the library that will contain the file.

*SRCFILE
Uses the file name specified in the source file parameter (SRCFILE).
*NONE
Specifies that the S and D specifications will not be produced.
S&D-source-file-name
Enter the name of the file that will contain the S and D specifications.
*SRCLIB
Uses the same library that you specified in the source file library name (SRCFILE Parameter).
S&D-library-name
Enter the name of the library that will contain the S and D source file.
Top

Member to receive formats (FMTMBR)

Specifies the member that will contain the S and D specifications.

*CRTDFT
Uses the specified source member name (SRCMBR) with 'FM' added to the end of it.
S&D-member-name
Enter the name of the member that will contain the S and D specifications.
Top

File to receive DDS (DDSSRCF)

Specifies the file in which the member containing the DDS specifications will be stored and the library that will contain the file.

*SRCFILE
Uses the file name specified in the source file parameter (SRCFILE).
*NONE
Specifies that the DDS specifications will not be produced.
DDS-source-file-name
Enter the name of the source file that will contain the DDS member.
*SRCLIB
Uses the same library that you specified in the source file library name (SRCFILE Parameter).
DDS-library-name
Enter the name of the library that will contain the DDS source file.
Top

Member to receive DDS (DDSMBR)

Specifies the member that will contain the DDS specifications.

*CRTDFT
Uses the specified source member name (SRCMBR) with 'A' added to the end of it.
DDS-member-name
Enter the name of the member that will contain the DDS specifications.
Top

Generate console formats (GEN)

Specifies that the display formats for the CONSOLE file are to be created.

*YES
Specifies that display formats will be generated.
*NO
Specifies that display formats will not be generated.
Top

Replace output members (REPLACE)

Specifies whether or not a new CONSOLE display file is to be created if a file with the same name already exists in the specified library.

*YES
Specifies that a new CONSOLE display file will be created and any existing CONSOLE display file of the same name in the specified library will be deleted.
*NO
Specifies that a new CONSOLE display file will not be created if a member of the same name exists in the specified library.
Top

Authority (AUT)

Specifies what authority is granted for the program.

*LIBCRTAUT
The default public authority for created objects is taken from the CRTAUT keyword which is associated with the target library. The value is determined at create time. If the value of the CRTAUT keyword of the library changes after the create, the new value will not affect any existing objects.
*ALL
Complete authority for the program except for transferal of object ownership.
*CHANGE
All operations are permitted except those dealing with the object's existence and its management.
*USE
Permission to read or run the compiled program, but not to debug or to change it.
*EXCLUDE
No authority.
authorization-list
The name of the authorization list which secures the object. The public authority will be *AUTL.
Top

Examples

Example 1: Compiling a Source Program into a Program Object

CRTS36RPGR   SRCMBR(XMPLE1) SRCFILE(MYLIB/QS36SRC)
             OUTLIB(MYLIB)
             FMTSRCF(*SRCLIB/QS36DDSSRC) FMTMBR(*CRTDFT)
             DDSSRCF(*SRCLIB/QDDSSRC) DDSMBR(*CRTDFT)
             REPLACE(*YES)

This command creates a display file for a CONSOLE file from the RPG II source member XMPLE1. The name of the file will be the name in column 75 of the Control (H) specification in the RPG source, followed by FM. For example, if the Control specification contains XMPLE1 in columns 75-80, the display file will be named XMPLE1FM. Source member XMPLE1FM will be created in file MYLIB/QS36DDSSRC, containing System/36 Formats (S and D specifications). Source member XMPLE1A will be created in file MYLIB/QDDSSRC, containing the DSPF DDS source used to create the file MYLIB/XMPLE1FM.

Top

Error messages

None

Top