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

Section 4
AEDIT$–ASCII Image Composition
Editing Package
The AEDIT$ package is a set of ASCII editing subroutines. The calling program uses
these subroutines to compose strings of ASCII characters in a specified data area.
AEDIT$ is helpful in composing ASCII images for
• ASCII output printed by ER APRINT$, ER APRNTA$, and ER SYMB$ (PRINT$)
• ASCII output punched by ER APUNCH$, ER APNCHA$, and ER SYMB$ (PUNCH$)
• Other Executive requests that require ASCII images, such as ER ASCF$, ER CSI$,
and ER QECL$
• Any other applications that require ASCII images
AEDIT$ uses the full ASCII character set. Images are built up from individual characters
or groups of characters or by copying character strings from other data areas. AEDIT$
allows the calling program to use column settings when composing the ASCII image.
AEDIT$ edits numeric data into ASCII characters. This includes decimal, octal, and
floating-point numbers. The floating-point numbers can be either single-precision or
double-precision. AEDIT$ also creates an ASCII string containing the date and time,
using standard formats. AEDIT$ uses the current date and time, or a date and time
specified by the calling program.
AEDIT$ places the composed image in the data area or buffer provided by the calling
program.
AEDIT$ is reentrant and does not use any D-bank storage. The calling program supplies
the packet for AEDIT$, which is used to pass information to and from the AEDIT$
routines. The size of the AEDIT$ packet is 17 words. The packet format is described in
4.1.
AEDIT$ is available in both relocatable and common bank versions. The relocatable and
common bank entry points for the AEDIT$ routines are listed in Appendix E.
AEDIT$ establishes an "edit mode" while the image is being composed. The edit mode
begins when the A$EDIT or A$EDITR PROCs are called and terminates when the
A$EDITX or A$EPRINT PROCs are called. The AEDIT$ routines use the volatile register
set. In addition, the relocatable version of AEDIT$ saves the contents of and uses
registers X1, X2, and X3 during edit mode. These registers must not be modified during
edit mode. AEDIT$ restores the original contents when exiting edit mode.
7833 1733–004 4–1