22.02.2015 Views

HLASM Language Reference

HLASM Language Reference

HLASM Language Reference

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.

Assembler <strong>Language</strong> Coding Conventions<br />

column of the next line, the SI and SO are considered redundant and are<br />

removed from the statement before statement analysis.<br />

An extended continuation-indicator provides a flexible end column on a<br />

line-by-line basis to support any alignment of double-byte data in a source<br />

statement. The end column of continued lines may be shifted to the left by<br />

extending the continuation-indicator.<br />

To guard against accidental continuation caused by double-byte data ending in<br />

the continuation-indicator column, neither SO nor SI is regarded as a<br />

continuation-indicator. If either is used, the following warning message is<br />

issued:<br />

ASMA21W SO or SI in continuation column - no continuation<br />

assumed<br />

The examples below show the use of these features. Refer to “Double-Byte<br />

Character Set Notation” on page xvi for the notation used in the examples.<br />

Source Input Considerations<br />

Extended continuation-indicators may be used in any source statement,<br />

including macro statements and statements included by the COPY instruction.<br />

| This feature is intended for source lines containing double-byte data, however it<br />

| becomes available to all lines when the DBCS option is set.<br />

On a line with a non-space continuation-indicator, the end column is the first<br />

column to the left of the continuation-indicator which has a value different from<br />

the continuation-indicator.<br />

When converting existing programs for assembly with the DBCS option, ensure<br />

that continuation-indicators are different from the adjacent data in the end<br />

column.<br />

The extended continuation-indicators must not be extended into the continue<br />

column, otherwise the extended continuation-indicators are treated as data, and<br />

the assembler issues the following error message:<br />

ASMA25E Extended continuation column must not extend into continue<br />

column<br />

For SI and SO to be removed at continuation points, the SI must be in the end<br />

column, and the SO must be in the continue column of the next line.<br />

Examples:<br />

Name Operation Operand Continuation<br />

│<br />

▼<br />

DBCS1 DC C'XXXXXXXXXXXXXXXXXXXX<br />

'<br />

DBCS2 DC C'abcdefghijklmnopqrstuvwxyz123456789XXXX<br />

'<br />

DBCS3 DC C'abcdefghijklmnopqrstuvXX<br />

'<br />

DBCS1: The DBCS1 constant contains 11 double-byte characters bracketed by SO<br />

and SI. The SI and SO at the continuation point are not assembled into the<br />

operand. The assembled value of DBCS1 is:<br />

<br />

Chapter 2. Coding and Structure 17

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

Saved successfully!

Ooh no, something went wrong!