Modifying the Data Virtualization Manager configuration member

Edit online

Enable the VSAM data access via CICS TM parameters in the Data Virtualization Manager configuration member.

About this task

The Data Virtualization Manager configuration member is shipped in data set member hlq.SAVZEXEC(AVZSIN00) and copied to hlq.AVZS.SAVZEXEC(AVZSIN00) by the job in the AVZGNMP1 member for you to make your local modifications.

Procedure

  1. In the AVZSIN00 member, locate the comment “ENABLE CICS TRANSACTION SERVER SUPPORT.”
  2. Enable the CICS TS parameters by changing if DontDoThis to if DoThis. 
    if DoThis then
  do
   "MODIFY PARM NAME(EXCI)                 VALUE(YES)"
   "MODIFY PARM NAME(EXCICONNECTIONNAME)   VALUE(CICA)"
   "MODIFY PARM NAME(TRACEEXCIDPLEVENTS)   VALUE(YES)"
   "MODIFY PARM NAME(CICSSENDABCODE)       VALUE(YES)"
   "MODIFY PARM NAME(RRSCICS)              VALUE(YES)"
    The following table lists the parameters for configuring support for a CICS TS:
    Parameter Description Valid values
    EXCI Initialize EXCI support.
    NO
    YES
    Default value.
    EXCICONNECTIONNAME EXCI Default Connection Name.

    Specifies the default CICS Connection Name for EXCI support.

    		 EXCW
    TRACEEXCIDPLEVENTS Trace EXCI DPL Events
    NO
    Default value.
    YES
    CICSSENDABCODE Send ABEND Code to Clients.

    Controls the sending of the CICS ABEND code to the client. If set to YES, the ABEND code is returned to the client as part of the error message.
    NO
    Default value.
    YES
    RRSCICS Specifies whether RRS CICS support is active.
    NO
    Default value.
    YES
  3. Create a DEFINE CONNECTION statement for each CICS region. Include the following parameters in the statement: 
    "DEFINE CONNECTION  NAME(CICA)",
                   "GROUP(CICA)",
                   "ACCESSMETHOD(IRC)",
                   "NETNAME(CICADBVS)",
                   "INSERVICE(YES)",
                   "PROTOCOL(EXCI)",
                   "APPLID(XXXXXXXX)",
                   "LOADBALGROUP(LBG1)",
                   "SECURITYNAME( )",
end
    Parameter Description Valid values
    NAME Specify a four-character name for the connection to the CICS region. Four-character name
    GROUP Specify the same name as the connection name. Eight-character name
    ACCESSMETHOD Specify IRC. IRC
    NETNAME Specify the network name of the remote system. To identify these connections in CICS, use a name that is a combination of the connection name and the server subsystem name. Eight-character name
    INSERVICE Specify YES to open the connection at server startup. Specify NO to open the connection manually.
    NO
    Default value.
    YES
    PROTOCOL Specify EXCI. EXCI
    APPLID Specify the VTAM APPLID of the target CICS. No restriction on the APPLID name
    LOADBALGROUP Specify the name of the group that is used to balance the CICS workload across multiple CICS regions. Specify the same group name in each DEFINE CONNECTION statement that you create. (Optional) Four-character name
    SECURITYNAME Specify a valid security name from the remote system. Eight-character name
  4. Create a DEFINE SESSION statement for each CICS region. Include the following parameters in each statement: 
    "DEFINE SESSION   NAME(CICA)",
                   "GROUP(CICA)",
                   "CONNECTION(CICA)",
                   "PROTOCOL(EXCI)",
                   "RECEIVERFX(XD)",
                   "RECEIVERCOUNT(0)",
                   "SENDPFX(SD)",
                   "SENDCOUNT(20)",
                   "IOAREALEN(4096)",
end
    Parameter Description Valid values
    NAME Specify the same name that you specified for the NAME when you defined the connection for this CICS region. Four-character name
    GROUP Specify the same name that you specified for the NAME when you defined the connection for this CICS region. Eight-character name
    CONNECTION NAME Specify the same name that you specified for the NAME when you defined the connection for this CICS region. Four-character name
    PROTOCOL Specify EXCI. EXCI
    RECEIVEPFX Not applicable. This field should be blank its included to provide complete list of connection parameters.
    RECEIVECOUNT Not applicable. This field should be blank its included to provide complete list of connection parameters.
    SENDPFX Specify a one- or two-character prefix for the session name. The session name, which is limited to four characters, is composed of the prefix and the session number. Therefore, if you define more than 99 sessions, specify a one-character prefix. A one- or two-character prefix
    SENDCOUNT Specify the maximum number of concurrent transactions. This value should match the RECEIVECOUNT value minus one set in the DEFINE SESSIONS definition in the AVZCICSD job. Any number up to 255
    IOAREALEN Specify the length, in bytes, of the terminal input/output area to use to process transmitted messages. Any value up to 4096K