Appendix C: Configuring TCP/IP connectivity

Configuration

The configuration CSECT is SYLSCFG.

To build the CSECT, define multiple SYBMLCFG macros and assemble them into your load library. This following sections provide an example SYBMLCFG macro and describe the Sybase listener parameters:

SYBMLCFG macro example

Following is an example of the SYBMLCFG macro.

 SYBMLCFG TRPR={IBM}
    SSID=TCP Stack Identification
    REGID=CICS Region ID
    LSTRAN=Listener Transaction ID
    LSPORT=Listener Port
    CHTRAN=Context Handler Transaction (Gatewayless)
    SCTRAN=Default Security Transaction (Gateway)
    PNTRAN=Name of the Sybase ping transaction
    SFTRAN=CICS 3.3 signoff transaction name for security
    LSECR={Y | N | H}
    GWTRAN=Name of Gateway Security Manager transaction
    PWTRAN=Name of Password Changed transaction
    SOTRAN=CICS 3.3 signon transaction name for security
    TRACE={YES | NO}
    PMODE={GW | GWLESS}

Sybase TCP/IP listener parameters

The following table lists each parameter and its description.

**Table C-1: Sybase TCP/IP listener parameters**
Parameter	Definition
CHTRAN	Context Handler transaction ID for use in a two-tier, gateway-less environment. Required for a two-tier environment (when PMODE=GWLESS). No default. The TCP listener configuration job IxTCP supplied with the distribution specifies SYCH as the context-handler transaction ID. The CHTRAN parameter is ignored if PMODE=GW.
GWTRAN	The name of the Gateway Security Handler transaction.
LSECR	Listener security.The options are: Y – (default) turns on security on for the listener. N – Turns security off for the listener. H – Turns on “hard” security for the listener. This setting prevents the client from connecting to a mainframe resource, preventing the client from wasting time in determining if access has been achieved. If the client has not achieved access, however, the listener can return no specific information concerning the cause of logon failure; the listener can only indicate that the client has not logged on. This setting is useful only for gateway-less connections.
LSPORT	Port for the listener to listen on. Required. No default.
LSTRAN	Listener transaction ID. Required. No default.
PMODE	Processing Mode. Required. No default. The options are: GW—three-tier, gateway-enabled GWLESS—two-tier, gateway-less
PNTRAN	The name of the Sybase ping transaction in CICS. Defaults to SYPG.
PWTRAN	The name of the Password Changed transaction.
SCTRAN	Default Security transaction ID for use in three-tier, gateway-enabled environments. Required for a three-tier environment (when PMODE=GW). No default. This parameter is ignored if PMODE=GWLESS.
SFTRAN	CICS 3.3 sign-off transaction name for security.
SOTRAN	CICS 3.3 sign-on transaction name for security.
SSID	Transport Provider ID. Required. The option for IBM TCP/IP is the TCP/IP jobname or a system symbolic name. System symbolic names are defined in the IEASYMxx PARMLIB member and are limited to seven characters preceded by "&&".
SYBMLCFG	Macro for each listener defined. Required.
SYBMLEND	Ends the listener configuration definition. The END statement is required by the assembler. No default.
TRACE	Turns on the listener trace. Default is no. The options are: yes no
TRPR	Transport Provider. Required. The option for IBM TCP/IP is IBM. The ICS Interlink listener is no longer supported.

View this book as PDF