360 Assembly/360 Instructions/TRT
TRT - SS - Opcode DD - Scan a data string, looking for 1 or more specific characters.
The TRT instruction scans a field, looking for specific bytes. TRT does not change any data. The D1 field contains the address of the data to be scanned. The D2 field contains the address of a 256 byte table where each byte contains either X'00' or a non-zero byte, at the offset in the HEX table of the byte being searched for. TRT sets the condition code, indicating whether the object character(s) was found.
Availability
The TRT instruction is available on all models.
Caution
TRT changes both registers 1 and 2. TRT is the only instruction that changes reg-2 as part of the operation, so if you use TRT, then don't use reg-2 as your base.
Purpose of Instruction
The TRT instruction searches for specific bytes. For example, if you wanted to find the next occurrence either of C'D' or C'K', you would code:
TRT DATA,SRCHTBL BZ NOTFOUND
SRCHTBL DC XL256'00'
ORG SRCHTBL+C'D' DC X'04' ORG SRCHTBL+C'K' DC X'08' ORG
Condition code, etc.
- If no character is found, the condition code is set to 0.
If a character is found:
- The scanning terminates
- Register 1 indicates the address of the data character found.
- The byte in the scan table that was non-zero is placed into the low byte of reg-2. The remaining bytes of reg-2 are not changed. This is the only instruction that changes register 2 without reg-2 being specified.
- If the character that is found is the last character of the scanned field, the condition code is set to 2; otherwise, it is set to 1.
Translate and test is implemented in micro code. Checks one byte at a time until either it finds a byte, or the data being scanned is exhausted.
Exceptions and Faults
Protection Exception - the source or the target is outside of the legal address range assigned to this task
Example looking for a non-blank on a print line.
TRT LINE,NONBLANK BZ ALLBLANK
- REG-1 CONTAINS ADDRESS OF NON-BLANK CHAR
NONBLANK DC 256C' '
ORG NONBLANK+C' ' DC X'00' ORG
Example testing a packed field.
SR 2,2 TRT PACKDATA,TRTPACK TEST THE PACKED FIELD WITH 'C', 'D', OR 'F' SIGN BC 2,GOODDATA IF ANY SIGN '0A' - '0F' IS GOOD, USE THIS. B BRTBL(2) TO RESTRICT SIGNS TO '0C' '0D' AND '0F', USE THIS.
BRTBL B NOTFOUND
B GOODDATA B BADSIGN B BADDATA
TRTPACK DC 256X'0C'
ORG TRTPACK DC 10X'00',XL6'080804040804',10X'00',XL6'080804040804' ORG TRTPACK+X'20' DC 10X'20',XL6'080804040804',10X'00',XL6'080804040804' ORG TRTPACK+X'40' DC 10X'40',XL6'080804040804',10X'00',XL6'080804040804' ORG TRTPACK+X'60' DC 10X'60',XL6'080804040804',10X'00',XL6'080804040804' ORG TRTPACK+X'80' DC 10X'80',XL6'080804040804',10X'00',XL6'080804040804' ORG
Related instructions
TR is slightly related, although it's function is very different.