SHOW-MAPPING-STATUS / SHMPS: Show mapping information

You use the SHOW-MAPPING-STATUS command to output the mapping status information. SHOW-MAPPING-STATUS is a dialog command.

The command broadly corresponds to the “old” command
BCMAP FUNCT=SHOW,SUBFUNCT=STATE.

The alias SHMPS exists for SHOW-MAPPING-STATUS.

BS2000 console	BS2000 SDF command	Command/ SOF file	SNMP management	Parameter service
	x

List of valid command sources

SHOW-MAPPING-STATUS / SHMPS                                                                                                    

INFORMATION = *SUMMARY / *HOSTS

,OUTPUT = *SYSOUT / *SYSLST

,OUTPUT-FORMAT = *STD / *GENERATING-CMD

INFORMATION=...
Defines the type of information.

INFORMATION=*SUMMARY
Certain mapping values, for example the number of current mapping entries, are output.

INFORMATION=*HOSTS
The host names for which mapping entries exist are output.

OUTPUT=...
Specifies the output medium.

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

A description of the error messages that may be issued during command processing is provided in the table below.

Command return codes

(SC2)      SC1	Maincode	Meaning
0        0	CMD0001	Command successfully processed
0        1	CMD0202	Error in command
0       64	BCA0200	System error
0       64	BCA0201	System error (internal)
0       64	BCA0202	Privilege not sufficient for the command
0       64	BCA0203	Interface (&00) returns RC (&01).
0       64	BCA0208	BCAM mapping not initialized
0       64	BCA0215	Operand suppressed
0       64	BCA0222	No host entry found in BCAM mapping

Examples

Show mapping status information.

/SHOW-MAPPING-STATUS INFORMATION=*SUMMARY
/SHOW-MAPPING-STATUS INFORMATION=*HOSTS,OUTPUT=*SYSLST

The equivalent BCMAP command returns both types of information (output in the form of messages):

/BCMAP FUNCT=SHOW,SUBFUNC=STATE

S variables

The command’s INFORMATION operand defines the S variables to which values are assigned. Possible values for INFORMATION are SUMMARY and HOSTS.

Output information	Name of the S variable	Data type	Content	Condition
Maximum number of possible mapping entries	var(*LIST).MAX-NUMB-ENTRIES	integer	<integer 1..1000000>	INF= *SUMMARY O-F=*STD
Current number of mapping entries	var(*LIST).CUR-NUMB-ENTRIES	integer	<integer 1..1000000>	INF= *SUMMARY O-F=*STD
Queue length	var(*LIST).MAX-QUEUE-LENGTH	integer	<integer 1..1000000>	INF= *SUMMARY O-F=*STD
Host name	var(*LIST).HOST-NAME(*LIST)	string	<composed-name 1..8>	INF= *HOSTS O-F=*STD
Generated command	var(*LIST).GENERATING-CMD	string	„ <text 1..256>	INF= *SUMMARY O-F=*GEN