Using the BCMON command, you control cyclic BCAM monitoring and output the desired values at regular intervals. At the same time, you can modify the default cycle time. Each monitor function can be individually controlled via the RECORD operand; the SEC specifications used here apply for the individual monitor function.
The values are displayed on the console and also written to the log file ($SYSAUDIT.SYS.CONSLOG.<date>.<counter>), so that the values can be evaluated later.
BS2000 console | BS2000 SDF command | Command/ SOF file | SNMP management | Parameter service |
x | x | x |
List of valid command sources
BCMON | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
MODE=ON ,...
Specifies that monitoring is switched on.
RECORD=...
Specifies monitor function for which data is output.
Apart from the values STD and *ALL, the remaining values can also be specified as a list (list-poss).
RECORD=STD
The specification of STD is a summary of the individual specifications:
TRANSFER
RES-MEMORY
PAG-MEMORY
CONNECTIONS
RECORD=*ALL
Output occurs for all monitor functions.
RECORD=TRANSFER
The values relevant for connection-oriented data transfer are output with the console message BCA0B20.
RECORD=RES-MEMORY
The values relevant for the resident data memory are output with the console message BCA0B21.
RECORD=PAG-MEMORY
The values relevant for the pageable memory are output with console message BCA0B23.
RECORD=TR-DATA
The values relevant for connection-oriented data transfer are output with the console message BCA0B32 (itemized according to local, remote and LOOPBACK).
RECORD=CONNECTIONS
The values relevant for transport connections are output with console message BCA0B22:
APM | Number of opened applications, where multiple openings are often counted accordingly. | |
APP | Number of opened applications | |
CON | Number of connections | |
CON, APP, and APM are the maximum values during the monitoring period.
RECORD=DATAGRAM
The values relevant for connectionless data transfer are output with console message BCA0B40:
Input (total) | Number of all UDP fragments in the input direction |
Unknown Port# | Number of UDP fragments in the input direction to the unknown port# |
Error | Number of incorrect UDP fragments in the input direction |
Output | Number of all UDP fragments in the output direction |
RECORD=LOOPBACK
The values relevant for Layer 4 (itemized according to LOOPBACK) are output with the console message BCA0B41.
RECORD=LAYER4 / L4
The values relevant for Layer 4 are output with console message BCA0B30.
RECORD=ROUTING
The values relevant for routing are output with console message BCA0B24.
RECORD=MODIFY-CONNECTION
The values relevant for the establishment of a connection are output with console message BCA0B31:
ACTIVE | OK | Number of successful active connection attempts |
ACTIVE | FAILURE | Number of failed active connection attempts |
PASSIVE | OK | Number of successful passive connection attempts |
PASSIVE | FAILURE | Number of failed passive connection attempts |
RECORD=SIH-TIME
The values relevant for SIH-TIME are output with the console messages BCA0B60, BCA0B61 and BCA0B62.
RECORD=LAYER2 / L2
The relevant values of all lines (normal and VLAN lines) for Layer 2 are output with console messages BCA0B10, BCA0B11, BCA0B15, BCA0B16, BCA0B17, BCA0B18 and BCA0B19. Specifying LINE restricts output to one line. Specifying INFO restricts output to one subset.
LINE=...
Name of the line (normal lines, not VLAN lines) for which values relevant for Layer 2 are evaluated.
LINE= *all
The output of the values relevant for Layer 2 takes place for all lines (normal lines, not VLAN lines) .
LINE=<line-name 1..8>
The output of the values relevant for Layer 2 takes place for the (normal) line defined with line-name.
INFO=...
A subset of values relevant for Layer 2 is evaluated. This specification only applies to LAN lines.
INFO=*ALL
All values relevant for Layer 2 are output (the IO-TIME values are excepted).
INFO=BYTES
Only values relevant for BYTEs are output (message BCA0B15 or alternately BCA0B10).
INFO=UNICASTS
Only values relevant for UNICASTs are output (message BCA0B16 or BCA0B56).
INFO=ERRORS
Only values relevant for ERRORs are output (message BCA0B18 or alternately BCA0B11).
INFO=IO-TIME
Only the values relevant for IO-TIME are output (message BCA0B19).
RECORD=VLAN-DEVICE
The values of all VLAN devices which are relevant for VLAN-DEVICE are output with console messages BCA0B5C, BCA0B5D, BCA0B5E and BCA0B5F . Specifying DEVICE restricts output to one VLAN device. Specifying INFO restricts output to one subset of the values.
DEVICE=...
Name of the VLAN device for which values relevant for the VLAN devices are evaluated.
DEVICE= *all
The output of the values relevant for the VLAN devices takes place for all VLAN devices.
DEVICE=<device-name 1..8>
The output of the values relevant for the VLAN devices takes place for the VLAN device defined with device-name.
DEVICE=*BY-AGGREGATION(...)
The output of the values relevant for the VLAN devices takes place via the aggregation names assigned to them.
AGGREGATION= *all / <aggregation-name 1..8>
The output of the values relevant for the VLAN devices takes place for the devices addressed with aggregation-name.
INFO=...
A subset of the values relevant for the VLAN devices is evaluated. This specification only applies for VLAN devices.
INFO=*ALL
All values relevant for Layer 2 are output (the IO-TIME values are excepted).
INFO=BYTES
Only values relevant for BYTEs are output (message BCA0B5A).
INFO=UNICASTS
Only the values relevant for UNICAST are output (message BCA0B5D).
INFO=ERRORS
Only values relevant for ERRORs are output (message BCA0B5E).
INFO=IO-TIME
Only the values relevant for IO-TIME are output (message BCA0B5F).
RECORD=VLAN-LINE
The values of all VLAN lines which are relevant for Layer 2 are output with console messages BCA0B50 and BCA0B51. Specifying LINE restricts output to one VLAN line. Specifying INFO restricts output to a subset of the values.
LINE=...
Name of the VLAN line for which values relevant for Layer 2 are evaluated.
LINE= *all
The output of the values relevant for Layer 2 takes place for all VLAN lines.
LINE=<line-name 1..8>
The output of the values relevant for Layer 2 takes place for the VLAN line defined with line-name.
LINE=*BY-DEVICE(...)
The output of the values for VLAN lines which are relevant for Layer 2 takes place via the device-names assigned to them.
DEVICE= *all / <device-name 1..8>
The output of the values relevant for Layer 2 takes place for the VLAN line addressed with device-name.
LINE=*BY-AGGREGATION(...)
The output of the values for VLAN lines which are relevant for Layer 2 takes place via the aggregation names assigned to them.
AGGREGATION= *all / <aggregation-name 1..8>
The output of the values relevant for Layer 2 takes place for the VLAN lines addressed with aggregation-name.
INFO=...
A subset of the values relevant for Layer 2 is evaluated. This specification only applies for LAN lines.
INFO=*ALL
All values relevant for Layer 2 are output.
INFO=BYTES
Only values relevant for BYTEs are output (message BCA0B50).
INFO=ERRORS
Only values relevant for ERRORs are output (message BCA0B51).
SEC=<integer 5..32765>
Specifies the monitoring period in seconds, after which the values are to be output. The specified value is rounded up to a multiple of 5.
Default: 600 sec
MODE=OFF,...
This operand specifies that monitoring for the specified RECORD function is switched off.
RECORD=...
Specifies which monitor functions are switched off.
Apart from the values *ALL and STD, the remaining values can also be specified as a list (list-poss).
RECORD=*ALL
All monitor functions are to be switched off.
RECORD=STD
The output of values relevant for data transfer (TRANSFER), data memory (RES-MEMORY and PAG-MEMORY), and connections (CONNECTIONS) is switched off.
RECORD=TRANSFER
The output of values relevant for connection-oriented data transfer is switched off.
RECORD=RES-MEMORY
The output of values relevant for resident data memory is switched off.
RECORD=PAG-MEMORY
The output of values relevant for pageable memory is switched off.
RECORD=CONNECTIONS
The output of values relevant for transport connections is switched off.
RECORD=DATAGRAM
The output of values relevant for connectionless data transfer is switched off.
RECORD=LAYER4 / L4
The output of values relevant for Layer 4 is switched off.
RECORD=ROUTING
The output of values relevant for routing is switched off.
RECORD=MODIFY-CONNECTION
The output of values relevant for connection activities is switched off.
RECORD=SIH-TIME
The output of values relevant for SIH-TIME is switched off.
RECORD=LAYER2 / L2
The output of values relevant for Layer 2 is switched off.
LINE=...
Name of the line for which the values relevant for Layer 2 are switched off.
LINE= *all
The output of values relevant for Layer 2 is switched off for all lines.
LINE=<line-name 1..8>
The output of values relevant for Layer 2 is switched off for the line defined with <line-name>.
INFO=...
A subset of values relevant for Layer 2 is switched off. This specification only applies to LAN lines.
INFO=*ALL
All values relevant for Layer 2 (including IO-TIME) are switched off.
INFO=BYTES
Only values relevant for BYTEs are switched off.
INFO=UNICASTS
Only values relevant for UNICASTs are switched off.
INFO=ERRORS
Only values relevant for ERRORs are switched off.
INFO=IO-TIME
Only values relevant for IO-TIME are switched off.
RECORD=VLAN-DEVICE
The output of the values relevant for the VLAN devices is switched off.
DEVICE=...
Name of the VLAN device for which output of the values relevant for the VLAN devices is switched off.
DEVICE= *all
The output of values relevant for VLAN is switched off for all VLAN devices.
DEVICE=<device-name 1..8>
The output of values relevant for VLAN is switched off for the VLAN devices defined with <device-name>.
DEVICE=*BY-AGGREGATION(...)
The output of the values relevant for the VLAN devices is switched off via the aggregation names assigned to them.
AGGREGATION= *all / <aggregation-name 1..8>
The output of the values relevant for the VLAN devices is switched off for the devices addressed with aggregation-name.
INFO=...
The output of a subset of the values relevant for the VLAN devices is switched off. This specification only applies for VLAN devices.
INFO=*ALL
The output of all values relevant for Layer 2 (including IO-TIME) is switched off.
INFO=BYTES
Only the output of values relevant for BYTEs is switched off.
INFO=UNICASTS
Only the output of values relevant for UNICASTS is switched off.
INFO=ERRORS
Only the output of values relevant for ERRORs is switched off.
INFO=IO-TIME
Only the output of values relevant for IO-TIME is switched off.
RECORD=VLAN-LINE
The output of the values of VLAN lines relevant for the Layer 2 is switched off.
LINE=...
Name of the VLAN line(s) for which the output of values relevant for Layer 2 is switched off.
LINE= *all
The output of values relevant for Layer 2 is switched off for all VLAN lines.
LINE=<line-name 1..8>
The output of values relevant for Layer 2 is switched off for the VLAN line defined with line-name.
LINE=*BY-DEVICE(...)
The output of values for VLAN lines that are relevant for Layer 2 is switched off via the device-names assigned to them.
DEVICE= *all / <device-name 1..8>
The output of values relevant for Layer 2 is switched off for the VLAN lines addressed with device-name.
LINE=*BY-AGGREGATION(...)
The output of the values for VLAN lines which are relevant for Layer 2 is switched off via the aggregation names assigned to them.
AGGREGATION= *all / <aggregation-name 1..8>
The output of the values relevant for Layer 2 is switched off for the VLAN lines addressed with aggregation-name.
INFO=...
The output of a subset of the values for VLAN lines that is relevant for Layer 2 is switched off.
INFO=*ALL
The output of all values for VLAN lines that are relevant for Layer 2 is switched off.
INFO=BYTES
Only the output of values for VLAN lines that are relevant for BYTEs is switched off.
INFO=ERRORS
Only the output of values for VLAN lines that are relevant for ERRORs is switched off.
Command logging
For reasons of compatibility, the processing acknowledgment is supplied in news BCA0763 if it is positive and in news BCA0762 if it is negative, followed by the message NBR0740. In addition, for positive acknowledgments, the messages BCA0B10, BCA0B11, BCA0B15, BCA0B16, BCA0B18, BCA0B20, BCA0B21, BCA0B22, BCA0B23, BCA0B24, BCA0B30, BCA0B40, BCA0B5C, BCA0B5D, BCA0B5E, BCA0B5F, BCA0B50, BCA0B51, BCA0B60, BCA0B61 and BCA0B62 may also appear.
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 |
| BCA062B | Enable monitoring |
| BCA0635 | Disabling of monitoring aborted |
| BCA0768 | Syntax error in command |
| BCA07A2 | Line unknown |
| BCA083A | VLAN device unknown |
| BCA07A6 | No VLAN device found for the link aggregation |
| BCA083D | VLAN line unknown |
| BCA07AB | No VLAN line found for the link aggregation |
| BCA07AC | No VLAN line found for the VLAN device |
| BCA0814 | BCAM is being terminated abnormally |
| BCA0816 | BCAM is terminating |
| BCA0766 | BCAM is not active |