START command keyword

Table 7. START command keywords, descriptions, and default values
START command keywords	Description	Default value
DSQADPAN	Sets the DSQDC_DISPLAY_RPT global variable. This variable controls whether QMF displays the report when a query is run from within an application program. A value of 1 displays the report when a query is run. Set the value to 0 to specify that the report not be displayed.	In the callable interface: 1 In batch mode, or if QMF started interactively with DSQQMFE: 0
DSQALANG	Determines the presiding language for the session you are starting. The value for this parameter is a one-character language identifier. Enter or specify QMF commands in the presiding language specified by this keyword. If you want to enter English commands when the presiding language is a language other than English, you can use the QMF bilingual support (see Writing Bilingual Applications). The following table shows a complete list of language identifiers that are valid values for this variable: Identifier Language D German E English F French H Hangeul (Korea) I Italian K Kanji (Japan) P Brazilian Portuguese Q Danish (not available in QMF VSE) S Spanish U Uppercase English V Swedish (not available in QMF VSE) Y Swiss French Z Swiss German	E, for English
DSQSBSTG	Tells QMF how many bytes of storage to use for report generation. It lets you limit the amount of storage when there are multiple users in the same address space in CICS, and has similar uses in TSO and CMS if this variable is specified. In TSO and CMS, this keyword overrides the DSQSRSTG keyword if you specify both. If you do not specify this keyword, the value of the DSQSRSTG keyword is used. Note to CICS users: DSQSBSTG is always used for CICS; DSQSRSTG is never used for CICS. If you set the value of DSQSBSTG to below the minimum amount of storage required to produce a report, QMF automatically allocates the minimum amount of storage required; this minimum depends on your environment. A large report can require more than the minimum amount of storage.	In CICS: 500 000 bytes In CMS or TSO: zero bytes
DSQSCMD ² (CMS and TSO only)	Specifies the REXX program that sets the QMF program parameters. When QMF receives the START command from a callable interface application, QMF calls the REXX program specified by this keyword. This REXX program provides values for QMF program parameters that QMF uses as defaults for those keywords not specified on the START command. START (DSQSCMD=`yourprogram` Note to CICS users QMF CICS does not support REXX; therefore, DSQSCMD is not supported under CICS. If you start QMF using the callable interfaceunder CICS and you want to set QMF program parameters, you must specify the keywords on the START command.	DSQSCMDE
DSQSDBCS	Determines whether QMF allows double-byte characters when the terminal does not support DBCS. Values are YES and NO. You should set the value to YES when you intend to print double-byte character set (DBCS) data from a non-DBCS terminal or run a QMF batch job that prints DBCS data. Otherwise, the value should be NO.	NO
DSQSDBNM	Specifies the location to connect to when starting a QMF session. A null value means that QMF connects to the default database (the database it normally connects to without remote unit of work). If your installation does not have a communication database set up and you attempt to specify a value other than null or the name of the default database, an error occurs.	NULL
DSQSDBQN (CICS only)	Specifies that CICS storage is used for QMF trace data. The name must conform to CICS name specifications for the type of CICS queue selected by DSQSDBQT. For more information about CICS name specifications, see the CICS application programming guide for your system.	DSQD
DSQSDBQT (CICS only)	Specifies the type of CICS storage to be used for QMF trace data. The values are: TD Use CICS transient data. TS Use CICS auxiliary temporary storage. Use caution when specifying temporary storage, because QMF can generate a large amount of trace data.	TD
DSQSDBUG	Specifies whether product tracing occurs during QMF initialization. The values are: ALL Specifies most detailed QMF tracing. NONE Specifies minimal QMF tracing.	NONE
DSQSDCSS (CMS only)	Specifies the name of the DCSS (discontiguous shared segment) that contains QMF execution modules.	QMF720n, where n is the national language identifier. For English, the default is QMF720E.
DSQSIROW	Indicates the number of rows QMF fetches before displaying the first screen of data for a RUN QUERY, IMPORT DATA, or DISPLAY command.	100
DSQSMODE ²	Tells QMF which mode you want to work in. I Specifies interactive mode. B Specifies batch mode. When the value of DSQSMODE is B, panel display is inhibited so that QMF can run in a background job.	B (batch)
DSQSPILL	Specifies whether QMF uses the spill file or data set. Possible values are YES or NO.	For CICS: NO For CMS and TSO: YES
DSQSPLAN (TSO only)	Specifies the DB2 application plan ID assigned to QMF.	QMF720
DSQSPRID (TSO only)	Specifies whether to use the TSO logon ID or the primary authorization ID to select the appropriate row from Q.PROFILES and to qualify Q.ERROR_LOG entries. Allowable values are PRIMEID or TSOID.	PRIMEID
DSQSRSTG (CMS and TSO only)	Determines the number of bytes of virtual storage you want to reserve for your application and other applications called by your application. Use this parameter if you plan to run applications from within the QMF environment. If you do not reserve storage for your application, QMF can use all the virtual storage available to produce a large report.	Zero (0)
DSQSRUN ²	Specifies the name of the QMF initial procedure to run after QMF is started. The initial procedure runs only once with the callable interface. In this procedure, you can include commands to set global variables and profile variables to customize the user's session. This procedure can place the user in QMF if the application is going to run QMF interactively, or prepare the QMF session for a batch operation.	NULL
DSQSSPQN (CICS only)	Specifies the name of the CICS temporary storage queue that is used for QMF spill data. When the program parameter DSQSPILL has a value of YES, this spill area is used to contain report data.	DSQS`id`, where `id` is the CICS terminal ID
DSQSSUBS (TSO only)	Specifies the ID of the DB2 subsystem on which QMF is installed.	DSN
DSQSUSER (CICS/VSE only)	Specifies the SQL/DS authorization ID and password on the CONNECT command. To specify the DSQSUSER keyword, enter the following: DSQSUSER=SQL ID/password where SQL ID is the SQL/DS authorization ID for the user who is starting QMF.	The 3-byte VSE operator ID and the password defined in the system catalog. Must specify if starting QMF with DSQSMODE=B.

Table 7. START command keywords, descriptions, and default values

START command keywords

Description

Default value

DSQADPAN

Sets the DSQDC_DISPLAY_RPT global variable. This variable controls whether QMF displays the report when a query is run from within an application program. A value of 1 displays the report when a query is run. Set the value to 0 to specify that the report not be displayed.

In the callable interface: 1

In batch mode, or if QMF started interactively with DSQQMFE: 0

DSQALANG

Determines the presiding language for the session you are starting. The value for this parameter is a one-character language identifier. Enter or specify QMF commands in the presiding language specified by this keyword. If you want to enter English commands when the presiding language is a language other than English, you can use the QMF bilingual support (see Writing Bilingual Applications). The following table shows a complete list of language identifiers that are valid values for this variable:

Identifier: Language
D: German
E: English
F: French
H: Hangeul (Korea)
I: Italian
K: Kanji (Japan)
P: Brazilian Portuguese
Q: Danish (not available in QMF VSE)
S: Spanish
U: Uppercase English
V: Swedish (not available in QMF VSE)
Y: Swiss French
Z: Swiss German

E, for English

DSQSBSTG

Tells QMF how many bytes of storage to use for report generation. It lets you limit the amount of storage when there are multiple users in the same address space in CICS, and has similar uses in TSO and CMS if this variable is specified.

In TSO and CMS, this keyword overrides the DSQSRSTG keyword if you specify both. If you do not specify this keyword, the value of the DSQSRSTG keyword is used.

Note to CICS users: DSQSBSTG is always used for CICS; DSQSRSTG is never used for CICS.

If you set the value of DSQSBSTG to below the minimum amount of storage required to produce a report, QMF automatically allocates the minimum amount of storage required; this minimum depends on your environment. A large report can require more than the minimum amount of storage.

In CICS: 500 000 bytes

In CMS or TSO: zero bytes

DSQSCMD ² (CMS and TSO only)

Specifies the REXX program that sets the QMF program parameters.

When QMF receives the START command from a callable interface application, QMF calls the REXX program specified by this keyword. This REXX program provides values for QMF program parameters that QMF uses as defaults for those keywords not specified on the START command.

START (DSQSCMD=yourprogram

Note to CICS users

QMF CICS does not support REXX; therefore, DSQSCMD is not supported under CICS. If you start QMF using the callable interfaceunder CICS and you want to set QMF program parameters, you must specify the keywords on the START command.

DSQSCMDE

DSQSDBCS

Determines whether QMF allows double-byte characters when the terminal does not support DBCS. Values are YES and NO.

You should set the value to YES when you intend to print double-byte character set (DBCS) data from a non-DBCS terminal or run a QMF batch job that prints DBCS data. Otherwise, the value should be NO.

DSQSDBNM

Specifies the location to connect to when starting a QMF session. A null value means that QMF connects to the default database (the database it normally connects to without remote unit of work).

If your installation does not have a communication database set up and you attempt to specify a value other than null or the name of the default database, an error occurs.

NULL

DSQSDBQN (CICS only)

Specifies that CICS storage is used for QMF trace data. The name must conform to CICS name specifications for the type of CICS queue selected by DSQSDBQT. For more information about CICS name specifications, see the CICS application programming guide for your system.

DSQD

DSQSDBQT (CICS only)

Specifies the type of CICS storage to be used for QMF trace data.

The values are:

TD: Use CICS transient data.
TS: Use CICS auxiliary temporary storage. Use caution when specifying temporary storage, because QMF can generate a large amount of trace data.

DSQSDBUG

Specifies whether product tracing occurs during QMF initialization. The values are:

ALL: Specifies most detailed QMF tracing.
NONE: Specifies minimal QMF tracing.

NONE

DSQSDCSS (CMS only)

Specifies the name of the DCSS (discontiguous shared segment) that contains QMF execution modules.

QMF720n, where n is the national language identifier.

For English, the default is QMF720E.

DSQSIROW

Indicates the number of rows QMF fetches before displaying the first screen of data for a RUN QUERY, IMPORT DATA, or DISPLAY command.

100

DSQSMODE ²

Tells QMF which mode you want to work in.

I: Specifies interactive mode.
B: Specifies batch mode.

When the value of DSQSMODE is B, panel display is inhibited so that QMF can run in a background job.

B (batch)

DSQSPILL

Specifies whether QMF uses the spill file or data set. Possible values are YES or NO.

For CICS: NO

For CMS and TSO: YES

DSQSPLAN (TSO only)

Specifies the DB2 application plan ID assigned to QMF.

QMF720

DSQSPRID (TSO only)

Specifies whether to use the TSO logon ID or the primary authorization ID to select the appropriate row from Q.PROFILES and to qualify Q.ERROR_LOG entries. Allowable values are PRIMEID or TSOID.

PRIMEID

DSQSRSTG (CMS and TSO only)

Determines the number of bytes of virtual storage you want to reserve for your application and other applications called by your application. Use this parameter if you plan to run applications from within the QMF environment. If you do not reserve storage for your application, QMF can use all the virtual storage available to produce a large report.

Zero (0)

DSQSRUN ²

Specifies the name of the QMF initial procedure to run after QMF is started. The initial procedure runs only once with the callable interface.

In this procedure, you can include commands to set global variables and profile variables to customize the user's session. This procedure can place the user in QMF if the application is going to run QMF interactively, or prepare the QMF session for a batch operation.

NULL

DSQSSPQN (CICS only)

Specifies the name of the CICS temporary storage queue that is used for QMF spill data. When the program parameter DSQSPILL has a value of YES, this spill area is used to contain report data.

DSQSid, where id is the CICS terminal ID

DSQSSUBS (TSO only)

Specifies the ID of the DB2 subsystem on which QMF is installed.

DSN

DSQSUSER (CICS/VSE only)

Specifies the SQL/DS authorization ID and password on the CONNECT command. To specify the DSQSUSER keyword, enter the following:

DSQSUSER=SQL ID/password

where SQL ID is the SQL/DS authorization ID for the user who is starting QMF.

The 3-byte VSE operator ID and the password defined in the system catalog. Must specify if starting QMF with DSQSMODE=B.