Create S/36 Display File (CRTS36DSPF)

The Create System/36 Display File (CRTS36DSPF) command creates a display file from a System/36 source file and adds, deletes, or updates formats in existing display files. Using the TOFILE and TOMBR parameters, you can convert the System/36 SFGR source to data description specifications (DDS) source.

Note: The data description specifications (DDS) source is saved in the DDS source file QS36DDSSRC, in the same library as the display file. If the QS36DDSSRC source file does not exist, this source file is created with a record length of 92.

Restriction: Option 5 of the operating system must be installed to run this command. This command can be run either natively or in the System/36 environment.

Parameters

Keyword	Description	Choices	Notes
DSPFILE	Display file	Qualified object name	Optional, Positional 1
	Qualifier 1: Display file	Name
	Qualifier 2: Library	Name, *CURLIB
OPTION	Option	Single values: CREATE Other values (up to 32 repetitions): UPDATE, ADD, DELETE	Optional, Positional 2
SRCMBR	S/36 SFGR source member	Single values: DSPFILE Other values (up to 32 repetitions): Name*	Optional, Positional 3
SRCFILE	S/36 source file	Qualified object name	Optional, Positional 4
	Qualifier 1: S/36 source file	Name, QS36SRC
	Qualifier 2: Library	Name, LIBL, CURLIB
REPLACE	Replace display file	NO, YES	Optional
PRINT	Print SFGR listing	YES, NO, *PARTIAL	Optional
MAXDEV	Maximum devices	1-256, *SRCATR	Optional
AUT	Authority	Name, USE, ALL, CHANGE, EXCLUDE, *LIBCRTAUT	Optional
GENOPT	Generation option	GEN, NOGEN, *CONVERT	Optional
SYNTAX	Check SFGR source syntax	YES, NO	Optional
TOFILE	To DDS source file	Qualified object name	Optional
	Qualifier 1: To DDS source file	Name, QDDSSRC
	Qualifier 2: Library	Name, LIBL, CURLIB
TOMBR	To DDS source member	Name, NONE, SRCMBR, *DSPFILE	Optional
HALT	Issue msg if error occurs	YES, NO	Optional
DFRWRT	Defer write	SRCATR, YES, *NO	Optional
TGTRLS	Target Release	Character value, CURRENT, PRV	Optional

Top

Display file (DSPFILE)

Specifies the name and the library of the created display file.

This is a required parameter.

display-file-name: Specify the display file name.
Note: A display file is not created if the file has the same name and library as an existing program, message file, or other type of file.

The possible library values are:

*CURLIB: The current library for the job is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library where the display file is located.

Option (OPTION)

Specifies what to do with the specified display file. A maximum of 32 options can be specified. The given option applies to the corresponding name on the S/36 SFGR source member (SRCMBR) parameter.

*CREATE: A display file is created using the specified display file name as defined by the specified source members. If *CREATE is specified, no other options can be specified.
*ADD: One or more display formats are added to the specified display file, as defined by the corresponding names specified on the S/36 SFGR source member (SRCMBR) parameter.
*UPDATE: One or more display formats are updated in the specified display file as defined by the corresponding names specified on the SRCMBR parameter.
*DELETE: A display format is deleted from the specified display file. The format that is deleted is defined by the corresponding names specified on the SRCMBR parameter. If all formats in the display file are deleted, the entire display file is deleted and a source file member is not produced.

S/36 source file (SRCFILE)

Specifies the name of the source file in which the screen format generator (SFGR) source members are found.

QS36SRC: The source file, QS36SRC, is used.
file-name: Specify the name of the source file.

The possible library values are:

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library where the source file is located.

Replace display file (REPLACE)

Specifies whether an existing display file is replaced. When OPTION(*CREATE) is not specified, this parameter is ignored.

*NO: An existing display file is not replaced.
*YES: An existing display file is replaced. Other types of files are not replaced.
Note: A display file is not created if the file has the same name and library as a program or message file.

If terminating errors are encountered, the existing display file is not replaced. If the display file already exists, the Authority (AUT) parameter is ignored and the authorities for the old display file are copied to the new display file that replaces it. REPLACE(YES) is assumed when OPTION (*ADD) (*UPDATE) or (*DELETE) is specified.

Print SFGR listing (PRINT)

Specifies whether the compile listings are printed.

*YES: Full listings for the SFGR source syntax checking and the DDS compile steps are printed.
*NO: No listing is printed for the SFGR source syntax checking step. *PARTIAL is assumed for the DDS compile step.
*PARTIAL: If errors are found in any step, the compile listing is printed for that step, along with the error or warning messages. If no messages are issued, no listing is printed.

Maximum devices (MAXDEV)

Specifies the number of devices that can use the display file at one time.

*SRCATR: The maximum number of devices is taken from the first attributes of the source member. The Change System/36 Source Attributes (CHGS36SRCA) and Edit System/36 Source Attributes (EDTS36SRCA) commands can be used to set this value in the source member.
number-of-devices: Specify the maximum number of devices. The valid values range from 1 through 256.

Authority (AUT)

Specifies the authority you are giving the users who do not have specific authority to the object, who are not on the authorization list, and whose user group has no specific authority to the object.

