Parameter area

The parameter area is supplied by the macro program YDBBXD. The subsections are described below as an aid to understanding.

General format

Distance	Content
0	Function of the exit routine: X'02' - General monitoring of TSAPs
1	Event type: X'01' - Passive connection X'02' - Active connection X'03' - TSAP opened
2	Reserved for later use
3	Reserved for later use
4	TSN of caller

System exit function 02: parameter area, general format

The TSN of the calling application is available on the active establishment of a connection as well as when a TSAP is opened.

The following parameters are supplied if available:

• Source parameters

• Source L3 address

• Destination parameters

• Destination T-selectors

• Destination L3 address

The communication interface triggering the event (DCAM, CMX, SOCKETS), the current connection, and any BCAM mapping entries that are present have an influence on the type and extent of the available parameters.

Source parameters

The source parameters describe the application which

• is actively establishing a connection.

• is opening a TSAP.

Name of the source TSAP

Distance	Content
8	Length of source TSAP name
A	Type of source TSAP name: X'02' - Nea name X'06' - Socket name X'07' - ISO name
B	If type=NEA: name of the source application (8 characters) If type=Socket/ISO: source socket / ISO name (max. 78 characters)
13	If type=NEA: name of the source host (8 characters)
5A	Type of source T-selector: X'80' - Nea T-selector X'10' - OSI T-selector X'01' - Port#
5B	If type=Port#: source port#
5D	Length of source OSI T-selector (if type=OSI)
5E	Source OSI T-selector (if type=OSI)
7E	Source-NEA T-selector (if type=NEA)

System exit function 02: Parameter area, source TSAP

TSAP names are available if connection takes place via BCAM or if corresponding BCAM mapping entries exist.

Depending on any available BCAM (default) mapping entries, more than one local T-selector may be present.

Source L3 address

Distance	Content
86	Type of source L3 address: X'05' - IPv4 X'06' - IPv6
87	Reserved for later use
8A	Source IPv4 address
8E	Source IPv6 address

System exit function 02: parameter area, source L3 address 

In the case of internal BS2000 connections, no source L3 address is available when the connection takes place via BCAM.

Destination parameters

The destination parameters describe the application to which a connection is to be established.

Name of the destination TSAP

Distance	Content
9E	Length of the destination TSAP name
A0	Type of destination TSAP name: X'02' - Nea name X'06' - Socket name X'07' - ISO name
A1	If type=NEA: name of destination application (8 characters)
A9	If type=NEA: name of processor (8 characters)
A1	If type=Socket/ISO: destination socket/ISO name (max. 78 characters)

System exit function 02: parameter area, destination TSAP 

TSAP names are only available if the connection takes place via DCAM or if corresponding BCAM mapping entries exist.

Destination T-selector(s)

Distance	Content
EF	Type of destination T-selector: X'80' - NeaT-selector X'10' - OSI T-selector X'01' - Port#
F0	Destination port# (if type=Port#)
F2	Length of the destination OSI T-selector (if type=OSI)
F3	Destination OSI T-selector (if type=OSI)
113	Destination NEA T-selector (if type=NEA)

System exit function 02: parameter area, Destination T-selector(s) 

Depending on any available BCAM (default) mapping entries, more than one local T-selector may be present.

Destination L3 address

Distance	Content
11B	Type of destination L3 address: X'05' - IPv4 X'06' - IPv6
11C	Reserved for later use
11F	Destination IPv4 address
123	Destination IPv6 address

System exit function 02: parameter area, destination L3 address

In the case of internal BS2000 connections, no source L3 address is available when the connection takes place via BCAM.