Customizing the CWI Server Module

XTR5S003

The Server Control Template (SCT) is customized using the XTR5S003 macro.

Syntax

 XTR5S003 TIMEOUT= < seconds until timeout-session-cleanup>,  X
       CTRAN=      < cleanup-transaction-id >,                X
       VPASS=      < include SAF authentication >,            X
       CPASS=      < include SAF password-changes >,          X
       DPLS=       < include support for TCP CICS CONNECTOR>, X 
       SYSID       < allow DPL to MRO attached CICS systems>, X 
       FCBM        < allow access CICS memory for debugging>

Parameters

Name Description
TIMEOUT
nnnn
Number of seconds after which the session control blocks will be freed. This timeout-cleanup applies to all traffic except DPLS (Distributed-Program-Link-Sideband). DPLS is sessionless and stateless, therefore there are no control blocks to be freed.
CTRAN
tran
A four-character transaction identification to be used to dispatch the timeout-session-cleanup. Attachmate recommends "AQCC" but any available transaction ID can be configured.
VPASS
NO | YES
Extended API support allowing client applications to interface with the Secondary-Authentication Facility (SAF); for example, RACF running on the host to authenticate client requesters.

This parameter is reserved for future use and defaults to "NO." Services Builder for CICS TCP/IP feature traffic interacts with SAF during DPL allowing only authorized users access to host programs without need for an auxiliary API.

CPASS
NO | YES
Extended API support allowing client applications to interface with the Secondary-Authentication Facility (SAF); for example, RACF running on the host thus allowing an authorized user to change the password for a given user. This parameter is reserved for future use and defaults to "NO."
DPLS
YES | NO
Configure host-based component to allow sideband (sessionless) Distributed-Program-Link to call a CICS application program. This is the mechanism that Services Builder for CICS uses when making a DPL call over a configured TCP/IP link. This parameter must be set to "YES" for Services Builder for CICS to make non-SNA based links to host programs residing on CICS TS v. 1.3 or later systems.
SYSID
NO | YES
Extended API support allowing client applications to DPL via the CICS region running the Attachmate CWI that accepts the initial HTTP based request to programs that reside on Multi Region Operation (MRO) connected systems as configured by the local systems programming staff. This parameter is reserved for future use and defaults to "NO."
FCBM
NO | YES
Extended API support allowing client applications to debug control blocks used by Services Builder for CICS TCP/IP feature. This support is intended to be a diagnostic aid for use by Attachmate or customer personnel with advanced knowledge of CICS internal architecture. This parameter is reserved for future use and defaults to "NO."

Services Builder for CICS Server Example

This example illustrates a typical application configuration for a given CICS region.

Configure any unused session memory to be timeout-purged after 10 minutes of inactivity.

*----------------------------------------------------------------*
*        CONFIGURATION MACRO DEFINITION FOR XTR5S003             *
*                                                                *
* - CONFIGURE SESSION INACTIVITY TIMEOUT FOR AMOUNT OF TIME THE  *
*   SESSION STATE WILL BE MAINTAINED WHILE INACTIVE, IN SECONDS. *
*----------------------------------------------------------------*
    XTR5S003 TIMEOUT=600, DEFAULT SESSION TIMEOUT VAL IN SECONDS X
          CTRAN=AQCC,     DEFAULT CLEANUP TRANSACTION            X
          DPLS=YES        ALLOW SMART CONNECTOR TCP based DPL
    END
Related Topics
Bullet Using the TCP/IP Connectivity Feature
Bullet Installing from the CD on an OS/390 Server
Bullet Installing from Tape or Disk
Bullet Customizing the CWI Analyzer Module
  Attachmate