Rational Developer for System z, Version 7.6

Generation properties of the LINK with COMMAREA invoke type

This topic describes the generation properties of the LINK with COMMAREA invoke type.

This topic contains the following subtopics:

General information

Important: A LINK with COMMAREA invoke node can validly occur only within a Nonterminal flow node (see About flow types).

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).

Generation properties

For more information about these generation properties see the CICS Service Flow Runtime User's Guide (see Supported runtime environments for each project type).

Table 1. Generation properties of the LINK with COMMAREA invoke type
NAME DESCRIPTION VALUE RANGE DEFAULT VALUE
Invoke Type Type of node used in the COBOL-based flow
  • LINK with COMMAREA
  • LINK with Channel
  • WebSphere® MQ
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
  • CICS Service Flow Runtime: Level 1.01: The name of the generated COBOL source file.
  • CICS Service Flow Runtime: Level 2.01: The CICS Service Flow Runtime uses this name to uniquely identify the Link with COMMAREA invocation.
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:
  • If you select Generate length value then the Generate Runtime Code wizard automatically calculates the value of the maximum COMMAREA length required for this Invoke node.
  • You can override the automatically calculated length value by typing a length value into this field.
  • The Generate Runtime Code wizard stores the value that you specify in this field into the DPC-COMMAREA-LENGTH field for this Invoke node in the generated service flow program.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)