The LINK with COMMAREA invoke type causes the specified nonterminal application to be invoked by means of a CICS® LINK command with the COMMAREA option, as in the command line EXEC CICS LINK PROGRAM('chkavail')COMMAREA(ordrrqst).
A COMMAREA is a large contiguous block of data used to transfer information between two programs within a transaction, or used to transfer information between two transactions from the same terminal. A COMMAREA contains all of the data to be passed to the called program, even if only part of the data is required. Information in a COMMAREA is available only to the two participating programs, unless those programs take explicit steps to make the data available to other programs that might be invoked later in the transaction.
The COMMAREA has a maximum size of 32K, which makes it too small for many modern applications.
Compare the capabilities the LINK with COMMAREA invoke type with those of the LINK with Channel invoke type (see Generation properties of the LINK with Channel invoke type).
For more information about these generation properties see the CICS Service Flow Runtime User's Guide (see Supported runtime environments for each project type).
| NAME | DESCRIPTION | VALUE RANGE | DEFAULT VALUE |
|---|---|---|---|
| Invoke Type | Type of node used in the COBOL-based flow |
|
LINK with COMMAREA |
| Activity Name | Name of the activity performed by the node. Note: When the runtime code is generated for the CICS Service Flow Runtime environment,
the runtime code generator uses the information in this node to create
a CICS Business Transaction
Services (BTS) activity. The name that you specify here is used as
the name of the new BTS activity.
|
String value: 1-32 characters | Node ID |
| Comment | Optional text associated with the node | N/A | N/A |
| Adapter name |
|
String value: 1-8 characters | A prefix of AD followed by the first 6 characters of the Invoke name. |
| Adapter Transaction ID | The CICS Transaction ID under which the LINK with COMMAREA command is to be run. | String value: 1-4 characters | CMAS You can accept the default transaction ID, or you can override the default transaction ID by typing another transaction ID into this field. An error message is displayed if the input field is blank or if the transaction ID begins with C and is something other than CMAS. (Transaction IDs beginning with C are reserved by CICS). |
| Link To Program Name | Server side program to which a LINK with COMMAREA invocation links. | String value: 1-8 characters. Cannot be blank. | LINK with COMMAREA invoke program name |
| System ID | Name of the CICS system where your user transactions (target CICS application transactions) are running | String | Blank |
| Link To Transaction ID | Server side Transaction ID parameter (TRANSID) to specify on the LINK with COMMAREA command | N/A | Blank |
| Syncpoint On Return | Select to include the SYNCONRETURN parameter (indicating if the server region named in Sysid is to take a syncpoint on successful completion of the program) on the LINK with COMMAREA command. | N/A | Not selected |
| Maximum COMMAREA Length2 | Maximum COMMAREA length, in bytes | 1-32500 bytes | Generate length value |
| 1See CICS Service Flow Runtime Levels
1.0 and 2.0. 2Maximum
COMMAREA Length:
|
|||