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.

SIR$–Symbolic Input/Output Routine<br />

A4<br />

A5<br />

The current line number of the symbolic input file or element. Register A4 is zero for<br />

new images read from the runstream. The line number for each image is the same<br />

for all passes.<br />

An actual or generated CTS line number.<br />

23.2.5. GETNM$–Get Symbolic Image Without Translation<br />

GETNM$ obtains a symbolic input image and returns it to the calling program with no<br />

translation. If symbolic output is specified, SIR$ writes the image to the output file or<br />

element.<br />

Calling Sequence<br />

L A0,(buffer-length,buffer-addr)<br />

LMJ X11,GETNM$<br />

error return<br />

end-of-file return<br />

normal return<br />

where:<br />

buffer-length<br />

The length in words of the buffer into which the symbolic input images are read.<br />

buffer-addr<br />

The address of the buffer into which the symbolic input images are read.<br />

Returns<br />

The GETNM$ entry point is called to obtain the next input image from the source input<br />

or the runstream and to pass the image to the calling program without translation. Input<br />

images in Fieldata, ASCII, and the 39 ASCII-like CCSs are passed without change to the<br />

calling program. An exception is that when the image to be returned is ASCII or<br />

ASCII-like and when the P option is either specified or assumed, requesting Fieldata<br />

source output, lowercase alphabetics are changed to uppercase alphabetics when the<br />

image is passed to the calling program. If SIR$ was initialized with INISR$ and A4 bit 2<br />

was set, input images in the 22 “other” CCSs are passed to the calling program. If SIR$<br />

was initialized with OPNSR$ or if SIR$ was initialized with INISR$ but A4 bit 2 was clear,<br />

input images in the 22 “other” CCSs are not passed to the calling program, but instead<br />

result in an error return.<br />

23–18 7833 1733–004

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

Saved successfully!

Ooh no, something went wrong!