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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

18.1.3.1. SAR_OPEN_OUTPUT Procedure Call<br />

SAR$ WRITE<br />

The WRITE packet data structure must be initialized before any images are written out.<br />

The SAR_OPEN_OUTPUT procedure performs the WRITE packet initialization.<br />

Initial Conditions<br />

The calling program sets the following parameters in the WRITE packet to appropriate<br />

values before calling SAR_OPEN_OUTPUT:<br />

• Required parameters (described in 18.1.1.1)<br />

PACKET_VERSION<br />

OUTPUT_FILE_INFO_PACKET_ADDRESS<br />

OUTPUT_BUFFER_ADDRESS<br />

OUTPUT_BUFFER_WORD_LENGTH<br />

IMAGE_BUFFER_ADDRESS<br />

IMAGE_BUFFER_WORD_LENGTH<br />

• Optional parameters (described in 18.1.1.2)<br />

OUTPUT_FILE_TYPE<br />

OUTPUT_LINE_NUMBER_TYPE<br />

OUTPUT_IMAGE_CHARACTER_TYPE<br />

UNTRANSLATE_MODE<br />

GENERAL_SDF_LABEL_FLAG<br />

CLOSING_BREAKPOINT_FLAG<br />

TRIM_BLANKS_FLAG<br />

IMAGE_CONTROL_WIDTH<br />

Note: The calling program must zero-fill the WRITE packet before placing any<br />

parameters in the packet.<br />

Calling Format<br />

PROCEDURE SAR_OPEN_OUTPUT<br />

(WRITE_PACKET_ADDRESS: WORD MACHINE POINTER)<br />

IMPORTED ('SAR$OPENO$PG');<br />

Returns<br />

SAR_OPEN_OUTPUT returns the initialization status in the WRITE packet field<br />

CALL_STATUS. If the status is S'Normal', the initialization of the WRITE packet is<br />

successful. Otherwise, an error has occurred and CALL_STATUS contains the status<br />

code. See 18.1.4 for a list of WRITE function status codes.<br />

7833 1733–004 18–13

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

Saved successfully!

Ooh no, something went wrong!