| Op Code (Hex) | Extender | Operand 1 | Operand 2 | Operand 3 | Operand 4 | Operand [5-7] |
|---|---|---|---|---|---|---|
| ECSCAN 10D4 |
| Receiver | Base | Compare operand | Mode operand |
|
|
| ||||||
| ECSCANB 1CD4 | Branch options | Receiver | Base | Compare operand | Mode operand | Branch targets |
|
| ||||||
| ECSCANI 18D4 | Indicator options | Receiver | Base | Compare operand | Mode operand | Indicator targets |
Operand 2: Character variable scalar.
Operand 3: Character scalar.
Operand 4: Character(1) scalar.
Operand 5-7:
This instruction scans the string value of the base operand for occurrences of the string value of the compare operand and indicates the relative locations of these occurrences in the receiver operand. The character string value of the base operand is scanned for occurrences of the character string value of the compare operand under control of the mode operand and mode control characters embedded in the base string.
The base and compare operands must both be character strings. The length of the compare operand must not be greater than that of the base string. The base and compare operand are interpreted as containing a mixture of 1-byte (simple) and 2-byte (extended) character codes. The mode, simple or extended, with which the string is to be interpreted, is controlled initially by the mode operand and thereafter by mode control characters embedded in the strings. The mode control characters are as follows:
* Hex 0E = | Shift out of simple character mode to extended mode. |
* Hex 0F = | Shift into simple character mode from extended mode. This is recognized only if it occurs in the first byte position of an extended character code. |
| Offset | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Dec | Hex |
| Field Name |
| Data Type and Length | ||||||||||||
| 0 | 0 |
| Mode operand |
| Char(1) | ||||||||||||
| 0 | 0 |
| Operand 2 initial mode indicator |
| Bit 0 | ||||||||||||
|
|
|
|
| ||||||||||||||
| 0 | 0 |
| Operand 3 initial mode indicator |
| Bit 1 | ||||||||||||
|
|
|
|
| ||||||||||||||
| 0 | 0 |
| Reserved (binary 0) |
| Bits 2-7 | ||||||||||||
| 1 | 1 |
| --- End --- |
|
| ||||||||||||
The compare operand value is the entire byte string specified for the compare operand. The mode operand determines the initial mode of the compare operand. The first character of the compare operand value is assumed to be a valid character for the initial mode of the compare operand and not a mode control character. Mode control characters in the compare operand value participate in comparisons performed during the scan function except that a mode control character as the first character of the compare operand causes unpredictable results.
The base string is scanned until the mode of the characters being processed is the same as the initial mode of the compare operand value. The operation continues comparing the characters of the base string with those of the compare operand value. The starting character of the characters being compared in the base string is always a valid character for the initial mode of the compare operand value. A mode control character encountered in the base string that changed the base string mode to match the initial mode of the compare operand value does not participate in the comparison. The length of the comparison is equal to the length of the compare operand value and the comparison is performed the same as performed by the Compare Bytes Left Adjusted (CMPBLA) instruction.
If a set of bytes that matches the compare operand value is found, the binary value for the relative location of the leftmost base string character of the set of bytes is placed in the receiver operand.
If the receiver operand is a scalar, only the first occurrence of the compare operand is noted. If the receiver operand is an array, as many occurrences as there are elements in the array are noted.
If a mode change is encountered in the base string, the base string is again scanned until the mode of the characters being processed is the same as the initial mode of the compare operand value, and then the comparisons are resumed.
The operation continues until no more occurrences of the compare operand value can be noted in the receiver operand or until the number of bytes remaining to be scanned in the base string is less than the length of the compare operand value. When the second condition occurs, the receiver value is set to zero. If the receiver operand is an array, all its remaining elements are also set to zero.
If the escape code encountered result condition is specified (through a branch or indicator option), verifications are performed on the base string as it is scanned. Each byte of the base string is checked for a value less than hex 40. When a value less than hex 40 is encountered, it is then determined if it is a valid mode control character.
If a byte value of less than hex 40 is not a valid mode control character, it is considered to be an escape code. The binary value for the relative location of the character (simple or extended) being interrogated is placed in the receiver operand, and the appropriate action (indicator or branch) is performed according to the specification of the escape code encountered result condition. If the receiver operand is an array, the next array element after any elements set with locations or prior occurrences of the compare operand, is set with the location of the character containing the escape code and all the remaining array elements are set to zero.
If the escape encountered result condition is not specified, verifications of the character codes in the base string are not performed.
06 Addressing
08 Argument/Parameter
0C Computation
10 Damage Encountered
1C Machine-Dependent
20 Machine Support
22 Object Access
24 Pointer Specification
2C Program Execution
2E Resource Control Limit
32 Scalar Specification
36 Space Management
44 Protection Violation