dcmapls (Display loaded resources of map file)

Format

dcmapls {{-s|-d|-p} mapping-service-identifier}

Function

The dcmapls command displays the loaded physical maps or PAGEC modules of a map file on the standard output.

The dcmapls command can be used under the TP1/NET/XMAP3 protocol or TP1/NET/HNA-560/20 protocol.

Options

-s

Displays in the standard format.

-d

Displays in the detailed format.

-p

Displays input path names.

Command argument

mapping-service-identifier~<1-8 alphanumerics>

Specifies the mapping service identifier specified in the mapping service attribute definition.

Examples

  1. Display loaded resource information for the mapping service identifier mapservl in the standard format:

    dcmapls -s mapserv1

  2. Display loaded resource information for the mapping service identifier mapservl in the detailed format:

    dcmapls -d mapserv1

Output format

(1) When the -s option is specified

KFCA10888-I    Starts MPS status display.
KFCA10890-I    ii...ii    MAPNAME     pp...pp
KFCA10891-I    mm...mm
KFCA10890-I    ii...ii    MAPPATH     pp...pp
KFCA10891-I    mm...mm
KFCA10890-I    ii...ii    ALTPATH     pp...pp
KFCA10891-I    mm...mm
KFAC10890-I    ii...ii    PGCMNAME    pp...pp
KFCA10891-I    mm...mm
KFCA10890-I    ii...ii    PGCSTDPN    pp...pp
KFCA10891-I    mm...mm
KFCA10890-I    ii...ii    PGCALTPN    pp...pp
KFCA10891-I    mm...mm
KFCA10889-I    Terminates MPS status display.

When the path name specification is omitted from the mapping service attribute definition, only the KFCA10888-I and KFCA10890-I messages are output.

When eight or more map names is displayed for standard physical map input path (MAPPATH) or alternate physical map input path (ALTPATH), the KFCA10891-I message is output immediately after the KFCA10890-I message.

MPS
Mapping service
MAPNAME
Resident physical map input path
MAPPATH
Standard physical map input path
ALTPATH
Alternate physical map input path
PGCMNAME
Resident PAGEC module input path
PGCSTDPN
Standard PAGEC module input path
PGCALTPN
Alternate PAGEC module input path
ii...ii
Mapping service identifier
pp...pp
Path name
mm...mm
Physical map name or PAGEC module name

(2) When the -d option is specified

KFCA10888-I  Starts MPS status display.
KFCA10890-I  ii...ii     MAPNAME   pp...pp
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...1.
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...1.
KFCA10890-I  ii...ii     MAPPATH   pp...pp
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...2.
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...2.
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...2.
KFCA10890-I  ii...ii     ALTPATH   pp...pp
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...2.
KFCA10890-I  ii...ii     PGCMNAME  pp...pp
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...1.
KFCA10890-I  ii...ii     PGCSTDPN  pp...pp
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...2.
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...2.
KFCA10890-I  ii...ii     PGCALTPN  pp...pp
KFCA10892-I  mm...mm  ss...ss     hh...hh   ll...ll   oo...oo       ...2.
KFCA10889-I  Terminates MPS status display.

  1. A physical map specified to be resident or PAGEC module but failed due to an I/O error or other problem during startup of the mapping service is not displayed.
  2. The physical maps managed by LRU or PAGEC modules are displayed from the last-used one.

When the path name specification is omitted from the mapping service attribute definition, only the KFCA10888-I and KFCA10889-I messages are output.

MPS
Mapping service
MAPNAME
Resident physical map reading path
MAPPATH
Standard physical map reading path
ALTPATH
Alternate physical map reading path
PGCMNAME
Resident PAGEC module reading path
PGCSTDPN
Standard PAGEC module reading path
PGCALTPN
Alternate PAGEC module reading path
ii...ii
Mapping service identifier
pp...pp
Path name
mm...mm
Physical map name or PAGEC module name.
sssss
Physical map size or PAGEC module size (decimal)
ss...ss:
Physical map size or PAGEC module size (decimal)
hh...hh
Maintenance information 1 (hexadecimal)
ll...ll
Maintenance information 2 (hexadecimal)
oo...oo
Maintenance information 3 (hexadecimal)

(3) When the -p option is specified

KFCA10888-I    Starts MPS status display.
KFCA10890-I    ii...ii    MAPNAME     pp...pp
KFCA10890-I    ii...ii    MAPPATH     pp...pp
KFCA10890-I    ii...ii    ALTPATH     pp...pp
KFAC10890-I    ii...ii    PGCMNAME    pp...pp
KFCA10890-I    ii...ii    PGCSTDPN    pp...pp
KFCA10890-I    ii...ii    PGCALTPN    pp...pp
KFCA10889-I    Terminates MPS status display.

When the path name specification is omitted from the mapping service attribute definition, only the KFCA10888-I and KFCA10890-I messages are output.

MPS
Mapping service
MAPNAME
Resident physical map input path
MAPPATH
Standard physical map input path
ALTPATH
Alternate physical map input path
PGCMNAME
Resident PAGEC module input path
PGCSTDPN
Standard PAGEC module input path
PGCALTPN
Alternate PAGEC module input path
ii...ii
Mapping service identifier
pp...pp
Path name

Output messages

Message IDDescriptionOutput destination
KFCA10866-IHelp messageStandard output
KFCA10870-ESpecification of an option mode <%s> is invalid.
KFCA10871-ESpecification of a mapping service identifier <%s> is invalid.
KFCA10872-EInvalid command was entered.
KFCA10875-EError occurred in the communication with the mapping service process.
KFCA10877-ENo mapping service identifier <%s> is defined in the mapping service definition file.
KFCA10879-EMapping service has not been activated.
KFCA10881-EDisplay of the map name listing failed.
KFCA10886-EError occurred during command processing.
KFCA10888-IInformation display starts.
KFCA10889-IInformation display terminates.
KFCA10890-IInformation (map identifier, path type, path name) is displayed.
KFCA10891-IInformation (map name, PAGEC module name) is displayed.
KFCA10892-IInformation (name, size, and maintenance information) is displayed.