If REPLACE(*YES) is specified and the display file already exists, the AUT parameter is ignored and the authorities for the old display file are copied to the new display file that replaces it. REPLACE(*YES) is assumed when OPTION *ADD, *UPDATE or *DELETE is specified.

*LIBCRTAUT: The authority for the object is the same as the value specified on the Create authority (CRTAUT) parameter of the library in which the object is being created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.

*USE: The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*EXCLUDE: The user cannot access the object.

authorization-list-name: Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Generation option (GENOPT)

Specifies the compile options that are used.

*GEN: If *YES is specified on the Check SFGR source syntax (SYNTAX) parameter, the SFGR source syntax is checked, the display file is converted to data description specifications (DDS), and a display file (*FILE) object is created. If *NO is specified on the SYNTAX parameter, the SFGR source syntax is not checked.
*NOGEN: If *YES is specified on the SYNTAX parameter, the SFGR source syntax is checked.
*CONVERT: The display file is converted to data description specifications (DDS), but no display file is created. Specify a member name on the To DDS source member (TOMBR) parameter to save the DDS results. If terminating errors are found when syntax checking the SFGR source, no conversion to DDS is performed. If *YES is specified on the SYNTAX parameter, SFGR syntax checking is performed.

To DDS source file (TOFILE)

Specifies the name of the source file in which to store the DDS source that is used to create the display file. The file need not already exist. If the user is authorized to the CRTSRCPF (Create Source Physical File) command, and the file does not exist, a new source file is created.

QDDSSRC: The source file, QDDSSRC, is used.
file-name: Specify the name of the source file. The file should have a record length of 92 bytes.

The possible library values are:

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the file. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library where the source file is located.

To DDS source member (TOMBR)

Specifies the name of the source file member in which to store the DDS source. The source file member is added if it does not exist, and is replaced if it exists. When the member name is the same as that of the display file name, and the to-file is QS36DDSSRC in the same library as the display file being created, the DDS is saved in this member only if the compile operation of the display file is successful. To guarantee that the DDS is saved, specify the name of some other source file, library, or member.

*NONE: The DDS source is not stored in the source file specified on the To DDS source file (TOFILE) parameter. The source is saved in the Q36DDSSRC source file.
*SRCMBR: The first name specified on the S/36 SFGR source member (SRCMBR) parameter is used as the member name.
*DSPFILE: The display file name is used as the member name.
member-name: Specify the name of the source file member in which to store the DDS source. If the member does not exist, it is added. If it already exists, it is replaced. If any terminating errors are encountered, the member is not added or changed.

Defer write (DFRWRT)

Specifies that data is not written to the display file until a read request is made. Control is returned to the requesting program immediately after the data is received for output. This may result in improved performance.

*SRCATR: The defer write option is taken from the DFRWRT attribute of the first source member. If there is no source member, or the DFRWRT source attribute has not been set, *YES is used.
*YES: When the write request is made to the display file, control is returned after the buffer is processed. The actual display of the data may take place after a read or combined write/read operation is performed. The program buffer is immediately available for the next read or combined write/read operation.
*NO: When the write request is made to the display file, control is not returned to the requesting program until the input/output request is completed including displaying the data and making input/output information available.

Target Release (TGTRLS)

Specifies the release level of the operating system on which you intend to use the object being saved.

When specifying the target-release value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R3M0 is version 5, release 3, modification 0.

Valid values depend on the current version, release, and modification level of the operating system, and they change with each new release. You can press F4 while prompting this command parameter to see a list of valid target release values.

*CURRENT: The object is to be restored to, and used on, the release of the operating system currently running on your system. The object can also be restored to a system with any subsequent release of the operating system installed.
*PRV: The object is to be restored to the previous release with modification level 0 of the operating system. The object can also be restored to a system with any subsequent release of the operating system installed.
character-value: Specify the release in the format VxRxMx. The object can be restored to a system with the specified release or with any subsequent release of the operating system installed.

Examples

CRTS36DSPF   DSPFILE(MYLIB/MYDISPLAY)  OPTION(*CREATE)
             SRCMBR(SFGRMBR1 SFGRMBR2)
             SRCFILE(MYLIB/QS36SRC)  GENOPT(*NOGEN)

This command checks the SFGR source (producing a printer list named QPUTSFGR). No DDS is built, and the display file is not created.

Error messages

*ESCAPE Messages

SSP4464: Member &3 in file &1 in use, cannot be shared.
SSP5003: Source member &1 not found.
SSP5004: &1--This load member exists, but is not a $SFGR member.
SSP5005: &1 display file already exists.
SSP5007: Source member &1 already given.
SSP5009: Display file &1 not found in library &2.
SSP5010: &1 not System/36 display file.
SSP5011: &1 not allowed for display file name.
SSP5012: Format &1 not found in display file
SSP5015: Source file library &1 not found.
SSP5016: Display file library &1 not found.
SSP5017: TOFILE library &1 not found.
SSP5019: Terminating errors in $SFGR input specifications.
SSP5027: TGTRLS(*PRV) allowed with changes only when existing display file created for previous release.
SSP5451: Existing file &1 is not a display file.
SSP6124: Unexpected error occurred.
SSP7375: Error &1 received by &2 utility.
SSP8663: User not authorized to access &1.
SSP8679: Not authorized to access member &1.
SSP9080: Object &1 in use; it cannot be shared.