Notes:
In Warm Reset (type = 0) the terminal is reset. If completion is normal, the terminal becomes operational and files need not be re-downloaded.
In Cool-Reset mode (type = 1) this command resets the terminal, halts running applications, and reinitializes memory allocations. Power-on Self Test is run, and if completion is normal, the download of files is requested by responding to a poll with a DC1 character on the communications network. Files must be downloaded, however it is not necessary to reconfigure the terminal's address, baud rate, parity setting, or number of data bits.
The format for this command is:
=> STX, addr, addr, 0, {type}, CS1, CS2, ETX
The optional type controls how the reset is completed.
If the type is omitted, command CMD 0 operates as it does with the 7525, which is a Warm Reset (type = 0), allowing compatibility with that machine.
=> STX, addr, addr, 1, CS1, CS2, ETX <= STX, data, CS1, CS2, ETXThe data portion consists of a string of 12 ASCII characters that define the terminal status as follows:
Character Description --------- ------------------------------------------------ 1 0 Normal state 1 First status request since POST completed2 0 Last command executed correctly 1 Last command did not execute correctly 2 Last broadcast was received OK
3 0 Required file download is present 1 File download required
4 0 Terminal is In Service 1 Terminal is Out of Service
5 0 All commands since last CMD 1 executed correctly 1 Command failure occurred since last CMD 1 (Always = 1 in 7525 Compatibility mode)
6, 7 cc Identifies command for status information Character 7 is a blank (ASCII space) for single character commands
8, 9 00 Last command OK 0f Last command OK (f = file 0&mdash.a, c, e) 10 Invalid command 1f Invalid command (f = file 0&mdash.a, c, e) 20 Invalid text or format 2f Invalid text or format (f = file 0&mdash.a, c, e) 3f File overrun (no space) 4f File not initialized 5f Record not found (f = file 0&mdash.a, c, e) 69 Invalid attempt to initialize file 9 6f Invalid attempt to initialize file f (f = file 0&mdash.a, c, e) 7f Still processing command (f = files 0-a, c, e) 80 Last command ignored because terminal in wrong state
10, 11 ff Identifies current mode and polled data file Af = Interactive/buffered mode Bf = Buffered mode Cf = Interactive mode
12 0 No data in transaction queue 1 Data exists in transaction queue
=> STX, addr, addr, 2, text, CS1, CS2, ETX <= ACK or NAKThe text refers to ASCII characters to be displayed in the sequence sent. Space characters appear as blanks on the display. Normally, the data written to the display remains until Timer B count has expired as specified in File 0.
Display time-out can be avoided by using an ASCII Device Control 2 (DC2) character as the first character of the text.
To prevent disturbing normal transaction display messages, this command is handled only during terminal idle state.
Notes:
=> STX, addr, addr, 3, CS1, CS2, ETX <= STX, data, CS1, CS2, ETX
=> STX, addr, addr, 4, text, CS1, CS2, ETX <= ACK or NAKThe text refers to 12 ASCII numeric characters in the following format using the 24-hour clock: YYMMDDHHMMSS.
When setting the clock from a host computer, the 7526 DCT terminal must first be set out of service. This prevents conflict between the set-clock command and an input transaction which may be in progress.
The correct sequence is:
=> STX, addr, addr, 5, text, RS, CS1, CS2, ETX <= ACK or NAKThe text refers one ASCII numeric character (1-9) that relates to a tone duration. The value of the text multiplied by 0.5 second determines the duration of the tone.
To prevent disturbance during normal transactions, this command is handled only during terminal idle state while the terminal is offline or out of service.
Note:
Tone is asynchronous, and if back-to-back CMD 5 commands are executed, the tone duration is that of the second command..
=> STX, addr, addr, 6, CS1, CS2, ETX <= STX, data, CS1, CS2, ETX
1 = 2L x 40W alphanumeric 3 = 1L x 16W alphanumeric
0 = 0Kb 1 = 32Kb 2 = 64Kb 3 = 128Kb 4 = 160Kb 5 = 256Kb
1 = Clock installed
0 = No 1 = Yes
0 = Printer port 1 = DI/DO port
5 = 1L x 40W alphanumeric
1 = 0Kb 4 = 25Kb or greater
1 = Clock installed
0 = ASCII port not installedNote:
The RAM storage size values returned in the compatibility mode are limited, however, additional RAM storage will be available. For example, if a 7526 DCT contains 128Kb of RAM, the 128Kb of RAM may be used but Char 2 would indicate 25Kb (or greater)..
=> STX, addr, addr, 7, CS1, CS2, ETX <= STX, data, CS1, CS2, ETXThe data refers to the current terminal time and date using the same format as CMD 4 (YYMMDDHHMMSS).
A CMD 1 status request returns "80" for characters 8 and 9 to indicate invalid terminal state, if the terminal has not been downloaded. If the time has not been initialized with CMD 4, the returned data will be zeroes.
=> STX, addr, addr, 8, text, RS, CS1, CS2, ETX <= ACK or NAKThe text contains one or three ASCII characters that specify the currently polled buffer or file and the number of data records to be transmitted on a poll. The following ASCII characters are valid parameters for the text portion of CMD 8:
If there are buffered transactions in the terminal and a poll is received, with no interactive transaction waiting to be polled, the following occurs:
Note:
The terminal returns invalid command status to CMD 8 if execution is attempted when the DCT is in service. To preclude conflict, the following sequence is required:l.If there are no files loaded on the terminal, the terminal returns invalid state status to CMD 8.
- Set terminal out of service (CMD A)
- Execute CMD 8
- Set terminal in service (CMD A)
CMD 9x&mdash.Terminal Text or Data File Management
The 9x commands are used for initializing and managing up to 12 text or data files. Records in these files can be of variable length. An ASCII record separator (RS) is used between records and following the last record. This series of commands allow the terminal controller to perform the following:Status should be queried (CMD 1) after each text or data file command (9x) to verify if the command executed properly.
- CMD 9A&mdash.Send file status to terminal controller
- CMD 9B&mdash.Initialize text file
- CMD 9C&mdash.Load text file
- CMD 9D&mdash.Delete text records
- CMD 9E&mdash.Erase validation files
- CMD 9F&mdash.Transmit data file contents to terminal controller
CMD 9A&mdash.Send File Status to Terminal Controller
The format for this command is:=> STX, addr, addr, 9A, f, RS, CS1, CS2, ETX <= STX, f, data, CS1, CS2, ETXThe f represents the file number (0-9, a, e)The data portion consists of a fixed length string of ASCII characters that indicate the status of the specified file.
Enhanced Mode
The format is: aaaaaauuuuuudpWhere:
Notes:
- aaaaaa = Number of bytes reserved by previous CMD 9B (000001-065535).
- uuuuuu = Number of bytes not used
- d = Text type specified
- 0 = Compacted numerical text
- 1 = Non-compacted alphanumeric text
- p = Type of text specified
- 0 = Non-polled file
- 1 = Polled file.
- In the enhanced mode, six digits are returned and the maximum file size is 65535 bytes, except for file 9 which can occupy all remaining memory.
- To obtain status for File c, use CMD MA.
Where:
P999 is the largest value returned in the 7525 compatibility mode, however, more RAM may be in use..
=> STX, addr, addr, 9B, f, text, RS, CS1, CS2, ETX <= ACK or NAKThe f is the file number (0-9, a, e)
The text is a fixed length string of ASCII characters that initializes a specified text file, reserves file space, and defines file characteristics.
Enhanced mode or 7525 compatibility mode may be used at anytime regardless of the operating mode set with CMD P or File 0 Record 00 offset 203.
Where:
Where:
=> STX, addr, addr, 9C, f, text, RS, CS1, CS2, ETX <= ACK or NAKThe f represents the file number (0-8, a, e)
The text is variable length ASCII data.
Text records are loaded into a specified file (0&mdash.8, a, e). Repeat the CMD 9C string to complete loading the file. Text records may be variable in length and can be in multiple communications records and may have a maximum length, including the control characters, of:
The following example sends text records 1234, 123, and 12345 to File 3.
Notes:
The format for this command is:
=> STX, addr, addr, 9D, f, text, CS1, CS2, ETX <= ACK or NAKThe f represents the file number (2-7).
The text refers to variable length records followed by RS.
The following format is an example of deleting the records JOHN and MARY from file 2. :
9D2JOHN(RS)MARY(RS)CMD 9D is valid only with validation files. An attempt to delete records from any other file will be rejected, and status character 8 is set to 1.
Notes:
The format for this command is:
=> STX, addr, addr, 9E, f, RS, CS1, CS2, ETX <= ACK or NAKThe f represents the file number (2-7). If f = 0 then files 2-7 are erased at once.
The following format is an example of deleting all records in file 2:
9E2CMD 9E is valid only with validation files. An attempt to erase text from files other than 2-7 will be rejected, and status character 8 is set to 1.
=> STX, addr, addr, 9F, f, text, RS, CS1, CS2, ETX <= STX, data, CS1, CS2, ETXThe f represents the file (0&mdash.9, a, e).
The data consists of a block of bytes that is transmitted to the host.
The size of the block is determined by the host communication's buffer size specified in Extended File 0. If the buffer size is more than 128 bytes, the same data can be part of two records.
The data consists of a block of 128 bytes that is transmitted to the host.
An ASCII carriage return (CR-hex 0D) follows the last data record in the file.
Notes:
<= STX, CAN, CS1, CS2, ETX
=> STX, addr, addr, A, text, CS1, CS2, ETX <= ACK or NAK (for commands A1 and A0) or <= DC3 (for command A1X when a download is not needed) or <= DC1 (for command A1X when a download is needed) or No response (for command A0X )The text is one or two ASCII characters:
Note:
Commands A1X and A0X are only allowed when the 7526 is operating with the host/server connection set to TCP/IP Ethernet (10base2 or 10baseT).
=> STX, addr, addr, B, text, {position}, RS, CS1, CS2, ETX
<= ACK or NAK
The text is a string of ASCII characters used to control the audible
tone and write messages to the display. STX and ETX cannot be used in the
text string.
The position consists of an identifier to signify that cursor positioning information follows, and a row and column value.
Additional text characters define the display source:
CMD B is processed only when the terminal is waiting for an interactive response (when the DCT is waiting for a response in interactive mode to acknowledge receipt of a transaction record by the terminal controller).l.CMD C&mdash.Negative Response from Terminal Controller
The format for this command is:=> STX, addr, addr, C, text, {position}, RS, CS1, CS2, ETX <= ACK or NAKThe text is a string of ASCII characters used to control the audible tone and write messages to the display. STX and ETX characters cannot be used in the text string.The position consists of an identifier to signify that cursor positioning information follows, and a row and column value.
Enhanced Mode
The first character controls audible tone:Additional text characters define the display source:
- 0 = No tone, prompt timeout after Timer B
- 1 = Tone, prompt timeout after Timer B
- 2 = No tone, no prompt timeout
- 3 = Tone, no prompt timeout.
- #HELLO {@rrcc} = Write message HELLO to the display at an optional row and column position
- $fllll {@rrcc} = Write record at llll in File f to the display at an optional row and column position
- f = File number (2-8)
- llll = Record location (0000-9999) within the file.
- {@rrcc} = Optional cursor positioning information
- @ = Indicator that row and column information follows.
- rr = Row number (01-02) on the display.
- cc = Column number (01-40) on the display.
7525 Compatibility Mode
The first text character has the same function as the Enhanced Mode.Additional text characters define the display source:
Note:
- #ACCEPT {@rrcc} = Write message ACCEPT to the display at an optional row and column position
- $fll {@rrcc} = Write record ll in File f to the display at an optional row and column position
The following example activates tones for an invalid transaction and writes record 3 in File 4 to the display:
- f = File number (2-8)
- ll = Record location (00-99) within the file.
- {@rrcc} = Optional cursor positioning information
- @ = Indicator that row and column information follows.
- rr = Row number (01-02) on the display.
- cc = Column number (01-40) on the display.
- C1$403
CMD C is processed only when the terminal is waiting for an interactive response (when DCT is waiting for a response in interactive mode to acknowledge receipt of a transaction record by the terminal controller.).l.CMD D&mdash.Initiate Data Collection from Terminal Controller
This command allows the terminal controller to initiate a data collection transaction program at the terminal. CMD D can have multiple key commands appended including all of the transaction program command set and the :6 command. CMD D allows command sequences that are longer than one communication packet. If the terminating record separator (RS) is not present in a CMD D, the continuation of the command is assumed to follow in the next CMD D. The command sequence is buffered (up to 255 bytes) until the RS is found in a following CMD D.The ability to send transaction programs up to 255-byte lengths is an enhancement of the 7525's function. This function is available in both the 7525 compatibility and enhanced modes.
:6(text)
(text) is the message to be displayed.
The format for this command is:
=> STX, addr, addr, D, key commands, RS, CS1, CS2, ETX <= ACK or NAKIn interactive or interactive/buffered mode, CMD D is accepted by the terminal, and CMD B, CMD C, or CMD 2 is used for completing a transaction. This provides the flexibility of using the terminal in a fully interactive mode, allowing the terminal controller to control each step in the data collection process.Transactions created with CMD D contain a function ID as follows:
Example:
- Enhanced mode
- BFC = buffered mode
- IFC = interactive mode
- 7525 Compatibility mode
- 31 = buffered mode
- 81 = interactive mode
D:010:11000:6Enter Dept:20500The preceding example generates a transaction from the terminal. A prompt is displayed (File 8 record 10) with a 10-character badge read expected. Next, ENTER DEPT is displayed with a five-character numeric input expected. The resulting transaction may be polled from the terminal.Notes:
- To prevent disturbance during normal transactions, CMD D is processed only during terminal idle times.
- Succeeding the CMD D command with a CMD 1 command, and inspecting bytes 8 and 9 of the response may be used to determine if the command CMD D was successfully processed.
CMD E&mdash. Write DO Point
This commands writes a value or toggles selected DO points for a specified duration.The format of this command is:
=> STX, addr, addr, E, {text...}, RS, CS1, CS2, ETX <= ACK or NAKThe text is a string of four ASCII characters, pvttWhere:
Note:
- p = DO point 0-7 to write
- v = Value to write:
- 0 = Clear DO point
- 1 = Set DO point
- 2 = Toggle current state of the DO (change to the opposite state)
- tt = Seconds from 00-99 to hold a toggled DO point in its new state. The value of 00 = infinity
If multiple DO points are specified in the command, they are executed sequentially..CMD F&mdash.Storage Query
This command determines the usable RAM remaining in the DCT.The format for this command is:
=> STX, addr, addr, F, RS, CS1, CS2, ETX <= STX, data, CS1, CS2, ETXThe data is a string of 12 ASCII characters defining the RAM status of the DCT. The first 6 bytes give the number of bytes of RAM remaining in the DCT and the field is right-justified and padded on the left with ASCII zeroes. The remaining 6 bytes are reserved.CMD G&mdash.Execute Transaction Program in Simulated Mode
This command allows execution of a transaction program already loaded into the 7526 DCT, and simulates the pressing of a key or other event which normally starts the desired transaction program.Once the event has been simulated with command CMD G, processing the event takes place in the same manner as if the real event had occurred and the transaction record(s) are created as defined by the transaction program.
The format for this command is:
=> STX, addr, addr, G, function ID, RS, CS1, CS2, ETX <= ACK or NAKThe function ID is a two byte hexadecimal-ASCII field that represents a hex value. The function ID fields are described in "File 9&mdash.Transaction Queue File".Notes:
- To prevent disturbance during normal transactions, CMD G execution is limited to terminal idle times.
- Following the CMD G with CMD 1 is useful in determining if the transaction program was started.
The format for this command is:
=> STX, addr, addr, H, text, RS, CS1, CS2, ETX <= ACK or NAKThe text portion consists of two ASCII numeric characters whose value can be from 01-99. This corresponds to milliseconds, and the new value replaces the previous or default value of 5 ms.
=> STX, addr, addr, I, text, CS1, CS2, ETX <= ACK or NAKThe text is: nnnccc....cc
Where:
With V1.02 or higher of the 7526 microcode, the number of user variables and the size of the user variables are configurable..
This command is only available in Microcode 4.0 or above, and thus requires presence of the optional Ethernet-Serial-Parallel card.This command allows several terminal user variables to be set via a single host command. This greatly speeds the process due to the reduction in protocol packets involved.
The format for this command is:
=> STX, addr, addr, IM, text, CS1, CS2, ETX <= ACK or NAKThe text is: nnnlllccc....cc, RS, nnnlllccc....cc, RS, ...
Where:
This command will return NAK if any error occurs; there is no need to send CMD 1 to verify its success.
Note:
With V1.02 or higher of the 7526 microcode, the number of user variables and the size of the user variables are configurable..
The format for this command is:
=> STX, addr, addr, J9, CS1, CS2, ETX <= STX, J9, version, display, mode, ramsize, coprocessor, pio, CS1, CS2, ETXWhere:
A paragraph is equal to 16 bytes..
The format for this command is:
=> STX, ADDR, ADDR, K, text, CS1, CS2, ETX <= ACK or NAKWhere:
Even though the 7526 sequence number is currently only 2 bytes in length, this command uses 5 bytes. Therefore the first 3 bytes will always be zeros.
The text may also be 'XXXXX' to tell the terminal to release the first transaction in its queue regardless of its sequence number.
This command is valid only for Microcode 4.0 or above.Command L is used to test the communications link to a 7526.
The format for this command is:
=> STX, ADDR, ADDR, L, text, CS1, CS2, ETX <= STX, L, text, CS1, CS2, ETXWhere:
Refer to Chapter 9. "Writing Custom Function Routines" for details on using the CFR commands..
The format for this command is:
=> STX, addr, addr, MA, CS1, CS2, ETX <= STX, status, size, CS1, CS2, ETXThe status is a single binary byte as follows: 00 = No CFR loaded 01 = CFR in process of being loaded 02 = CFR enabled The size is one binary word and is in paragraphs. A zero size is returned if no space is allocated for a CFR.
Note:
A paragraph is equal to 16 bytes.l.CMD MB&mdash.Allocate Space for CFR
This command allocates space to load a CFR and returns a starting address in paragraphs.The format for this command is:
=> STX, addr, addr, MB, size, CS1, CS2, ETX <= STX, paragraph, CS1, CS2, ETXThe size is two bytes (binary) and is in paragraphs. The maximum size is determined by memory availability.The base paragraph address is returned (2 bytes, binary) to the controller. A base address of 0 is returned if there is insufficient memory. If a CFR is already loaded, this command disables it and initiates a new CFR load sequence.
Notes:
- The terminal must be out of service prior to execution of this command.
- The size and paragraph parameters may correspond to control characters that must be encoded (see "Control Characters").
- The initial size cannot be exceeded without resetting the terminal.
The format for this command is:
=> STX, addr, addr, MC, number, data, CS1, CS2, ETX <= ACK or NAKThe number (2 binary bytes, starting at zero) is a block counter to ensure that no data is lost or repeated.
The data is the CFR image, and may be transmitted in packets with a maximum length, including the control and transparency characters, of:
The format for this command is:
=> STX, addr, addr, MD, number, CS1, CS2, ETX <= ACK or NAKThe number (2 binary bytes) is the block counter as in CMD MC and must be one greater than the last number used in a CMD MC.
Notes:
The format for this command is:
=> STX, addr addr, P, mode, RS, CS1, CS2, ETX <= ACK or NAKWhere:
When File 0 is configured properly and loaded after executing CMD P, it overrides or changes the operating mode as set by CMD P. However, if CMD P is issued after completing a download of the 7526, it will override the effects of File 0 Record 00 Offset 203..
=> STX, addr, addr, Q, text, RS, CS1, CS2, ETX <= STX, Q, data, CS1, CS2, ETXThe text is:
The format for this command is:
=> STX, addr addr, R, paragraph, CS1, CS2, ETX <= STX, data, CS1, CS2, ETXWhere:
The format for this command is:
=> STX, addr addr, V, text, RS, CS1, CS2, ETX <= ACK or NAKThe text is a string of five or eight ASCII characters, ssffr
Where:
This feature is available in V2.00 and above..