SHOW-DNS-ACCESS / SHDNA: Show information about DNS access in BCAM

You use the SHOW-DNS-ACCESS command to output information about the DNS Resolver and access to DNS data in BCAM and in particular restrictions relating to DNS access.

The SDF alias name SHDNA exists for SHOW-DNS-ACCESS.

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

List of valid command sources

SHOW-DNS-ACCESS / SHDNA

SELECT = *ALL / list-poss (8): *DNS-RESOLVER / *IP-ADDRESS-RANGE / *IPV6-ADDRESS-RANGE /

*NAMES / *LIMITS / *OPTIONS

,OUTPUT = *SYSOUT / *SYSLST

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

SELECT=...
Selects the information that is to be output.

SELECT=*ALL
Displays the IP and IPv6 address ranges as well as the namespace which is to be permitted for access to DNS data.

SELECT=*DNS-RESOLVER
Displays which DNS Resolver is currently set to access DNS data.

SELECT=*IP-ADDRESS-RANGE
Displays the IP address ranges which are permitted for access to DNS data.

SELECT=*IPV6-ADDRESS-RANGE
Displays the IPv6 address ranges which are permitted for access to DNS data.

SELECT=*NAMES
Displays the namespace which is permitted for access to DNS data.

SELECT=*LIMITS
Displays the number of possible table entries.

SELECT=*OPTIONS
Displays the DNS options for access to DNS data.

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 default.

OUTPUT-FORMAT=*GENERATING-CMD
The output corresponds to the generating commands.

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 processed successfully
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

Displays of access to DNS data in BCAM:

/SHOW-DNS-ACCESS SELECT=*ALL
/SHOW-DNS-ACCESS SELECT=*DNS-RESOLVER
/SHOW-DNS-ACCESS SELECT=*OPTIONS
/SHOW-DNS-ACCESS SELECT=*IP-ADDRESS-RANGE,OUTPUT=*SYSLST
/SHOW-DNS-ACCESS SELECT=*IPV6-ADDRESS-RANGE,OUTPUT=*SYSLST
/SHOW-DNS-ACCESS SELECT=*NAMES,OUTPUT=*SYSLST

S variables

The command’s SELECT operand specifies which S variables are to be assigned values. Possible values for SELECT are *ALL, *IP-ADDRESS-RANGE, *IPV6-ADDRESS-RANGE, *NAMES, *DNS-RESOLVER, *LIMITS and *OPTIONS.

Output information	Name of the S variable	Data type	Content	Condition
Access to DNS data in BCAM	var(*LIST).OPTION.DNS-USAGE	string	*OFF *ON	SEL= *ALL/*OPT O-F=*STD
Number of permitted entries	var(*LIST).MAX-DNS-ACC-ENTR	integer	<integer 1..65535>	SEL= *LIM/*OPT O-F=*STD
PORT number indicator	var(*LIST).DNS-RESOLVER.PORT-IND	string	*STD *VALUE	SEL= *ALL/*DNS O-F=*STD
PORT number which is set for the DNS Resolver	var(*LIST).DNS-RESOLVER.PORT-NUM	integer	<integer 1..65535>	SEL= *ALL/*DNS O-F=*STD
IP address indicator	var(*LIST).DNS-RESOLVER-IND	string	*STD *NONE *VALUE	SEL= *ALL/*DNS O-F=*STD
IP address set for the DNS Resolver	var(*LIST).DNS-RESOLVER.IP-ADDR	string	<c-string 7..15>	SEL= *ALL/*DNS O-F=*STD
IPv6 address indicator	var(*LIST).DNS-RESOLVER-IPV6-IND	string	*STD *NONE *VALUE	SEL= *ALL/*DNS O-F=*STD
IPv6 address which is set for the DNS Resolver	var(*LIST).DNS-RESOLVER.IPV6-ADDR	string	<c-string 3..45>	SEL= *ALL/*DNS O-F=*STD
Permitted IP addresses for access to DNS data (all, none or address range)	var(*LIST).IP-ADDR.INDICATOR	string	*ALL *NONE *ADD	SEL= *ALL/*IP O-F=*STD
Start of range of permitted IP addresses for access to DNS data	var(*LIST).IP-ADDR.RANGE(*LIST).FROM	string	<c-string 7..15>	SEL= *ALL/*IP O-F=*STD
End of range of permitted IP addresses for access to DNS data	var(*LIST).IP-ADDR.RANGE(*LIST).TO	string	<c-string 7..15>	SEL= *ALL/*IP O-F=*STD
Permitted IPv6 addresses for access to DNS data (all, none or address range)	var(*LIST).IPV6-ADDR.INDICATOR	string	*ALL *NONE *ADD	SEL= *ALL/*IPV6 O-F=*STD
Permitted IPv6 addresses for access to DNS data (specified via IPv6 prefix)	var(*LIST).IPV6-ADDR.IPV6-PREFIX(*LIST)	string	<c-string 9..49>	SEL= *ALL/*IPV6 O-F=*STD
Permitted names for access to DNS data (all, none or namespace)	var(*LIST).NAMES.INDICATOR	string	*ALL *NONE *ADD	SEL= *ALL/*NAM O-F=*STD
Namespace of processors which are permitted for access to DNS data	var(*LIST).NAMES.PROCESSOR-NAME(*LIST)	string	<c-string 1..8>	SEL= *ALL/*NAM O-F=*STD
Generating commands	var(*LIST).GENERATING-CMD(*LIST)	string	<text 1..256>	SEL=<any> O-F=*GEN