If the client application is sending keyword variables, MainframeConnect (with the Access Service Library) or Open ServerConnect (with TRS):
Parses the arguments
Builds a table of keywords and associated values (the keyword variable substitution table)
Places the address of this table in SPVARTAB
If the arguments are not in keyword format, MainframeConnect or Open ServerConnect sets the SPVARTAB to '0'.
The keyword variable substitution table contains a full word count of the number of keywords that were specified, followed by one keyword entry for each keyword specified. The following figure illustrates the variable substitution table.
Figure 2-1: Keyword variable substitution table
Figure 2-2 illustrates the keyword entry format.
Figure 2-2: Keyword entry format
The fields in the keyword entry are in integer format; addresses are 4 bytes long and lengths are 2 bytes long. For example, if the client application passed the following single variable:
&DATE=1991-12-04
the variable substitution table built by MainframeConnect or Open ServerConnect might appear as follows:
10000253D 000254F 5 10
where 1 is the keyword count indicating the number of keyword entries; in this case, the &DATE is the only keyword.
where 0000253D is the address of the variable name in the SPAREA.
where 0000254F is the address of the variable value in the SPAREA.
where 5 is the length of the variable name; in this case, &DATE.
where 10 is the length of the variable value; in this case, 1991-12-04.
See Appendix D, “RSP4C Keyword Variable Sample RSP” and Appendix E, “RSP8C Variable Text Sample RSP” for sample RSPs that handle variables.
