Validation Program Relationships MQGF

This screen can only be entered from Parameter Group - Amend Validation Programs, MQGE. It is used to specify the use of the input and output fields of a validation program associated with a parameter defined on MQGC.

When parameter names are entered against any of the fields on either format, a class compatibility check is performed when Enter is pressed or Update selected. The field associated with the error parameter specified on format 2 must be of class CHAR(5), to receive the error message code. (At mapping request time, valid program commarea fields of class MSG_TYPE and MSG_SUBTEXT will be used automatically if they are found.)

The validation programs nominated in a Parameter Group will only be executed if the relevant error parameter is on the screen at request time.

Note that when you leave this screen (using Update or Exit) you will return to wherever you entered MQGE from. This is because MQGF is treated as a logical unit with MQGE. So if you entered MQGE from Parameter Group - Amend, MQGB via the Validation Programs action, then you will return to MQGB; if you entered MQGE from Amend Parameters, MQGC via the Validation Programs action, then you will return to MQGC.

MQGF Fields

Sequence

Display only. This field indicates the position of the current program in the list of nominated programs. This is for your convenience; the sequence has no significance to QED.

Program

Display only. The name of the program selected on MQGE when this screen was entered.

Program Field

Parameter/Literal

Optional. You can enter literal values (alphanumeric strings must be enclosed in quotes) or the name of a parameter to be used as a source of data for the field. Fields may be left empty, in which case nulls will be passed to the program at run time.

Description

Display only. The descriptions associated with the parameter names specified in the previous column.

Program Field

Program Field Class

Display only. The data class of each commarea field is displayed beside its name.

Error Parameter

Optional. Enter the name of a parameter against which the program's error message is to be issued. The field against which this is placed must be of class CHAR(5), to accept the error message identifier. Only one error parameter is nominated, against the relevant program field (which is often - but not always - called MSG). Nomination of an error parameter is not mandatory, but if no error parameter is specified, then execution of the validation program cannot be triggered.

Description

Display only. The first part of the description associated with the error parameter.

NOTE This is another part of the process of defining a Parameter Group where experience of e5 and QED, and familiarity with commareas, will make the job a lot easier.

If not described in this topic, click on a field and press F1 to view help. See Common Fields for more information.

Fast prompt allows you to quickly view a list of options for certain fields.

NOTE Field visibility can be defined by your System Administrator, so not all fields documented may be shown.

See Using the Command Line on opening the screen without going through the menu.