CONNECT PROCESS

CONNECT PROCESS allows an application to specify a process name and synchronization level to be passed to CICS and used when the remote partner is attached.

CONNECT

PROCESS
[ CONVID(name) ]
[ SESSION(name) ]
[ PROCNAME(data-area) ]
[ PROCLENGTH(data-value) ]
[ PARTNER(name) ]
[ SYNCLEVEL(data-value) ]
[ STATE(cvda) ]

Description

CONVID(name)

identifies the conversation to which the command relates. The 4-character name specifies the token returned by a previously executed ALLOCATE command in EIBRSRCE in the EIB.

For compatibility with earlier releases, SESSION is accepted as a synonym for CONVID. New programs should use CONVID.

PARTNER(name)

specifies the name (8 characters) of a set of definitions that includes the name (or extended name) of a remote partner transaction (TPNAME or XTPNAME). You can use this option as an alternative to PROCNAME and PROCLENGTH.

PROCLENGTH(data-value)

specifies the length (as a halfword binary value in the range 1-64) of the name specified by the PROCNAME option.

PROCNAME(data-area)

specifies the partner process (that is, the transaction) to be attached in the remote system.

One byte is sufficient to identify a CICS transaction. The APPC architecture allows a range of 1-64 bytes but leaves each product free to set its own maximum. CICS complies by allowing a range of 1-64 bytes. If the remote system is CICS, this option can specify the 4-byte transaction identifier or the TPNAME value given in the relevant TRANSACTION definition. Alternatively, you can examine the full identifier by coding the user exit XZCATT.

SESSION(name)

specifies the symbolic identifier (1-4 characters) of a session TCTTE. This option specifies the alternate facility to be used.

STATE(cvda)

gets the state of the current conversation. The cvda values returned by CICS are:

* ALLOCATED

* CONFFREE

* CONFRECEIVE

* CONFSEND

* FREE

* PENDFREE

* PENDRECEIVE

* RECEIVE

* ROLLBACK

* SEND

* SYNCFREE

* SYNCRECEIVE

* SYNCSEND

SYNCLEVEL(data-value)

specifies the synchronization level (halfword binary value) for the current conversation. The possible values are:

* 0 None

* 1 Confirm

* 2 Syncpoint