SHOW-BCAM-NAMES / SHBCNA: Show information on BCAM names

You use the /SHOW-BCAM-NAMES command to show information on the names used in BCAM, the association between the BCAM and domain or alias name being established in the process.

The alias name SHBCNA exists for SHOW-BCAM-NAMES.

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

List of valid command sources

SHOW-BCAM-NAMES / SHBCNA

NAME = *ALL / *DNS(...) / *BCAM(...) / *SOCKETHOST(...)
	*DNS(...)
		|	DNS-NAME = <c-string 1 .. 256>
	*BCAM(...)
		|	BCAM-NAME = *ALL / <composed-name 1 .. 8>
	*SOCKETHOST(...)
		|	SOCKETHOST-NAME = *ALL / <composed-name 1 .. 32>
,OBJECT-TYPE = *ANY / *HOST / *PROCESSOR
,INFORMATION = *STD / *ALL / list-poss (3): *DNS-NAMES / *BCAM-NAMES / *SOCKETHOST-NAMES
,OUTPUT = *SYSOUT / *SYSLST

NAME=...
Name of a name type for which information on name associations is shown.

NAME=*ALL
Name associations are shown for all BCAM names.

NAME=*DNS(...)
The DNS names and the associated name associations are to be shown.

DNS-NAME= <c-string 1..256>
DNS name.

NAME=*BCAM(...)
The BCAM names and the associated name associations are to be shown.

BCAM-NAME= *ALL / <composed-name 1..8>
BCAM name.

NAME=*SOCKETHOST(...)
The socket host names and the associated name associations are to be shown.

SOCKETHOST-NAME= *ALL / <composed-name 1..32>
Socket host name.

OBJECT-TYPE= *ANY / *HOST / *PROCESSOR
Object type.

INFORMATION=...
Selects which information is to be shown.

INFORMATION=*STD
Shows the DNS names and the associations with the BCAM names which are used in BCAM.

INFORMATION=*ALL
Shows the DNS names and alias names and the associations with the BCAM names and socket host names which are used in BCAM.

INFORMATION=*DNS-NAMES
Shows which domain names and alias names are used in BCAM for hosts or processors.

INFORMATION=*BCAM-NAMES
Shows which BCAM names are used in BCAM for hosts or processors.

INFORMATION=*SOCKETHOST-NAMES
Shows which socket host names are used in BCAM for hosts or processors.

OUTPUT=...
Specifies the output medium.

OUTPUT=*SYSOUT
Output takes place to SYSOUT.

OUTPUT=*SYSLST
Output takes place to SYSLST.

Command logging

A description of the error messages that can 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	Operand error
0       32	CMD0221	System error
0       64	CMD0216	Privilege not sufficient
0       64	BCA0203	Interface (&00) returns RC (&01)

Examples

1. Show the names in BCAM with the specification of the DNS name:

   /SHOW-BCAM-NAMES NAME=*DNS(DNS-NAME=’mgphugo.mgp.example.net’)

2. Show all names in BCAM:

   /SHOW-BCAM-NAMES NAME=*BCAM(BCAM-NAME=*ALL)

S variables

The command’s INFORMATION operand defines the S variables to which values are assigned. Possible values for INFORMATION are *STD, *ALL, *DNS-NAMES, *BCAM-NAMES and *SOCKETHOST-NAMES.

Output information	Name of the S variable	Data type	Content	Condition
Object type in the sense of a BCAM object	var(*LIST).OBJ.TYPE	string	*HOST *PROC	INF= *STD, *DNS, *BCAM, *SOCKET, *ALL
Host name	var(*LIST).OBJ.HOST-NAME	string	<text 1..8>	INF= *BCAM *ALL
Processor name	var(*LIST).OBJ.PROCESSOR-NAME	string	<text 1..8>	INF= *BCAM *ALL
Socket host name	var(*LIST).OBJ.SOCKETHOST-NAME	string	<text 1..32>	INF= *SOCKET *ALL
Name type	var(*LIST).ELM(*LIST).NAME-TYPE	string	*BCAM *DNS *EOL	INF= *DNS *ALL
Name	var(*LIST).ELM(*LIST).NAME	string	<text 1..256>	INF= *DNS *ALL

The content parameter *EOL means "end of list" and expresses, that there is no more informational data left.