18.08.2013 Views

(SYSLIB) Programming Reference Manual - Public Support Login ...

(SYSLIB) Programming Reference Manual - Public Support Login ...

(SYSLIB) Programming Reference Manual - Public Support Login ...

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

SA$ICHART<br />

The character set type of the image read:<br />

01 ASCII/ISO 9-bit characters<br />

077 Attributed character data (ACD)<br />

A value of any ASCII-like character set type defined in Table H–1.<br />

SAR$ ATREAD<br />

If a Fieldata image is read, it is translated to ASCII/ISO before it is returned to the<br />

caller. See 17.3 for details on allowed input character set types.<br />

19.2.1.4. ATREAD Packet Definition PROC (S$ARATRDEF)<br />

The S$ARATRDEF PROC generates the EQUFs to define the ATREAD packet. The<br />

calling program may optionally attach an X-register and a B-register to these EQUFs.<br />

This allows the calling program to allocate storage space for the ATREAD packet either<br />

statically at assembly time or dynamically at execution time. The calling program may<br />

display the EQUF labels by setting the display-flag parameter on the PROC call.<br />

This PROC also generates EQUs defining the ATREAD packet current version and word<br />

length at labels SA$CURVER and SA$PKTWLEN, respectively.<br />

Calling Format<br />

S$ARATRDEF x-reg,b-reg,dispflg<br />

Parameters<br />

x-reg<br />

b-reg<br />

dispflg<br />

The X-register to be attached to the ATREAD packet EQUFs. If it is omitted, no<br />

X-register is attached to the EQUFs.<br />

The B-register to be attached to the ATREAD packet EQUFs. If it is omitted, no<br />

B-register is attached to the EQUFs.<br />

A flag to display a table of the ATREAD packet EQUFs. If it is set to 'D', the field<br />

names are displayed; otherwise the field names are not displayed.<br />

Example<br />

$ASCII<br />

$INCLUDE ‘MAXR$’<br />

S$ARATRDEF X6,B3,‘D’<br />

The PROC call S$ARATRDEF generates EQUFs using registers X6 and B3 and displays a<br />

description of each packet field.<br />

7833 1733–004 19–17

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!