Configuring the environments
sgc050
Define the underlying VSAM data sets for DFHEJDIR and DFHEJOS. CICS supplies sample JCL to help you do this, in the DFHDEFDS member of the SDFHINST library.
TCPIPSERVICE: name of the resource definition
GROUP: as required
PORTNUMBER: The port or IP address on which CICS will listen for incoming IIOP requests (for example: 683, or 683 and 684)
PROTOCOL: IIOP
TRANSACTION: The CICS transaction to start when a request arrives. The CICS IIOP Request Receiver transaction, CIRR, is inserted by default when IIOP is specified as the protocol.
DEFINE TCPIPSERVICE(name) GROUP(name) IPADDRESS(ip address) PORTNUMBER(683) TRANSACTION(CIRR) PROTOCOL(IIOP)Default definitions for the following CICS resources, to include in DFHLIST, are supplied in Group DFHIIOP.
CORBASERVER: CSV1
GROUP: DFHIIOP
JNDI PREFIX: SAMP
SESSBEANTIME: 00,01,00
SHELF: the path to the shelf root directory that you created in Define shelf directory. Default: /var/cicsts.
HOST: IP address of the CICS region
PORT:07873
SSL:NO
SSLPORT:NO
DEFINE CORBASERVER(CSV1) GROUP(DFHIIOP) JNDIPREFIX(SAMP) SESSBEANTIME(00,01,00) SHELF(/var/cicsts) HOST(ip address) PORT(07873) SSL(NO) SSLPORT(NO)
The attributes of CORBASERVER definition: HOST, SSL, and PORT or SSLPORT must match the corresponding attributes of the TCPIPSERVICE definition:
CORBASERVER | TCPIPSERVICE |
---|---|
HOST | IPADDRESS or DNSGROUP |
SSL | SSL |
PORT or SSLPORT | PORTNUMBER |
The following DFHJIIRRS sample definition is supplied in group DFHIIOP:
DEFINE PROGRAM(DFHIIRRS) GROUP(DFHIIOP) DESCRIPTION(CICS IIOP Request Receiver) JVM(NO) JVMCLASS() LANGUAGE(Assembler) RELOAD(NO) EXECKEY(CICS) RESIDENT(NO) USAGE(NORMAL) USELPACOPY(NO) STATUS(ENABLED) CEDF(NO) DATALOCATION(ANY) DYNAMIC(NO)
The following DFHJIIRP sample definition is supplied in group DFHIIOP:
DEFINE PROGRAM(DFJIIRP) GROUP(DFHIIOP) DESCRIPTION(CICS IIOP Request Processor) JVM(YES) JVMCLASS(com.ibm.cics.iiop.RequestProcessor) LANGUAGE(LE370) RELOAD(NO) EXECKEY(USER) RESIDENT(NO) USAGE(NORMAL) USELPACOPY(NO) STATUS(ENABLED) CEDF(NO) DATALOCATION(ANY) DYNAMIC(NO)
The PROGRAM definition for the request processor can have any name, but the JVMCLASS parameter must be set to com.ibm.cics.iiop.RequestProcessor
If you are not using the default JVM profile DFHJVMPR you must specify the name of your JVM profile on the JVMPROFILE option of the PROGRAM definition.
The following default definition is supplied in DFHIIOP:
DEFINE TRANSACTION(CIRR) GROUP(DFHIIOP) PROGRAM(DFHIIRRS) TWASIZE(0) PROFILE(DFHCICST) STATUS(ENABLED) TASKDATALOC(ANY) TASKDATAKEY(USER) RUNAWAY(SYSTEM) SHUTDOWN(ENABLED) PRIORITY(1) TRANCLASS(DFHTCL00) DTIMOUT(NO) TPURGE(NO) SPURGE(YES) ISOLATE(NO) RESSEC(NO) CMDSEC(NO) RESTART(NO) DESCRIPTION(Default CICS IIOP Request Receiver transaction)
The following default definition is supplied in DFHIIOP:
DEFINE TRANSACTION(CIRP) GROUP(DFHIIOP) PROGRAM(DFJIIRP) TWASIZE(0) PROFILE(DFHCICST) STATUS(ENABLED) TASKDATALOC(ANY) TASKDATAKEY(USER) RUNAWAY(SYSTEM) SHUTDOWN(Disabled) PRIORITY(1) TRANCLASS(DFHTCL00) DTIMOUT(NO) TPURGE(NO) SPURGE(YES) ISOLATE(YES) RESSEC(YES) CMDSEC(YES) RESTART(NO) DESCRIPTION(Default CICS IIOP Request Processor transaction)
Note: the DFHEJDIR file must be defined, installed, and available before the CORBASERVER definition can be installed.