Specifies the location of the MRB for the mapping operation, as copied into program variable storage by the #MRB statement. The #MRB statement is described under #MRB. Map-request-block-pointer is either a register that points to the MRB area or the symbolic name of that area.
Specifies the location of the storage area in which the system builds the #MREQ parameter list.
(Default); is the symbolic name of the storage area.
Is either a register that points to the area or the symbolic name of the area.
Specifies several options applicable to terminal I/O operations. Multiple OPTNS parameter values must be enclosed in parentheses and separated by commas.
(#MREQ OUT and #MREQ OUTIN only); requests that the system activate the erase-write mechanism to clear the contents of a screen. If NEWPAGE is not specified, the system will write over any existing screen display without first erasing it.
You can mark individual fields to be erased by using the OUTDATA=ERASE option of the #MAPMOD statement, described earlier in this chapter.
(#MREQ OUT and #MREQ OUTIN only); requests that the system transmit literal fields as well as variable-storage data fields to the terminal. If LITERALS is not specified, the system writes literal fields to the map only if NEWPAGE is specified.
(#MREQ IN and #MREQ OUT only); requests that the system transfer a native-mode data stream, a 3270-like data stream that consists of user data and all device-control characters, to program storage. No terminal I/O is associated with the request:
When OPTNS=(NOIO) is specified, the STREAMA= and STREAML= parameters must also be defined, as described below.
(Non-write-direct-to-terminal #MREQ OUT only); requests that the system preserve the mapped output from the #MREQ OUT request in the event that an unsolicited write-direct-to-terminal data stream is received at the issuing terminal while the map is being displayed. This option overrides the task SAVE/NOSAVE option specified during system generation.
(#MREQ IN and #MREQ OUTIN only); requests that the system translate all letters in a map in request into uppercase characters.
(#MREQ IN and #MREQ OUTIN only); requests that lowercase characters are not translated into uppercase characters in a map in request. This can also be accomplished by issuing a DCUF SET UPLOW statement before starting the mapping session.
(#MREQ OUT and #MREQ OUTIN only); allows you to request the 3270 erase all unprotected command. This command sets all unprotected character locations to nulls, resets the MDTs for all unprotected fields, unlocks the keyboard, resets the AID key, and places the cursor at the first unprotected field. This option cannot be used with OPTNS=(NEWPAGE).
(#MREQ OUT and #MREQ OUTIN only); specifies how the variable-storage data fields are to be transmitted to the terminal. This specification applies to all variable-storage data fields unless overridden by an OUTDATA= clause in a previously issued #MAPMOD request.
Transfers the contents of variable-storage data fields to the corresponding map fields.
Requests that map fields remain unchanged.
Does not transfer the contents of variable-storage data fields to the screen.
Transmits only the attribute byte of each variable-storage field to the screen. Data in the variable-storage field is not transmitted.
(#MREQ IN and #MREQ OUTIN only); specifies whether the contents of the map fields are moved automatically into variable-storage data fields. This specification applies to all variable-storage data fields unless overridden by an INDATA= clause in a previously issued #MAPMOD request.
Transfers the contents of map fields to the corresponding variable-storage data fields.
Does not transfer the contents of map fields to the corresponding variable-storage data fields.
(Pageable map #MREQ IN only); specifies whether the #MREQ IN operation is to retrieve data from a detail occurrence or from the header or footer area.
Note: For more information about pageable maps, see the Mapping Facility Guide.
Specifies whether the #MREQ IN operation is to retrieve data from a modified detail occurrence (modified data tag set on):
(Default); specifies that data is not to be retrieved from a detail occurrence.
Specifies that data is to be retrieved from a modified detail occurrence (MDT set on). By default, the next sequential modified detail occurrence is retrieved; a different detail occurrence can be specified by using the FIRST/KEY/SEQNBR/RTRNKEY clause.
The contents of all map fields in the detail occurrence are retrieved unless MODIFY=YES is specified for the #MREQ IN,DETAIL statement. MODIFY=YES causes only modified fields to be retrieved.
Specifies the detail occurrence to be retrieved. Only one option can be specified.
Specifies whether the first available modified detail occurrence is to be retrieved.
(Default); specifies that the FIRST clause is not used to determine the detail occurrence to be retrieved.
Retrieves the first available modified detail occurrence. An end-of-data condition results if there are no more modified detail occurrences to be retrieved.
The optional RTRNKEY=data-field-name parameter specifies the name of a variable field in which the system stores the key value (if any) associated with the retrieved detail occurrence. If no value is associated with the detail occurrence, the system sets data-field-name to 0. Data-field-name must be a 4-byte value (not necessarily a binary fullword).
Note: A value is associated with a detail occurrence by using the KEY parameter in an #MREQ OUT,DETAIL=YES command for that occurrence.
Retrieves a modified detail occurrence based on the value associated with the detail occurrence. Key is a 4-byte variable field.
Note: A value is associated with a detail occurrence by using the KEY parameter in an #MREQ OUT,DETAIL=YES command for that occurrence.
A detail-not-found condition is returned if the specified occurrence is not a modified detail occurrence or if no detail occurrence with the specified value is found.
Retrieves a detail occurrence by sequence number. Detail occurrences are built by the application program at run time and are stored in the sequence in which they are created. Data-field-name is a 4-byte binary fullword field.
(Optional); names the variable field used to store the 4-byte value (if any) of the retrieved detail occurrence. If no value is associated with the detail occurrence, data-field-name is set to 0. (Data-field-name does not have to be a binary fullword).
Note: A value is associated with a detail occurrence by using the KEY parameter in an #MREQ OUT,DETAIL=YES command for that occurrence.
Retrieves the next sequential modified detail occurrence, and specifies the name of the variable field in which the system stores the value (if any) associated with the retrieved detail occurrence. If no value is associated with the detail occurrence, data-field-name is set to 0. Data-field-name must be a 4-byte value (not necessarily a binary fullword).
Note: A value is associated with a detail occurrence by using the KEY parameter in an #MREQ OUT,DETAIL=YES command for that occurrence.
(Pageable map #MREQ IN only); specifies whether the map in operation is to retrieve the contents of data fields in the header and footer areas.
(Default); specifies that data from the header and footer areas is not to be retrieved.
Specifies that data from the header and footer areas is to be retrieved.
The contents of all data fields in the header and footer areas are retrieved unless MODIFY=YES is specified in the #MREQ IN,HEADER statement; MODIFY=YES causes only modified fields to be retrieved.
Specifies the name of a numeric variable field to store the current binary fullword value of the $PAGE field on map in.
Specifies whether the contents of modified fields are to be retrieved.
(Default); retrieves all fields from the header and footer areas when a modified field (MDT set on) is found in the occurrence or areas.
Retrieves only the contents of modified fields from the header and footer areas; data in unmodified fields is not retrieved.
(Pageable map #MREQ OUT only); specifies whether the #MREQ OUT command is to create or modify a detail occurrence, or to map out a page of existing detail occurrences.
Specifies whether the #MREQ OUT command is to create or modify a detail occurrence.
(Default); specifies that the #MREQ OUT command does not create or modify detail occurrences.
Specifies that the #MREQ OUT command can either create or modify individual detail occurrences. You can optionally associate a numeric key value with each occurrence.
Specifies whether the detail occurrence is to be created or modified.
(Default); creates a detail occurrence in a pageable map. Occurrences are displayed in the order in which they are created by the application program.
Modifies the detail occurrence referenced by the most recent #MREQ OUT or #MREQ IN command.
(Optional); specifies a value to be associated with the created or modified detail occurrence. The 4-byte numeric value is not displayed on the terminal screen. Key is the name of the variable field that contains the database key of the database record associated with the detail occurrence.
When the KEY parameter is used with the #MREQ OUT,HEADER=YES,UPDATE=CURRENT command, the specified value replaces the value (if any) previously associated with the detail occurrence.
Specifies whether a page of detail occurrences is to be displayed on the terminal screen.
(Default); specifies that the #MREQ OUT command does not map out a page of detail occurrences to the terminal.
Specifies that the #MREQ OUT command maps out a page of detail occurrences to the terminal.
(Optional); determines the page of occurrences to be displayed on the terminal screen.
(Default); redisplays the current page. If no page has been displayed, the first page of the pageable map is displayed.
Displays the page that follows the current page. If no page follows the current page, the current page is redisplayed.
Displays the page that precedes the current page. If no page precedes the current page, the current page is redisplayed.
Displays the first available page of detail occurrences.
Displays the page of detail occurrences with the highest available page number.
Displays the numeric variable field that contains the binary fullword number of the page. A page number is previously stored in the variable field by an #MREQ IN,HEADER=YES,PAGE=page-number statement that names the same numeric variable field.
Specifies the register that contains the address of a 4-byte binary fullword field in variable storage that contains the number of the page to be displayed. Page-number must be enclosed in single quotes.
(#MREQ OUT and #MREQ OUTIN only); specifies whether the data transfer is synchronous or asynchronous.
Specifies that the data transfer is synchronous. the system places the issuing task in an inactive state. When the output operation is completed, the task resumes processing according to its established dispatching priority.
Specifies that the data transfer is asynchronous. the system returns control to the issuing program immediately after initiating the output operation and establishing an ECB to be posted when the output operation is completed.
An asynchronous transfer must be followed by a CHECK #TREQ request before another #MREQ request is issued to ensure that the previous #MREQ processing has been completed.
Note: For more information about synchronous and asynchronous processing, see #TREQ later in this chapter.
Specifying CHECK=NO in a #MREQ OUT statement issued before task termination frees the task resources when the task terminates; the system automatically issues a #TREQ CHECK.
(OPTNS=(NOIO only); specifies the location and the length of the input data stream to be transmitted.
Specifies the location of the native-mode data stream to be transmitted.
Either a register that points to the data stream or the symbolic name of the area that contains the data stream.
Specifies the length of the native-mode data stream to be transmitted.
A register that contains either the length or an absolute expression of the length.
Specifies the length of the output data stream and the location to which it is returned.
Specifies the location to which the system transfers the mapped data.
(Default); is the register that contains the address of the location to which the system transfers the mapped data.
Specifies the location to which the system transfers the mapped data. Return-data-stream-address-out is either a register or the symbolic name of a fullword user-defined area.
Specifies the location to which the system returns the length of the output data stream.
(Default); is the register to which the system returns the length, in bytes, of the output data stream.
Specifies the location to which the system returns the length, in bytes, of the output data stream. Return-data-stream-length-out is either a register or the symbolic name of a halfword or fullword user-defined field.
(#MREQ OUT only); specifies a write-direct-to-terminal request (blast) to either a destination, user, or logical terminal.
Specifies a write-direct-to-terminal request to one of the following destinations defined during system generation.
Note: This works only if there is a valid OUTAREA parameter for line mode (#LINEOUT) as well as for mapping mode (#MREQ).
A register that points to the destination id, the symbolic name of a user-defined field that contains the destination ID, or the ID itself enclosed in quotation marks.
Note: The destination list can include different 3270 models. If a map has been generated to support a specified terminal device, the system will write the map to that device. If the targeted terminal-device type is not in the map device list, the system will ignore that terminal device.
Specifies a write-direct-to-terminal request to a specific signed-on user. The system sends the #MREQ data stream specified in the OUTAREA parameter to a specific signed-on user.
Either a register that points to the user ID, the symbolic name of a user-defined field that contains the user id, or the ID itself enclosed in quotation marks.
Specifies a write-direct-to-terminal request to a specific in-service terminal. The system will send the #MREQ data stream specified in the OUTAREA parameter to a specific in-service terminal.
Either a register that points to the logical terminal id, the symbolic name of a user-defined field that contains the logical terminal ID, or the ID itself enclosed in quotation marks.
Specifies whether this #MREQ is conditional and under what conditions control should be returned to the issuing program.
(Default); specifies that the request is not conditional.
Specifies that the request is conditional. Control is returned if the request cannot be serviced for any of the reasons listed under condition.
Specifies one or more conditions under which the system returns control to the issuing program. Multiple conditions must be enclosed in parentheses and separated by commas. You can specify one or more of the following conditions.
The I/O is interrupted by the terminal operator pressing the ATTENTION (2471) or BREAK (teletype) key during an output operation.
A logical error is encountered in the output data stream.
A permanent I/O error has occurred.
The dial-up line is disconnected or the terminal goes out of service.
There is an invalid parameter in the MRB.
The map load module requested by the MRB cannot be found in the load area of the dictionary.
The requested map does not support the terminal device type being used.
The named edit or code table cannot be found or is invalid for use with the requested map.
An error has occurred in a user-written edit module.
A data conversion error occurs where the internal map data does not match the map data description.
The user-written edit module cannot be found or is invalid for use with the requested map.
(#MREQ OUT only); an undefined DESTID or LTERMID is specified in an #MREQ blast request.
A map paging #MREQ is issued when no paging session is in progress.
Specifies the symbolic name of the routine to which control should be returned if the I/O operation is interrupted by the terminal operator.
Specifies the symbolic name of the routine to which control should be returned if a logical error is detected in the output data stream.
Specifies the symbolic name of the routine to which control should be returned if a permanent I/O error occurs.
Specifies the symbolic name of the routine to which control should be returned if the terminal line or terminal goes out of service.
Specifies the symbolic name of the routine to which control should be returned if the #MREQ cannot be serviced because of an invalid parameter in the MRB.
Specifies the symbolic name of the routine to which control should be returned if the #MREQ cannot be serviced because the map requested by MRB cannot be found.
Specifies the symbolic name of the routine to which control should be returned if the #MREQ cannot be serviced because the terminal device in use is not supported by the requested map.
Specifies the symbolic name of the routine to which control should be returned if an edit or code table cannot be found or is invalid for use with the requested map.
Specifies the symbolic name of the routine to which control should be returned if an error has occurred in a user-written edit module.
Specifies the symbolic name of the routine to which control should be returned if the internal map data does not match the map data description.
Specifies the symbolic name of the routine to which control should be returned if a user-written edit module cannot be found or is invalid for use with the requested map.
(#MREQ OUT only); specifies the symbolic name of the routine to which control should be returned if an undefined DESTID or LTERMID is specified in an #MREQ OUT blast request.
Specifies the symbolic name of the routine to which control should be returned if a map paging #MREQ specification is issued when a no paging session is in progress.
Specifies the symbolic name of the routine to which control should be returned if a condition specified in the COND parameter occurs for which no other exit routine was coded.
(#MREQ OUT and #MREQ OUTIN only); specifies a program-supplied message to be displayed in the map message area. The message text is a 1- to 80-character alphanumeric value. Message-start-location is either a register that points to the message area or the symbolic name of that area. Specify the end of the message in one of the following ways.
Specifies the length, in bytes, of the message output data area. Message-length is a register that contains the length, the symbolic name of a user-defined field that contains the length, or the length itself expressed as a numeric constant.
Specifies the end of the message by referencing the next data item following the message storage area. Message-end-location is a register or a fullword that points to the first data item following the message storage area. This data item may be a dummy byte, a data item not associated with the output data, or the symbolic name of that data item.
|
Copyright © 2014 CA.
All rights reserved.
|
|