SHOW-APPLICATION / SHAP: Output information on applications

You use the SHOW-APPLICATION command to output information on an application.

The alias name SHAP exists for SHOW-APPLICATION.

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

List of valid command sources

SHOW-APPLICATION / SHAP

APPLICATION = *ALL / [*NEA](...) / *OSI(...) / *SOCKETS(...) / *PORT(...) / *NUMBER(...)
	*[NEA](...)
		|	NEA-NAME = <text 1 .. 16> / <c-string 1 .. 16>
	*OSI(...)
		|	OSI-NAME = <text 1 .. 78> / <c-string 1 .. 78> / <x-string 1 .. 156>
	*SOCKETS(...)
		|	SOCKET-NAME = <text 1 .. 78> / <c-string 1 .. 78> / <x-string 1 .. 156>
	*PORT(...)
		|	PORT-NUMBER = <integer 1 .. 65535> / <x-string 1 .. 4>
	*NUMBER(...)
		|	APPLICATION-NUMBER = <integer 0 .. 2147483647> / <x-string 1 .. 8>
,SELECT = *ALL / [*BY-ATTRIBUTES](...)
	[*BY-ATTRIBUTES](...)
		|	JOB-IDENTIFICATION = *ANY / *TID(...) / *TSN(...)
		|		*TID(...)
		|			|	TID = <x-string 1 .. 8>
		|		*TSN(...)
		|			|	TSN = <alphanum-name 1 .. 4>
		|	,INTERFACE = *ANY / *NEA / *ISO / *STREAMS / *SOCKETS
,MAX-MSG-NUMBER = *STD / <integer 1 .. 2147483647>

APPLICATION=...
Name of the application for which information is output.
The information is displayed with console message BCA08E7.

APPLICATION=*ALL
Information for all existing applications is output.

APPLICATION=[*NEA](...)
Information for applications with a NEA application name is output.

NEA-NAME=<text 1..16> / <c-string 1..16>
NEA application name of the application for which information is output.

APPLICATION=*OSI(...)
Information for applications and OSI application names are output.

OSI-NAME=<text 1..78> / <c-string 1..78> / <x-string 1..156>
OSI app5lication name of the application for which information is output.

APPLICATION=*SOCKETS(...)
Information for applications with SOCKET application names is output.

SOCKET-NAME=<text 1..78> / <c-string 1..78> / <x-string 1..156>
SOCKET application name of the application for which information is output.

APPLICATION=*PORT(...)
Information for applications which are identified by means of TCP/IP port numbers is output.

PORT-NUMBER=<integer 1..65535> / <x-string 1..4>
TCP/IP port number of the application for which information is output.

APPLICATION=*NUMBER(...)
Information for applications which are identified by means of BCAM-internal application numbers are output.

APPLICATION-NUMBER=<integer 0..2147483647> / <x-string 1..8>BCAM-internal application number of the application for which information is output.

SELECT=...
Criterion used to search for an application.

SELECT=*ALL
Information for all existing applications is output.

SELECT=[*BY-ATTRIBUTES](...)
Information is output for applications which meet the following criteria.

JOB-IDENTIFICATION=...
Information is output for applications which are logged on under a given task.

JOB-IDENTIFICATION=*ANY
Information for all existing applications is output.

JOB-IDENTIFICATION=*TID(...)
Information is output for applications that were logged on under a given task ID.

TID=<x-string 1..8>
Information is output for applications that were logged on under this task ID.

JOB-IDENTIFICATION=*TSN(...)
Information is output for applications that were logged on under a given TSN.

TSN=<alphanum-name 1..4>
Information is output for applications that were logged on under this TSN.

INTERFACE=...
Information is output for applications which use a specific interface functionality.

INTERFACE=*ANY
Information for all existing applications is output.

INTERFACE=*NEA
Information for applications that use NEA interface functionality is output.

INTERFACE=*ISO
Information for applications that use NEA ISO functionality is output.

INTERFACE=*STREAMS
Information for applications that use STREAMS (SOCKETS) interface functionality is output.

INTERFACE=*SOCKETS
Information for applications that use STREAMS (SOCKETS) interface functionality is output.

MAX-MSG-NUMBER=...
Maximum number of messages that may be output for this command.

MAX-MSG-NUMBER=*STD
A maximum of 50 messages may be output at SYSOUT and a maximum of 10 at the console.

MAX-MSG-NUMBER=<integer 1..2147483647>
Maximum number of messages that may be output for this command.

The number of messages issued can be exceeded when information is output because of the restricted output length of a message.
Multiple messages are frequently output for BCAM objects. Within BCAM these messages are counted as just one message.
In some cases the message BCA0765 is also issued in order to facilitate the assignment of the output information to the specified command.

Command logging

Positive acknowledgments are supplied in news BCA0720 and negative acknowledgments in news BCA0728 followed by the message NBR0740. If processing is positive the message BCA08E7 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)      SC1	Maincode	Meaning
0        0	CMD0001	Command successfully processed
0        1	CMD0202	Error in command
0        1	BCA0768	Syntax error in command
0       64	BCA0791	Application not found
0       64	BCA08EF	Nothing found to display
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      128	BCA0766	BCAM is not active

Example

Display applications

/SHOW-APPLICATION

Equivalent BCSHOW command:

/BCSHOW SHOW=APPLICATION