The BCAM mapping function enables privileged users to display mapping entries. SHOW-MAPPING-ENTRIES is a dialog command.
You use the SHOW-MAPPING-ENTRIES command to generate an overview of the assignments that have been performed. It provides you with information concerning the assignment of specific applications, partners or partner systems.
The alias SHMPE exists for SHOW-MAPPING-ENTRIES.
BS2000 console | BS2000 SDF command | Command/ SOF file | SNMP management | Parameter service |
x |
List of valid command sources
SHOW-MAPPING-ENTRIES / SHMPE Show mapping entries | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SCOPE=...
Specifies the scope of mapping entry output.
SCOPE=*APPLICATION
The scope of mapping entry output is restricted to “local” mapping entries.
SCOPE=*PARTNER
The scope of mapping entry output is restricted to “global” mapping entries.
SCOPE= *BOTH
The scope of mapping entry output is restricted to “special” mapping entries.
SCOPE= *ANY
All mapping entries are output.
SELECT-APPLICATION=...
Defines the selection criterion for the application.
SELECT-APPLICATION=*ALL
No selection criterion is defined for the application.
SELECT-APPLICATION=*BY-ATTRIBUTES(...)
The mapping entries that correspond to the selection criterion for the application are displayed.
APPLICATION=...
Name of the application in the mapping system.
APPLICATION=*ANY
Any application name in the mapping system.
APPLICATION=[*NEA](...)
The name of the application in the mapping system is assigned to a NEA application.
NEA-NAME=*ANY
Any NEA application name.
NEA-NAME=<text 1..16> / <c-string 1..16>
NEA application name.
For the NEA name, you use the first eight characters of the NEA name and the first eight characters of the processor name (one to eight alphanumeric characters in each case, left-justified, and padded with blanks). If the application name is shorter than eight characters, the NEA name must be specified as a C string.
If only the name part containing the NEA name is specified, the part containing the HOST name is derived from the HOST specification when BCAM is started.
APPLICATION=*OSI(...)
The name of the application in the mapping system is assigned to an OSI application.
OSI-NAME=*ANY
Any OSI application name.
OSI-NAME=<text 1..78> / <c-string 1..78> / <x-string 1..156>
OSI application name.
APPLICATION=*SOCKETS(...)
The name of the application in the mapping system is assigned to a SOCKET application.
SOCKET-NAME=*ANY
Any SOCKET application name.
SOCKET-NAME=<text 1..78> / <c-string 1..78> / <x-string 1..156>
SOCKET application name.
HOST-NAME=...
Name of the host on which the application resides.
HOST-NAME=*ANY
Any host name.
HOST-NAME=*STD
Name of the default host defined as the host name on DCSTART/DCOPT.
HOST-NAME=<composed-name 1..8> / <c-string 1..8>
Name of the host.
TSEL-NEA-NAME=...
Name of the NEA T selector.
TSEL-NEA-NAME=*ANY
Any NEA T selector name.
TSEL-NEA-NAME=<text 1..8> / <c-string 1..8>
Name of the NEA T selector.
TSEL-ISO-NAME=...
Name of the ISO T selector.
TSEL-ISO-NAME=*ANY
Any ISO T selector name.
TSEL-ISO-NAME=<text 1..32> / <c-string 1..32> / <x-string 1..64>
Name of the ISO T selector.
PORT-NUMBER=...
The local port number.
PORT-NUMBER=*ANY
Any local port number.
PORT-NUMBER=<integer 1..65535>
Local port number specified as an integer value.
SELECT-PARTNER=...
Defines the selection criterion for the partner application.
SELECT-PARTNER=*ALL
No partner application selection is performed.
SELECT-PARTNER=*BY-ATTRIBUTES(...)
The mapping entries that correspond to the selection criterion are displayed.
PARTNER=...
Name of the partner application in the mapping system
PARTNER=*ANY
Any partner application name in the mapping system.
PARTNER=[*NEA](...)
The name of the partner application in the mapping system is assigned to a NEA application.
NEA-NAME=*ANY
Any NEA partner application name.
NEA-NAME=<text 1..16> / <c-string 1..16>
NEA partner application name.
For the NEA name, you use the first eight characters of the application name and the first eight characters of the end system name.
PARTNER=*OSI(...)
The name of the partner application in the mapping system is assigned to an OSI application.
OSI-NAME=*ANY
Any OSI partner application name.
OSI-NAME=<text 1..78> / <c-string 1..78> / <x-string 1..156>
OSI partner application name.
PARTNER=*SOCKETS(...)
The name of the partner application in the mapping system is assigned to a SOCKET application.
SOCKET-NAME=*ANY
Any SOCKET partner application name.
SOCKET-NAME=<text 1..78> / <c-string 1..78> / <x-string 1..156>
SOCKET partner application name.
PROCESSOR-NAME=...
Name of the processor.
PROCESSOR-NAME=*ANY
Any processor name.
PROCESSOR-NAME=<composed-name 1..8> / <c-string 1..8>
Processor name.
TSEL-NEA-NAME=...
Name of the partner NEA T selector.
TSEL-NEA-NAME=*ANY
Any partner NEA T selector name.
TSEL-NEA-NAME=<text 1..8> / <c-string 1..8>
Name of the partner NEA T selector.
TSEL-ISO-NAME=...
Name of the partner ISO T selector.
TSEL-ISO-NAME=*ANY
Any partner ISO T selector name.
TSEL-ISO-NAME=<text 1..32> / <c-string 1..32> / <x-string 1..64>
Name of the partner ISO T selector.
PORT-NUMBER=...
Partner port number.
PORT-NUMBER=*ANY
Any partner port number.
PORT-NUMBER=<integer 1..65535>
Partner port number specified as an integer value.
OUTPUT=...
Specifies the output destination
OUTPUT=*SYSOUT
The output is sent to SYSOUT.
OUTPUT=*SYSLST
The output is sent to SYSLST.
OUTPUT-FORMAT=...
Specifies the output format.
OUTPUT-FORMAT=*STD
The output format corresponds to the standard.
OUTPUT-FORMAT=*GENERATING-CMD
The output format corresponds to the generated command.
Command logging
Positive acknowledgments result in SHOW output.
A description of the error messages that may be issued during command processing is provided in the table below.
Command return codes
(SC2) | Maincode | Meaning |
| CMD0001 | Command successfully processed |
| CMD0202 | Error in command |
| BCA0200 | System error |
| BCA0201 | System error (internal) |
| BCA0202 | Privilege not sufficient for command |
| BCA0203 | Interface (&00) returns RC (&01) |
| BCA0208 | BCAM mapping not initialized |
| BCA0216 | Entries not found. |
S variables
The command’s SCOPE operand defines the S variables to which values are assigned. Possible values for SCOPE are {*ANY, *APPLICATION, *PARTNER,*BOTH}.
Output information | Name of the S variable | Data type | Content | Condition |
Scope of the mapping entry | var(*LIST).SCOPE | string | *APPLICATION | SCOPE= {...} |
Application type | var(*LIST).APPL-TYPE | string | *NEA | SCOPE= {...} |
Application | var(*LIST).APPL-NAME | string | <text 1..16> | SCOPE= {...} |
Host | var(*LIST).HOST-NAME | string | <composed-name 1..8> | SCOPE= {...} |
NEA T selector | var(*LIST).APPL-TSEL-NEA-NAME | string | <text 1..8> | SCOPE= {...} |
ISO T selector | var(*LIST).APPL-TSEL-ISO-NAME | string | <text 1..32> | SCOPE= {...} |
Port number | var(*LIST).APPL-PORT-NUMBER | integer | <integer 1..65535> | SCOPE= {...} |
Partner application type | var (*LIST).PART-APPL-TYPE | string | *NEA | SCOPE= {...} |
Partner application | var(*LIST).PART-APPL-NAME | string | <text 1..16> | SCOPE= {...} |
Processor | var(*LIST).PROCESSOR-NAME | string | <composed-name 1..8> | SCOPE= {...} |
Partner NEAT selector | var(*LIST).PART-TSEL-NEA-NAME | string | <text 1..8> | SCOPE= {...} |
Partner ISO T selector | var(*LIST).PART-TSEL-ISO-NAME | string | <text 1..32> | SCOPE= {...} |
Partner port number | var(*LIST).PART-PORT-NUMBER | integer | <integer 1..65535> | SCOPE= {...} |
L3 call user data | var(*LIST).L3-CALL-USER-DATA | string | <text 1..16> | SCOPE= {...} |
Route name | var(*LIST).ROUTE-NAME(*LIST) | string | <text 1..8> | SCOPE= {...} |
Generated commands | var(*LIST). GENERATING-CMD(*LIST) | string | <text 1..256> | SCOPE= {...} |
Examples
Show all mapping entries.
/SHOW-MAPPING-ENTRIES SCOPE=*ANYShow local mapping entries.
/SHOW-MAPPING-ATTRIBUTES SCOPE=*APPLICATIONShow global mapping entries.
/SHOW-MAPPING-ATTRIBUTES SCOPE=*PARTNERShow special mapping entries.
/SHOW-MAPPING-ATTRIBUTES SCOPE=*BOTH
It is not usually possible to issue an equivalent BCMAP command since selection is performed differently. BCMAP commands should therefore be avoided in this case.
In principle, the BCMAP command would start as follows:
/BCMAP FUNCT=SHOW,SUBFUNCT=...