CICS command argument values
The data associated with an option is called its argument.
The following types of argument are used in the syntax diagrams
for CICS system programming interface (SPI) commands:
- data-area
- data-value
- ptr-ref (for pointer-reference)
- ptr-value (pointer-value)
- cvda (CICS-value data area)
- Data-areas and data-values
Data-areas and data-values are the basic argument types. The difference between them is the direction in which information flows when a task executes a command. - Pointer arguments
A pointer-reference, abbreviated to ptr-ref in the diagrams, is a special case of a data-area. It also is a receiver field, but CICS uses it to return a pointer to the data requested, rather than the data itself; that is, CICS stores the location (address) of the data in the argument you provide. - CICS-value data areas (CVDAs)
A CVDA (CICS-value data area) is an argument to which CICS has assigned a specific and limited set of meaningful values. These values are named, both to make them intuitive and easy to remember and to keep the interface between user programs and CICS symbolic, so that version and platform changes do not require program modifications. - CVDA examples
Here are examples in all the CICS-supported languages that show the use of CVDAs and the DFHVALUE function. - Data types
For most arguments, CICS uses one of five data types. The first four data types are all used for numeric data, but they differ in length and internal format; the last is for text. The names used in this information are those used in assembler language. - COBOL argument values
In COBOL, you can use any data name of the correct data type for any argument. For a data-value, you can also use a constant that can be converted to the correct type. - C and C++ argument values
In C and C++, you can use any data reference of the correct data type for a data-area, data-value, or CVDA, provided the reference is to contiguous storage. In addition, for a data-value, you can use any C expression that can be converted to the correct data type. - PL/I argument values
In PL/I, an argument can be any PL/I data reference of the correct data type, provided the reference is to connected storage. In addition, a data-value, a pointer-value, or a sender CVDA can be any PL/I expression that can be converted to the required type, including one containing built-in functions like ADDR or LENGTH. - Assembler language argument values
In assembler language, an argument calling for a data-area, data-value, or CVDA can be any relocatable expression that refers to data of the correct type, including register forms such as 20(0,11), and forms that use the macro-replacement facilities. - Argument lengths
Arguments in character form can be variable in length; the USERDATA option in the ACQUIRE TERMINAL command is an example. Where this occurs, CICS provides an option with which you can specify the length of the data and you must do so if you are coding in C/370. - Null values
CICS defines a null value for most types of data. CICS sets receiver option values to the null value corresponding to the data type for the option if the option does not apply in a particular situation, and you can use them in sender options to indicate that you want no change to an option value.
dfha8md.html |
Last updated: Sunday, 4 June 2017