NET/MASTER Network Control Language (NCL) Programmer's Guide

The ASSIGN and DROP Verbs
Working With Mapping Services
10–42 106160 Tandem Computers Incorporated
Switching Maps
You can switch the map that is used to interpret the data in an MDO variable by using
the following syntax of the ASSIGN verb:
ASSIGN [ OPT=VALUE ] MDO= variable-name MAP= map-name
The following example directs Mapping Services to use the map $SEC (rather than the
usual map $MSG) to interpret data in the MDO variable &$MSG.:
ASSIGN OPT=VALUE MDO=&$MSG. MAP=$SEC
Note Switching maps is not recommended since it may produce unpredictable results.
Format 2 of the ASSIGN
Verb
Format 2 of the ASSIGN verb permits many values to follow the OPT keyword. This
syntax is used exclusively with MDO variables and maps.
The following table summarizes the meaning of the MAPNAME, MAPELEMENTS,
MAPFIELDS, MDOELEMENTS, MDOFIELDS, and MDOCOUNTS values, which are
used in Format 2 of the ASSIGN verb:
Value Description
MAPNAME Obtains the name of the map used to interpret an MDO variable.
MAPELEMENTS Obtains the names of the elements defined in a map at the specified level.
MAPFIELDS Obtains the names of the groups or fields defined in a map at the specified
level.
MDOELEMENTS Obtains the names of the elements present in an MDO variable at the specified
level.
MDOFIELDS Obtains the names of the groups or fields present in an MDO variable at the
specified level.
MDOCOUNTS Obtains the number of occurrences of the element, group, or field present in an
MDO variable at the specified level.
Obtaining the Map Name for an MDO Variable
You can obtain the name of the map used to interpret an MDO variable using the
following syntax of the ASSIGN verb:
ASSIGN OPT=MAPNAME
{ ARGS [ RANGE=( start , end ) ] |
VARS={ output-vars-list | variable * }
[ RANGE=( start , end ) ] }
FROM
MDO= variable-name