CRTQMFORM (Create Query Management Form)

CRTQMFORM Command syntax diagram

 

Purpose

The Create Query Management Form (CRTQMFORM) command allows the user to create a query management form from a specified source file member. The query management form defines how a report is to look when data from running a query is displayed or printed.

 

Required Parameters

QMFORM

Specifies the name of the query management form to be created.

The possible library values are:

*CURLIB: The current library for the job is used to locate the form. 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 form is located.

form-name: Specify the name of the form to be created.

 

Optional Parameters

SRCFILE

Specifies the qualified name for the source file containing the source for the form being created. The form is identified by the name specified on the QMFORM parameter.

The name of the source file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. 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 to be searched.

QQMFORMSRC: The file having the IBM-supplied source file name, QQMFORMSRC, contains the source for the form to be created.

source-file-name: Specify the name of the file containing the source for the form to be created.

SRCMBR

Specifies the name of the source file member containing the form source to be created.

*QMFORM: The member name is the same as the form name specified on the QMFORM parameter.

source-file-member-name: Specify the name of the member that contains the form source.

TEXT

Specifies the text that briefly describes the query management form. More information on this parameter is in Commonly used parameters.

*SRCMBRTXT: The descriptive text for the object being created is the same as the text description of the source member. If the source member has no text description, or if it is blank, then TEXT(*BLANK) is assumed.

*BLANK: No text is specified. If this command causes an object to be replaced, then any existing text for the object is replaced with blank text.

'description': Specify no more than 50 characters of text, enclosed in apostrophes. The apostrophes are not part of the 50-character string.

AUT

Specifies the authority given to users who do not have specific authority to the query management form, who are not on an authorization list, and whose user group has no specific authority to the query management form. More information on this parameter is in Commonly used parameters.

*LIBCRTAUT: The public authority for the query management form is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the query management form). The public authority is determined when the query management form is created. If the CRTAUT value for the library changes after the query management form is created, the new value does 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 authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management 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 query management form. If the object is part of an authorization list, the user cannot add, change, or remove other users.

*USE: The user can perform basic operations on the object, for example, run a program or read a file. The user is prevented from changing the object in any way. This authority provides object operational authority and read authority.

*EXCLUDE: The user cannot access an object.

authorization-list-name: Specify the name of the authorization list used.

REPLACE

Specifies whether an existing object with the same name and type in the library to receive the output is replaced with the output of this command. More information on this parameter is in Commonly used parameters.

*YES: An existing object is replaced with the output of this command.

*NO: An existing object is not replaced with the output of this command.

Example for CRTQMFORM

CRTQMFORM   QMFORM(FORMEMP)  SRCFILE(RPTLIB/FORMSRC)

This command creates a form named FORMEMP in the current library. The form source is in member FORMEMP, which is located in source file FORMSRC in library RPTLIB.

Error messages for CRTQMFORM

*ESCAPE Messages

QWM2701

&1 command failed.

QWM2703

&1 command ended.

QWM2705

Source file &1 in &2 not available.

QWM2706

&1 in &2 not replaced.