SHOW-HOST-ATTRIBUTES / SHHTA: Show host attribute information

You use the SHOW-HOST-ATTRIBUTES command to show detailed host information.

The alias name SHHTA exists for SHOW-HOST-ATTRIBUTES.

This command can be executed with the STD-PROCESSING privilege.

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

List of valid command sources

SHOW-HOST-ATTRIBUTES / SHHTA

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

,INFORMATION = *STD / *BCAM-NAMES / *HOST-NAMES / *STATUS-JV / *ALL

,OUTPUT = *SYSOUT / *SYSLST

HOST-NAME=...
Specifies the name of the host to be shown.

HOST-NAME=*STD
The standard host (normal host) is to be shown.

HOST-NAME=*ALL
All hosts are to be shown.

HOST-NAME=<composed-name 1..8>
Name of the host to be shown.

INFORMATION=...
Defines the type of information.

INFORMATION=*STD
Shows standard host information.

INFORMATION=*BCAM-NAMES
Shows information on the names used in BCAM.

INFORMATION=*HOST-NAMES
Shows a list of the host names.

INFORMATION=*STATUS-JV
Shows the STATUS job variable.

INFORMATION=*ALL
Shows all host information.

OUTPUT=...
Specifies the output medium.

OUTPUT=*SYSOUT
The output is sent to SYSOUT.

OUTPUT=*SYSLST
The output is sent to SYSLST.

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	Operand error
0       32	CMD0221	System error
0       64	BCA0216	Privilege not sufficient
0       64	BCA0203	Interface (&00) returns RC (&01)
0       64	BCA0232	Host entry not found

Examples

Show standard host information:

/SHOW-HOST-ATTRIBUTES HOST-NAME=*STD,INFORMATION=*ALL

Show host information of a virtual host:

/SHOW-HOST-ATTRIBUTES HOST-NAME=VH01
/SHOW-HOST-ATTRIBUTES HOST-NAME=VH01,INFORMATION=*ALL
/SHOW-HOST-ATTRIBUTES HOST-NAME=VH01,INFORMATION=*STATUS-JV

Show host names:

/SHOW-HOST-ATTRIBUTES HOST-NAME=*ALL,INFORMATION=*HOST-NAMES

S variables

The command’s INFORMATION operand defines the S variables to which values are assigned. Possible values for INFORMATION are *ALL, *BCAM-NAMES, *HOST-NAMES, *STATUS-JV and *STD (the values in bold are used in the table).

Output information	Name of the S variable	Data type	Content	Condition
Host name	var(*LIST).HOST-NAME	string	<c-string 1..8>	INF=*ALL/ *STA-JV/ *STD
Socket host name	var(*LIST).SOCKETHOST-NAME	string	*HOST-NAME <c-string 1..32> <text 1..32>	INF=*ALL/ *STD
Maximum message length that the host can receive	var(*LIST).MAX-TSDU-SIZE	integer	<integer 4096..65530>	INF=*ALL
Host type	var(*LIST).TYPE	string	*NORMAL *VIRTUAL	INF=*ALL/ *STD
Status	var(*LIST).ADM-STA	string	*INCLUDED *EXCLUDED *ACTIVE	INF=*ALL/ *STD
Status JV	var(*LIST).STA-JV	string	*NONE <filename>	INF=*ALL/ *STA-JV
Name type	var(*LIST).ELM(*LIST).NAME-TYPE	string	*BCAM *DNS *EOL	INF= *BCAM *ALL
Name	var(*LIST).ELM(*LIST).NAME	string	<text 1..256>	INF= *BCAM *ALL
List of host names	var(*LIST).HOST-NAMES(*LIST)	string	<c-string 1..8>	INF=*HOST