SHOW-PROCESSOR-ATTRIBUTES / SHPRA: Show processor information

You use the SHOW-PROCESSOR-ATTRIBUTES command to output detailed information about a (partner) processor.

The alias name for SHOW-PROCESSOR-ATTRIBUTES is SHPRA.

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

List of valid command sources

SHOW-PROCESSOR-ATTRIBUTES / SHPRA

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

,INFORMATION = *STD / *ALL / *PROCESSOR-NAMES

list-poss(3): *STATE / *PROPERTIES / *BCAM-NAMES

,OUTPUT = *SYSOUT / *SYSLST

PROCESSOR-NAME=...
With PROCESSOR-NAME, you specify the (partner) processor for which information is to be output.

PROCESSOR-NAME=*ALL
Output information for all (partner) processors.

PROCESSOR-NAME=*OWN
Outputs information for the own processor. This command only returns information if the connection was not established via OMNIS.

PROCESSOR-NAME=<composed-name 1..8>
Name of the (partner) processor for which information is to be output.

INFORMATION=...
With INFORMATION, you specify what information is to be displayed.

INFORMATION=*STD
Displays the default information for the (partner) processor.

INFORMATION=*ALL
Displays all the information for the (partner) processor.

INFORMATION=*PROCESSOR-NAMES
Displays the names of the (partner) processors.

INFORMATION=*STATE
Displays the status information of the (partner) processor.

INFORMATION=*PROPERTIES
Displays information about the attributes of the (partner) processor.

INFORMATION=*BCAM-NAMES
Displays information about the names the (partner) processor used in BCAM.

OUTPUT=...
Specifies the output medium.

OUTPUT=*SYSOUT
The output is sent to SYSOUT.

OUTPUT=*SYSLST
The output is sent to SYSLST.

Command logging

Positive acknowledgments result in the required information being output.
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	CMD0216	Privilege not sufficient
0       64	BCA0203	Interface (&00) returns RC (&01).
0       64	BCA0290	Processor entry not found.

Examples

1. Show (partner) processor with name PROC:

   /SHOW-PROCESSOR-ATTRIBUTES PROCESSOR-NAME=PROC,INFORMATION=*STD

2. Show all (partner) processors:

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

3. Show names of all (partner) processors:

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

S variables

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

Output information	Name of the S variable	Data type	Content	Condition
Processor name	var(*LIST).PROCESSOR-NAME	string	<c-string 1..8>	INF=*STD/ *PROP/ *STA/ *BCAM/ *ALL
Socket host name	var(*LIST).SOCKETHOST-NAME	string	*PROCESSOR-NAME <c-string 1..32>	INF=*STD/ *PROP/ *STA/ *BCAM/ *ALL
Administrative status	var(*LIST).STA.ADM	string	*EXCLUDE *INCL *ACTIVE	INF=*STD/ *STA/*ALL
Automatically adopted route	var(*LIST).CRE-BY-AEC	string	*NO *YES	INF=*STD/ *STA/*ALL
Administrative type	var(*LIST).ADM-TYPE	string	*UNKNOWN *BCAM	INF= *PROP/*ALL
Mapping permitted	var(*LIST).MAPPING	string	*ALLOW *NOT-ALLOW	INF= *PROP/*ALL
Selection of routes	var(*LIST).ROUT-SELECT	string	*SEQ-WITH-RETRY *SEQ *BALANCED-WITH-RETRY *BALANCED	INF= *PROP/*ALL
Maximum message length which the host can receive	var(*LIST).MAX-TSDU-SIZE	integer	<integer 4096..65530>	INF= *PROP/*ALL
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 processor names	var(*LIST).PROCESSOR-NAMES(*LIST)	string	<c-string 1..8>	INF=*PROC