Mapping List MQMA

This screen provides facilities not only for listing existing Mappings, but also creating, editing, compiling and running them and examining their output.

Click

Insert and Mapping Edit MQMX opens.

Select the entry you want to edit, click

Amend and Mapping Edit MQMX opens.

Filtering the list

Field	Description
User	Optional; used to restrict the list to those Mappings which belong to a specific user. A complete user ID must be entered; wildcards cannot be used. The default value is blank, which matches all user IDs.
Report	Optional; used to restrict the list to those Mappings which have been defined to use the specified report template. A complete report template name must be entered; wildcards cannot be used. The default value is blank, which matches all report template names.
Entity	Optional; used to restrict the list to those Mappings which have been defined to use the specified entity or table. A complete entity, table name or Data Block must be entered; wildcards cannot be used. The default value is blank, which matches all entity and table names. With the default Profile Mode of 1, an entity name can be entered. If a table name is entered, then the Profile Mode must be changed to 2 If a Data Block name is entered, then the Profile Mode must be changed to 1. (If the mode is changed to 2 or 3, then the field label 'Entity' is replaced by the word 'Table' or 'Data Block' in the selection box.)
System Ref/Program	Optional; used to restrict the list to that Mapping which has the specified System Reference number or three character Program id. A complete System Reference or Program ID must be entered; wildcards cannot be used. The default value is blank, which matches all Mappings. (If this field is used and a Mapping with the entered System Reference number or Program ID exists, then the list will contain only one Mapping.)

Field

Description

User

Optional; used to restrict the list to those Mappings which belong to a specific user. A complete user ID must be entered; wildcards cannot be used. The default value is blank, which matches all user IDs.

Report

Optional; used to restrict the list to those Mappings which have been defined to use the specified report template. A complete report template name must be entered; wildcards cannot be used. The default value is blank, which matches all report template names.

Entity

Optional; used to restrict the list to those Mappings which have been defined to use the specified entity or table. A complete entity, table name or Data Block must be entered; wildcards cannot be used. The default value is blank, which matches all entity and table names.

With the default Profile Mode of 1, an entity name can be entered. If a table name is entered, then the Profile Mode must be changed to 2 If a Data Block name is entered, then the Profile Mode must be changed to 1. (If the mode is changed to 2 or 3, then the field label 'Entity' is replaced by the word 'Table' or 'Data Block' in the selection box.)

System Ref/Program

Optional; used to restrict the list to that Mapping which has the specified System Reference number or three character Program id. A complete System Reference or Program ID must be entered; wildcards cannot be used. The default value is blank, which matches all Mappings. (If this field is used and a Mapping with the entered System Reference number or Program ID exists, then the list will contain only one Mapping.)

Options

Option	Description
Compile	Compile: Compile Compile: Compile & Go These actions cause the selected Mapping to be translated (compiled) into an executable load module which is stored for future use; the second action additionally creates a request for the Mapping to be run after it has successfully compiled. The load module is stored on the default device using a unique system-generated identifier.
Requests	Go: Requests Once a load module has been generated for a Mapping, it can become part of a request. This action transfers you to Request - List MAOA, which displays a list of requests which include the selected Mapping.
Mapping	Mapping: Search This action transfers you to Mapping Search MQMC. This allows Mapping wide free format text searches.
Profile Mode	Profile: Mode The Profile Mode determines whether the Mappings listed are selected on the basis of their underlying entities, tables or Data Blocks. If the Profile Mode is set to 1, the references are to entities; if set to 2, then references are to tables; if set to 3, then references are to Data Blocks. (See also the description of the field Entity).
Submit	Submit: Submit This action cannot be used unless the selected Mapping has been successfully compiled and an executable load module exists. When you choose this action, you are transferred to QED Parameters - Insert MQRA, which is used to create the request and submit it for background processing. It allows you to enter run time parameters (as defined within the Parameters component of the Mapping) or applies default values as necessary. Each request is assigned a unique identifier. If the Mapping generates a document, it is sent to the default destination (usually the e5 spool), as designated for the user submitting the request.
Syntax Compile	Syntax: Compile This action performs a full syntax check of the entire Mapping; it operates in the foreground, returning its messages directly to the user's screen. If successful, it guarantees that the Mapping can be compiled and that a load module will be created by the background Compile action. A full compilation listing is produced (which can be examined with the View Compile action) rather than the error messages which are produced by Syntax Checks on individual components of a Mapping.
View Compile	View: Compile This action transfers you to Document Viewer MARC. Use this screen to display the latest compilation listing for the selected Mapping. A compilation listing (which is produced each time a Mapping is compiled) contains both the MDL definition and the generated COBOL code.
View Document(s)	View: Document(s) Use this action to display the documents generated by the processing of the selected Mapping. It transfers you to Spool - List MARA.

Option

Description

Compile

Compile: Compile

Compile: Compile & Go

These actions cause the selected Mapping to be translated (compiled) into an executable load module which is stored for future use; the second action additionally creates a request for the Mapping to be run after it has successfully compiled. The load module is stored on the default device using a unique system-generated identifier.

Requests

Go: Requests

Once a load module has been generated for a Mapping, it can become part of a request. This action transfers you to Request - List MAOA, which displays a list of requests which include the selected Mapping.

Mapping

Mapping: Search

This action transfers you to Mapping Search MQMC. This allows Mapping wide free format text searches.

Profile Mode

Profile: Mode

The Profile Mode determines whether the Mappings listed are selected on the basis of their underlying entities, tables or Data Blocks. If the Profile Mode is set to 1, the references are to entities; if set to 2, then references are to tables; if set to 3, then references are to Data Blocks. (See also the description of the field Entity).

Submit

Submit: Submit

This action cannot be used unless the selected Mapping has been successfully compiled and an executable load module exists. When you choose this action, you are transferred to QED Parameters - Insert MQRA, which is used to create the request and submit it for background processing. It allows you to enter run time parameters (as defined within the Parameters component of the Mapping) or applies default values as necessary. Each request is assigned a unique identifier. If the Mapping generates a document, it is sent to the default destination (usually the e5 spool), as designated for the user submitting the request.

Syntax Compile

Syntax: Compile

This action performs a full syntax check of the entire Mapping; it operates in the foreground, returning its messages directly to the user's screen. If successful, it guarantees that the Mapping can be compiled and that a load module will be created by the background Compile action. A full compilation listing is produced (which can be examined with the View Compile action) rather than the error messages which are produced by Syntax Checks on individual components of a Mapping.

View Compile

View: Compile

This action transfers you to Document Viewer MARC. Use this screen to display the latest compilation listing for the selected Mapping. A compilation listing (which is produced each time a Mapping is compiled) contains both the MDL definition and the generated COBOL code.

View Document(s)

View: Document(s)

Use this action to display the documents generated by the processing of the selected Mapping. It transfers you to Spool - List MARA.

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.