A MAP AUTOPANEL statement typically is used to perform the following functions:
►►──┬──────────┬─ MAP map-name ──┬───────────────────────────────┬────────────► ├─ ADD ────┤ └─ VERsion ─┬──────┬─ version ──┘ ├─ MODIFY ─┤ ├─ IS ─┤ └─ DELETE ─┘ └─ = ─┘ ►──┬────────────────────────────────────────┬────────────────────────────────► └─ DATETIME ─┬──────┬─ date-time-stamp ──┘ ├─ IS ─┤ └─ = ─┘ ►──┬─────────────────────────────────────────────┬───────────────────────────► └─ MSG PREFIX ─┬──────┬───┬──── DC ◄ ─────────┤ ├─ IS ─┤ └─ message-prefix ──┘ └─ = ─┘ ►── AUTOPANEL DEVices = ─┬─ (device-code) ──────────────────┬────────────────► ├─ (24x80, 32x80, 43x80, 27x132) ◄─┤ └─ ALL ────────────────────────────┘ ►──┬────────────────────────────────┬─────┬─ RESident ──────┬────────────────► └─ SYStem ─┬──────┬─ dc-version ─┘ └─ NONRESident ◄ ─┘ ├─ IS ─┤ └─ = ─┘ ►──┬─────────────────────────────────────────────────────────────────────────► └─ USING ─┬──────────────┬──────────────────────────────────────────────── └┬─ RECORDS ─┬─┘ └─ REC ─────┘ ►─────────────────────────────────────────────────────────────────────────┬──► ┌──────────────────────────────────────────────────────┐ │ ────── ( ─▼─ record-name ─┬───────────┬─┬──────────────────────┬─┴── ) ──┘ └─ version ─┘ └─ ROLEname role-name ─┘ ►──┬──EDIT ◄ ─┬──┬──────────────────────────────┬────────────────────────────► └─ NOEDIT ─┘ └─ CURSOR at panel-field-name ─┘ ►──┬─────────────────────────────┬───┬───────────────────────────────┬───────► ├─ RESET ◄ ─┬─┬──────────────┬┘ ├─ LOCK ────┬─┬───────────────┬─┘ └─ NORESET ─┘ └┬─ MODIFIED ─┬┘ └─ UNLOCK ◄─┘ └┬─ KEYBOARD ─┬─┘ └─ MOD ──────┘ └─ KEY ──────┘ ►──┬─ ALARM ────┬──┬─ STARTPRT ─┬──┬─ NLCR ◄ ┬──┬─ PAGeable ─────┬───────────► └─ NOALARM ◄ ┘ └─ NOPRT ◄ ──┘ ├─ 40CR │ └─ NONPAGeable ◄ ┘ ├─ 64CR │ └─ 80CR ──┘ ►──┬──────────────────────────────────────────┬──────────────────────────────► └─ DECimal point ─┬──────┬───┬─ Comma ───┬─┘ ├─ IS ─┤ └─ Period ◄ ┘ └─ = ─┘ ►─┬──────────────────────────────────────────────────────────────────────────► └─ HELP ─┬─ NO ──────────────────────────────────────────────────────────── └─ LOAD MODule ─┬──────┬─ module-name ──────────────────────────── ├─ IS ─┤ └─ = ─┘ ─►────────────────────────────────────────────────────────────────────────────►─ .──────────────────────────────────────────────────────────────────────────── ─┬────────────────────────────────────────────────────────────────────────── └─ SOUrce ─┬─ NONE ──────────────────────────────────────────────────────── └─ MODule module-name ─┬───────────────────────────────┬──────── └─ version ─┬──────┬─ version ─┘ ├─ IS ─┤ └─ = ─┘ ─►──────────────────────────┬─────────────────────────────────────────────────► ────────────────────────┬─┘ ──────────────────────┬─┘ ────────────────────┬─┘ ─┬─ HALF screen ◄ ┬─┘ └─ FULL screen ──┘ ►────────────────────────────────────────────────────────────────────────────►─ ──────────────────────────────────────────────────────────────────────────── ─┬─────────────────────────────┬──────────────────────────────────────────── └─ HELPKEY ─┬──────┬── PFnn ──┘ ├─ IS ─┤ └─ = ─┘ ►─┬──────────────────────────────────────────────────────────────────────────► └─ ON edit ERROR ──┬─────────────────────────────────────────────────────┬─ └─ INCORRECT fields ATTRibutes = ( attributes-list ) ─┘ ►────────────────────────────────────────────────────────────────────────────► ─┬───────────────────────────────────────────────────┬────────────────────── └─ CORRECT fields ATTRibutes = ( attributes-list ) ─┘ ►────────────────────────────┬───────────────────────────────────────────────► ─┬────────────────────────┬─┘ └─ SOUND ─┬─ ALARM ────┬─┘ └─ NOALARM ◄ ┘ ►─┬─────────────────────────────────────────────────────────────────────┬ . ─►◄ └─ ORIGIN for ─┬─ ALL ─────────────────────┬─┬──────┬─( row column )─┘ │ ┌───────────────┐ │ ├─ IS ─┤ └─ ( ─▼─ device-code ─┴─ ) ─┘ └─ = ──┘
Specifies the action taken with regard to the MAP statement. ADD, MODIFY, and DELETE access for a map is subject to security restrictions specified for the batch compiler and individual maps, as outlined in "Compiler Security".
Specifies the unique 1- through 8-character name for the map being defined, modified, or deleted. The following considerations apply to the composition of map-name:
Optionally specifies a version number to further identify the map. Version-n must be in the range 1 through 9999. If omitted, version-n defaults to the data dictionary version default, as defined by the Data Dictionary Definition Language (DDDL) SET OPTIONS statement.
The map compiler DATETIME clause is returned in map source statements when you use the map utility to decompile a map.
If you use the DATETIME option to decompile a map from one DC system and add it to another system:
Defines the two-character prefix to be used as the default prefix for any MFLD in the map that is defined using the ERROR MESSAGE clause.
Specifies that panel and panel field occurrences are generated automatically when MAP and associated MFLD statements generate map and map field occurrences.
(device-code-a) /(24X80,32X80,43X80,27X132)/ALL specifies the devices with which the map can be used:
Commas must be used to separate device-code-a specifications when more than one device is chosen. Device specifications in the DEVICES clause must be enclosed in parentheses; for example, DEVICES=(12X40,24X80,43X80).
To reserve a map field for use on only a subset of the devices specified in the DEVICES clause, FOR clauses can be included in an MFLD statement for MAP AUTOPANEL. FOR clauses can also be used to specify values or attributes for a field displayed on specific devices.
The MODIFY verb does not update the DEVICES specification.
Note: For more information, see "Compiler Action Verbs".
Specifies the version number of a CA IDMS system with which the map is associated. Dc-version-n is the 1- through 4-character identifier assigned to the system at system generation.
Indicates whether the map load module is resident in storage at system runtime:
(record-name /(record-name version-n) ROLENAME role-name
Specifies the list of predefined schema and/or work records used by the map and optionally specifies role names for records:
If a logical record is being used, the developer names the records containing elements that are part of the logical record and that are used in the map definition. The logical record name is later specified by the dialog or program using the map.
The specified role name can be established in two ways:
Indicates whether automatic editing and error-handling are enabled for the map, as follows:
Note: For more information about enabling and disabling automatic editing, see "Enabling Automatic Editing and Error Handling".
Indicates whether the modified data tags (MDTs) for data fields are reset automatically on a mapout operation:
The MDT/NOMDT specification in the MFLD ATTRIBUTES clause for a field overrides the RESET/NORESET specification for that field if the map-level and field-level specifications differ. If MDT is chosen for a field, the MDT is set on regardless of the RESET MDT specification.
Note: For more information about the MDT/NOMDT setting, see "Attributes for Fields".
Specifies whether the keyboard unlocks automatically after a mapout operation:
Indicates whether a terminal alarm sounds automatically on a mapout operation:
Specifies whether the contents of the printer terminal buffer should be printed automatically upon completion of data transmission on a mapout operation:
Specifies character-per-line formatting for printer output:
These specifications are applicable only if the STARTPRT clause is specified for the map.
Specifies whether the map is pageable:
Note: For more information about pageable maps, see "Pageable Maps".
Specifies the decimal point character for numeric fields on the map:
Specifies whether help will be implemented for the map.
If there is Help for the map, the name of the load module that contains all the help source for the map.
The PFKey designated as the Help key for the map.
The name of the IDD module that contains the help text for the map.
If module name is specified, you can optionally specify:
Defines incorrect-field attributes, correct-field attributes, and alarm status for use when a dialog or map redisplays a map that contains input errors. The following clauses assign error-handling criteria:
Note: Syntax for the attributes-list is discussed in Attributes List.
Note: For more information about syntax for the attributes-list, see Attributes List.
For example, a dialog or program can include code to redisplay a map when an error is detected in a field on mapin. When the display is mapped back out, incorrect-field attributes take effect for fields that are in error, and correct-field attributes take effect for fields that are not in error. The terminal operator can correct the errors and resubmit the map.
Note:
Positions the origin of the runtime map at a row/column location on specified devices:
Parentheses are required when a device code(s) is specified.
Parentheses are required around the row column coordinates.
Copyright © 2013 CA.
All rights reserved.
|
|