Skip to content

Command Reference

Jump to bottom
Peter Kwan edited this page Sep 13, 2017 · 7 revisions

Commands implemented by the XPT620 control interface

Commands are a single character followed by parameters. There are no separators between the command and parameters.

Page Identity

A page identity is a five digit number of the format mppss. Trailing digits can be omitted and default to '0'. Digits may be replaced by a wildcard '*'. The fields are:-

  • m = Magazine Number. In the range '1' -'8'.
  • pp = Page Number. Two hexadecimal digits. In the range '00' 'FF'.
  • ss = Subpage. A two digit number in the range 00-99. This is an internal reference used to identify subpages and repeated page versions. In the range '00' – '99'.

The P command selects pages and other commands like M (modify) , L (set row) and R (read row) act on these selections.

L- Update Line

###Function Updates the specified line in the page or pages identified by the previous Select Page command. The text supplied as an argument is placed at the row specified in all the selected pages. Unlike the original ATP620/DTP620 protocol any overflow is truncated and not placed on subsequent rows.

Syntax

L11 - where:

  • L = Command Identifier.
  • ll = line number, 00 – 24 inclusive and 27.
  • = text to be pasted into the line starting at column 00.

Acknowledgements

The following acknowledgements are possible:-

  • 0 = Good command
  • 1 = Bad command, eg. line number out of range

Usage

To update a line or lines within a page or pages, first send a Select Page command to identify the page, or pages, to be changed and then send the Update Line Command.

To set a line within the selected page(s) to all spaces, send the L command with a zero length text string, e.g. the Update Line command L15 will set line 15 in all selected pages to spaces.

Notes

In the case of the command to update Line 00, the Header Row, the 9th - 39th characters inclusive of will be selected from the command and pasted into the corresponding column positions in that row. Columns 00-07 inclusive will be unchanged - thereby preserving the header control bytes.

P – Select Pages for Action

Function

The select page command is used to identify a page or set of pages for subsequent action. In defining the page or pages within a select page command, it is necessary to be able to identify the desired page or pages without ambiguity. This is done by use of the 'Page Identity', the constituent parts of which are explained in section 2.2.

Syntax

P - where:

Page Identity elements are defined above.

Acknowledgements

The following acknowledgements are possible:

  • 0 = Good Command. Page(s) specified identified within this unit. where : nnn = number of matched pages placed on Page Action List
  • 1 = Bad Command e.g. page identity unacceptable or wild card used and no match found.
  • <001>8 = Command valid but the page did not exist. This only works when not wildcarded and afterwards the page will exist as a newly created empty page.

Examples

P777 Page 777 subpage 00 will be selected.

P1**** All pages in magazine 1 will be selected

Clone this wiki locally