Other session parameters

This topic lists the remaining attributes of the CONNECTION and SESSIONS resources that are of significance for CICS-to-IMS sessions.

ATTACHSEC
Must be specified as LOCAL.
BUILDCHAIN(YES)
Specifies that multiple RU chains are to be assembled before being passed to the application program. A complete chain is passed to the application program in response to each RECEIVE command, and the application performs any required deblocking.

BUILDCHAIN(YES) must be specified (or allowed to default) for LUTYPE6.1 sessions.

DATASTREAM(USER)
Must be specified with the value USER or allowed to default.

This option is used only when CICS® is communicating with IMS™ by using the START command (asynchronous processing). CICS messages generated by the START command always cause IMS to interpret the data stream profile as input for component 1.

The data stream profile for distributed transaction processing can be specified by the application program by means of the DATASTR option of the BUILD ATTACH command.

QUEUELIMIT(NO|0-9999)
Specifies the maximum number of requests permitted to queue for free sessions to the remote system. Further information is given in Intersystem session queue management.
MAXQTIME(NO|0-9999)
Specifies the maximum time, in seconds, between the queue for sessions to the remote system becoming full (that is, reaching the limit specified on QUEUELIMIT) and the queue being purged because the remote system is unresponsive. Further information is given in Intersystem session queue management.
RECORDFORMAT(U|VB)
Specifies the type of chaining that CICS is to use for transmissions on this session that are initiated by START commands (asynchronous processing).
Two types of data-handling algorithms are supported between CICS and IMS:
Chained
Messages are sent as SNA chains. The user can use private blocking and deblocking algorithms. This format corresponds to RECORDFORMAT(U).
Variable-length variable-blocked records (VLVB)
Messages are sent in variable-length variable-blocked format with a halfword length field before each record. This format corresponds to RECORDFORMAT(VB).

The data stream format for distributed transaction processing can be specified by the application program by means of the RECFM option of the BUILD ATTACH command.

Additional information on these data formats is given in CICS-to-IMS applications.

SENDCOUNT and RECEIVECOUNT
Used to specify whether the session is a SEND session or a RECEIVE session.
A SEND session is one in which the local CICS is the secondary and is the contention winner. Specify:
  • SENDCOUNT(1)
  • Allow RECEIVECOUNT to default. Do not specify RECEIVECOUNT(0).
A RECEIVE session is one in which the local CICS is the primary and is the contention loser. Specify:
  • RECEIVECOUNT(1)
  • Allow SENDCOUNT to default. Do not specify SENDCOUNT(0).

SEND sessions are recommended for all CICS-to-IMS sessions.

You need not specify a SENDPFX or a RECEIVEPFX; the name of the session is taken from the SESSNAME option.

Note: For SEND sessions, allow RECEIVECOUNT to default. For RECEIVE sessions, allow SENDCOUNT to default.

SENDSIZE and RECEIVESIZE
Specify the maximum z/OS® Communications Server request unit (RU) sizes for these sessions.
  • If CICS is the primary half-session, ensure that:
    1. The CICS SENDSIZE is less than or equal to the value specified on the RECANY parameter of the IMS COMM macro.
    2. The CICS RECEIVESIZE is greater than or equal to the IMS OUTBUF size.
  • If IMS is the primary half-session, ensure that:
    1. The CICS SENDSIZE is greater than or equal to the IMS OUTBUF size.
    2. The CICS RECEIVESIZE is less than or equal to the IMS RECANY size.
The compatibility requirements are summarized in the following table. Related options and operands are shown by identical numbers.
Note: VTAM® is now z/OS Communications Server.
CICS IMS
System initialization parameters
 
      COMM      APPLID=SYSIMS
 7              RECANY=nnn+22
                EDTNAME=ISCEDT
 
 
 4    TYPE      UNITYPE=LUTYPE6

 1    TERMINAL  NAME=SYSCICS
                SESSION=2
                COMPT1
                COMPT2 
 6              OUTBUF=mmm



      VTAMPOOL

 5    SUBPOOL  NAME=CIC1

      NAME      CICLT1 COMPT=1

      NAME      CICLT1A  

 8    SUBPOOL  NAME=CIC2

      NAME     CICLT2 COMPT=2

 3    DFSHSBxx USERVAR=SYSIMS
APPLID=SYSCICS          1 
CONNECTION resource
CONNECTION(IMSR)        2 
NETNAME(SYSIMS)         3 
ACCESSMETHOD(VTAM)        
PROTOCOL(LU61)            
DATASTREAM(USER)          
ATTACHSEC(LOCAL)    
SESSIONS resources
SESSIONS(csdname1)      
CONNECTION(IMSR)        2   
SESSNAME(IMS1)            
NETNAMEQ(CIC1)          5   
PROTOCOL(LU61)          4   
SENDCOUNT(1)              
SENDSIZE(nnn)           7   
RECEIVESIZE(mmm)        6   
IOAREALEN(nnn,16364)      

SESSIONS(csdname1)      
CONNECTION(IMSR)        2   
SESSNAME(IMS2)            
NETNAMEQ(CIC2)          8   
PROTOCOL(LU61)          4   
SENDCOUNT(1)              
SENDSIZE(nnn)           7   
RECEIVESIZE(mmm)        6   
IOAREALEN(nnn,16364)      
Note: For an example of a z/OS Communications Server logmode table entry for IMS, see ACF/SNA LOGMODE table entries for IMS .


dfht1c00126.html | Timestamp icon Last updated: Sunday, 4 June 2017