MAP COMMAND [ HP System Dictionary XL Gen. Ref. Vol. 2-Part 3 SDCONV ] MPE/iX 5.0 Documentation
HP System Dictionary XL Gen. Ref. Vol. 2-Part 3 SDCONV
MAP COMMAND
The MAP command allows you to specify new values for characters contained
in the names stored in Dictionary/V which are not allowed in System
Dictionary names. The MAP command has the following format:
MAP [character [mapping]] [.]
If MAP is issued with no fields, a display of the current set of mappings
is produced, including the default value for illegal characters. If only
the character field is specified, then any existing mapping for that
character is deleted. If a request is made for deletion of a nonexistent
mapping, a warning message is issued.
When both character and mapping are specified, SDCONV adds this new
mapping to its set of mappings for special characters. If a mapping
already exists, then the previous one is replaced with the new one. When
SDCONV retrieves a name from Dictionary/V, it searches the mapping table
and replaces any occurrences of special characters with their
corresponding map values found in the table.
Each character mapping may have a maximum length of 12 characters. If
replacement of characters with their mapping values causes the name to
become longer than 32 characters, the name is truncated to 32 characters
and a warning message is issued. There may be a total of 32 mappings
specified in the map table, including the default mappings for the 13
illegal characters mentioned above.
CHARACTER Field
The special character to be mapped. It may be enclosed within double
quotation marks (""), if desired. However, if either a blank or a period
is desired, then double quotes are required. If a period is desired as
the special character to be mapped and it is not enclosed within double
quotes, the command will be interpreted as the MAP command without any
parameters, causing the program to display the current state of the map
table. If a single double quote (") is desired as the character to be
mapped, it must be entered as two double quotation marks ("") enclosed
within a pair of double quotation marks, i.e., (" " " ").
MAPPING Field
The mapping to be associated with the character field. It may be up to
12 characters in length and may not be surrounded by double quotation
marks. This field must also contain only those characters valid in
System Dictionary names. The following characters which are illegal in
System Dictionary will automatically have a default value assigned to
them: , ; : . ( ) " = < > ^ ! plus the space character. These defaults
are listed below:
Special Character Default Value
---------------------------------------------------------------------------------------
, -COM-
; -SC-
: -COL-
. -DOT-
( -LP-
) -RP-
" -DQ-
= -EQ-
> -GT-
< -LT-
^ -UA-
! -EX-
Space -SP-
You may change these default values, but should be careful not to delete
them. If an illegal character is encountered during loading, but does
not have a mapping defined, then a warning message will be issued.
Example. The following examples map the special character "(" into the
string "L-PAREN".
>MAP ( L-PAREN.
>MAP "(" L-PAREN
MPE/iX 5.0 Documentation