You use the SHOW-CONNECTION-BY-NAME command to output information about connections which are selected using a name. This command is based on the existing BCAM-SHOW functionality.
SHOW-CONNECTION-BY-NAME may only be employed in interactive mode and is used for diagnostic purposes.
The alias for SHOW-CONNECTION-BY-NAME is SHCNN.
BS2000 console | BS2000 SDF command | Command/SOF file | SNMP management | Parameter service |
x |
List of valid command sources
SHOW-CONNECTION-BY-NAME / SHCNN |
NAME = *OWN / *SELECT / *ALL / <text 1..256> ,INFORMATION=*ALL / *MINIMUM ,OUTPUT = *SYSOUT / <filename_1..54> ,SEARCH = *NONE / <text 0..1800 case sensitive> ,MAX-OBJECT-NUMBER = *STD / <integer 1 .. 2147483647> |
NAME=...
Specifies a host name, processor name or FQDN name for which connection information is to be output.
NAME=*OWN
Processor name under which the interactive task is running.
NAME=*SELECT
Creates a list of SHOW-CONNECTION-BY-NAME commands, which includes all current to the system known processor and DNS names.
NAME=*ALL
Delivers information from all available processors.
NAME=<text 1..256>
Specifies the name.
INFORMATION=...
Specifies the scope of the information output.
INFORMATION=*ALL
All information about a connection is to be output.
INFORMATION=*MINIMUM
Only the information about the storage space currently assigned to a connection is to be output.
OUTPUT=...
Specifies the output medium.
OUTPUT=*SYSOUT
The output is sent to SYSOUT.
OUTPUT=<filename_1..54>
Output takes place to a file with the specified name.
SEARCH=...
specifies the search string that is to be searched for in the output information. Wildcards are supported.
SEARCH=*NONE
There is no search string specified, i.e. the complete command or tool output is shown in SYSOUT format.
SEARCH=<text 0..1800 case sensitive>
String to be searched for. Only (logical) rows that contain the specified string are shown.
MAX-OBJECT-NUMBER=...
Maximum number of objects that may be output for this command.
MAX-OBJECT-NUMBER=*STD
A maximum of 50 objects may be output.
MAX-OBJECT-NUMBER=<integer 1..2147483647>
Maximum number of objects that may be output for this command.
Command logging
Positive acknowledgments result in the required information being output.
A description of the error messages that can be issued during command processing is provided in the table below.
Command return codes
(SC2) | Maincode | Meaning |
| CMD0001 | Command processed successfully |
| CMD0202 | Syntax error |
| BCA0290 | No entry found |
Note
More detailed command return codes are not provided owing to the procedural processing of the command. An output always takes place unless a syntax error was detected in the command.
Example
Show the connection information for a name:
/SHOW-CONNECTION-BY-NAME NAME=MCH1860D