Create Panel Group (CRTPNLGRP)

The Create Panel Group (CRTPNLGRP) command creates panel groups that contain online help information, which can be shown in conjunction with your data description specifications (DDS) displays, CL commands, or a search index.

Restrictions:

You must have read (*READ) and add (*ADD) authorities for the library where the panel group is to be created.
If the panel group already exists, you must have object existence (*OBJEXIST), object management (*OBJMGT) and read (*READ) authorities for the panel group.

Parameters

Keyword	Description	Choices	Notes
PNLGRP	Panel group	Qualified object name	Required, Positional 1
	Qualifier 1: Panel group	Name
	Qualifier 2: Library	Name, *CURLIB
SRCFILE	Source file	Qualified object name	Optional, Positional 2
	Qualifier 1: Source file	Name, QPNLSRC
	Qualifier 2: Library	Name, LIBL, CURLIB
SRCMBR	Source member	Name, *PNLGRP	Optional, Positional 3
TEXT	Text 'description'	Character value, SRCMBRTXT, BLANK	Optional
OPTION	Source listing options	Values (up to 3 repetitions): SOURCE, NOSOURCE, SRC, NOSRC, NOSECLVL, SECLVL, NOEVENTF, EVENTF	Optional, Positional 4
INCFILE	Include file	Single values: SRCFILE Other values: Qualified object name*	Optional
	Qualifier 1: Include file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
CHRID	Character identifier	Single values: DEVD, SYSVAL, JOBCCSID, CHRIDCTL Other values: Element list	Optional
	Element 1: Graphic character set	Integer
	Element 2: Code page	Integer
AUT	Authority	Name, LIBCRTAUT, CHANGE, ALL, USE, *EXCLUDE	Optional
REPLACE	Replace panel group	YES, NO	Optional

Top

Panel group (PNLGRP)

Specifies the panel group to be created.

This is a required parameter.

Qualifier 1: Panel group

name: Specify the name of the panel group to be created.

Qualifier 2: Library

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

Source file (SRCFILE)

Specifies the source file that contains the panel group description source statements. Valid source file record length values range from 13 through 92.

Qualifier 1: Source file

QPNLSRC: Source file QPNLSRC contains the panel group description source statements.
name: Specify the name of the source file that contains the panel group description source statements.

Qualifier 2: Library

*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 source file. If no library is specified as the current library for the job, QGPL is used.
name: Specify the name of the library where the source file is located.

Source listing options (OPTION)

Specifies options for the output produced during the compile. Multiple option values can be specified in any order on this parameter. If neither or both of the values in each group are specified, the underlined value will be used.

Note: The underlined values for this parameter are similar to, but not actually default values, and therefore, cannot be changed with the Change Command Default (CHGCMDDFT) command.

Source Listing Option

*SRC or *SOURCE: A source listing is produced.
*NOSRC or *NOSOURCE: No source listing is produced unless errors are detected.

Second-Level Message Text Option

*NOSECLVL: Second-level text is not provided with the first-level text when the messages are printed at the end of the listing.
*SECLVL: Second-level text is provided with the first-level text when the messages are printed at the end of the listing.

Event File Creation Option

*NOEVENTF: The compiler does not produce an event file for the CoOperative Development Environment for iSeries (CODE for iSeries).
*EVENTF: The compiler produces an event file that can be used by the CODE for iSeries product. The event file is created as a member in the file EVFEVENT in your object library. The CODE for iSeries product uses this file to offer error feedback integrated with the CODE for iSeries editor. This value is normally specified by the CODE for iSeries product on your behalf.

Include file (INCFILE)

Specifies the source file containing the members to be included.

Note: If the coded character set identifier (CCSID) of the source file is different than the CCSID of the primary source file specified for the Source file (SRCFILE) parameter, the CCSID is changed to the CCSID of the primary source file. The CCSID must be the same for all source members used to create the object.

Single values

*SRCFILE: The include file is the same file as the file specified for the SRCFILE parameter.

Qualifier 1: Include file

name: Specify the name of the source file containing the members to be included.

Qualifier 2: Library

*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 source file. If no library is specified as the current library for the job, the QGPL library is used.
name: Specify the name of the library where the source file is located.

Character identifier (CHRID)

Specifies whether character identifier (graphic character set and code page) of the dialog variables of the panel group is changed when the panel group is displayed.

Single values

*DEVD: No change occurs. The character identifier of the dialog variables and the panel group is the same as the character identifier of the device.
*SYSVAL: The character identifier of the dialog variables is changed to the default QCHRID system value for the device. The character identifier of the panel group is the same as the character identifier of the device.
*JOBCCSID: The character identifier of the dialog variables is changed from the CCSID of the job to the character identifier of the device. The character identifier of panel group is changed from the CCSID of the source file on the SRCFILE parameter to the character identifier of the device.
*CHRIDCTL: The system checks the CHRIDCTL job attribute to determine whether to use *JOBCCSID or *DEVD on the CHRID parameter for this panel group.

Element 1: Graphic character set

integer: Specify the graphic character set to be used. Valid values range from 1 through 32767.

Element 2: Code page

integer: Specify the code page to be used. Valid values range from 1 through 32767.

Note: Conversion may be necessary depending on the character identifier of the work station or printer.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*LIBCRTAUT: The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.

*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.

*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.

*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.

*EXCLUDE: The user cannot access the object.

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.

Replace (REPLACE)

Specifies whether an existing panel group of the same name in the specified library is replaced.

Note: The panel group cannot be replaced if it is in use by this job or another job.

*YES: The existing panel group is replaced by moving it to the system library QRPLOBJ.
*NO: The existing panel group is not replaced. If such a panel group exists, the create operation fails.

Examples

CRTPNLGRP   PNLGRP(PAYLIB/PAYROLL)
            SRCFILE(QPNLSRC)  OPTION(*SECLVL)

This command creates a panel group named PAYROLL in library PAYLIB, uses source file QPNLSRC in the library list, and prints the second-level message text in the listing.