HLASM Language Reference
HLASM Language Reference HLASM Language Reference
SIGNED Format: Logical-expression, function-invocation Operands: Arithmetic Output: SIGNED(aexpr) or (SIGNED aexpr) converts its arithmetic argument to a decimal character string representation of its value, with a leading minus sign if the argument is negative. Examples SIGNED(1) SIGNED(-1) | SYSATTRA | Format: Function-invocation | Operands: Character has value '1' has value '-1' Note: The SIGNED function creates properly signed values for display, whereas assigning a SETA value to a SETC variable produces only the magnitude of the SETA value. For example: &A SETA 1 &A has value 1 &C SETC '&A' &C has value '1' &A SETA -1 &A has value -1 &C SETC '&A' &C has value '1' (unsigned) | Output: SYSATTRA('symbol') returns the assembler-type value for the | specified symbol. | The 1 to 4 assembler type is returned, with trailing spaces removed. | Symbols without an assigned assembler type return null. | Examples | Given that symbol Sym1 has previously been assigned an assembler type of | GR, and variable symbol &SName has a value of SYM1, then: | SYSATTRA('Sym1') has value 'GR' | SYSATTRA('&Sname') has value 'GR' | SYSATTRP | Format: Function-invocation | Operands: Character | Output: SYSATTRP('symbol') returns the program-type value for the specified | symbol. | The 4 byte program type is returned. | Symbols without an assigned program type return null. | Examples | Given that symbol Sym1 has previously been assigned a program type of | “Box7,” and variable symbol &SName has a value of SYM1, then: | SYSATTRP('Sym1') has value 'Box7' | SYSATTRP('&SName') has value 'Box7' UPPER Format: Logical-expression, function-invocation Operands: Character 380 HLASM V1R5 Language Reference
| X2B Output: UPPER('cexpr') or (UPPER 'cexpr') converts the alphabetic characters a-z in the argument to upper case, A-Z. Null arguments return a null string. Examples UPPER('aBcDefG') | Format: Function-invocation | Operands: Character has value 'ABCDEFG' | Output: X2B('hexstring') converts the value of its argument string of | hexadecimal characters to a character string containing only zero ('') and | one ('1') characters representing the same bit pattern. Null arguments return | a null string. | If the result is not too long, the length of the result is four times the length of | the 'hexstring' argument. | The operand must contain only hexadecimal digits. Any other value causes | the message ASMA214E to be generated. | Examples | X2B('') has value '' (null string) | X2B('') has value '' | X2B('1') has value '1' | X2B('F3') has value '111111' | X2B('F3') has value '111111' | X2C | Format: Function-invocation | Operands: Character | Output: X2C('hexstring') converts the hexstring argument to characters | representing the same bit pattern. Null arguments return a null string. | If needed, the argument string is padded internally on the left with a zero | character so that its length is a multiple of two. | The operand must contain only hexadecimal digits. Any other value causes | the message ASMA214E to be generated. | Examples | X2C('') has value '' (null string) | X2C('F3') has value '3' | X2C('') has value 'n' (EBCDIC null character) | X2C('F1F2F3F4F5') has value '12345' | X2C('F1') has value 'nn1' | X2D | Format: Function-invocation | Operands: Character | Output: X2D('hexstring') converts its argument string of at most eight | hexadecimal characters to one to ten decimal characters preceded by a plus | or minus sign, representing the value of the argument. Null arguments return | '+'. For example: Chapter 9. How to Write Conditional Assembly Instructions 381
- Page 350 and 351: Data Attributes The following attri
- Page 352 and 353: Data Attributes Assembler gives a t
- Page 354 and 355: Data Attributes The scale attribute
- Page 356 and 357: Data Attributes Number Attribute (N
- Page 358 and 359: Data Attributes The operation code
- Page 360 and 361: Lookahead MACRO &NAME MOVE &TO,&FRO
- Page 362 and 363: Open Code Sequence Symbols The cond
- Page 364 and 365: GBLA, GBLB, and GBLC Instructions G
- Page 366 and 367: LCLA, LCLB, and LCLC Instructions s
- Page 368 and 369: SETA Instruction expression is an a
- Page 370 and 371: SETA Instruction | The logical-exp
- Page 372 and 373: SETA Instruction | Figure 99 (Page
- Page 374 and 375: SETA Instruction | The result of C2
- Page 376 and 377: SETA Instruction NOT Format: Logica
- Page 378 and 379: SETA Instruction | X2A Name Operati
- Page 380 and 381: SETA Instruction In evaluating the
- Page 382 and 383: SETB Instruction Any expression tha
- Page 384 and 385: SETB Instruction ┌─────
- Page 386 and 387: SETB Instruction | ISDEC | Format:
- Page 388 and 389: SETB Instruction The two comparands
- Page 390 and 391: SETC Instruction Notes: 1. The asse
- Page 392 and 393: Figure 103. Substring Notation in C
- Page 394 and 395: Loc Object Code Addr1 Addr2 Stmt So
- Page 396 and 397: | B2C('111111') has value '3' | B2C
- Page 398 and 399: | Output: D2B('decstring') converts
- Page 402 and 403: | X2D('') has value '+' | X2D('91')
- Page 404 and 405: Concatenation of strings containing
- Page 406 and 407: MACRO &NAME MOVE &TO,&FROM LCLC &PR
- Page 408 and 409: SETAF Instruction Alternative State
- Page 410 and 411: Branching Branching You can control
- Page 412 and 413: AGO Instruction The extended AIF in
- Page 414 and 415: ACTR Instruction AGOB—Synonym of
- Page 416 and 417: ANOP Instruction statement processe
- Page 418 and 419: MHELP Instruction MHELP B'10000000'
- Page 420 and 421: 400 HLASM V1R5 Language Reference
- Page 422 and 423: Assembler Instructions and Statemen
- Page 424 and 425: Assembler Instructions and Statemen
- Page 426 and 427: Assembler Instructions and Statemen
- Page 428 and 429: Summary of Constants Figure 113. Su
- Page 430 and 431: Macro and Conditional Assembly Lang
- Page 432 and 433: Macro and Conditional Assembly Lang
- Page 434 and 435: Macro and Conditional Assembly Lang
- Page 436 and 437: Macro and Conditional Assembly Lang
- Page 438 and 439: Macro and Conditional Assembly Lang
- Page 440 and 441: Macro and Conditional Assembly Lang
- Page 442 and 443: Standard Character Set Code Table H
- Page 444 and 445: Standard Character Set Code Table H
- Page 446 and 447: Trademarks AIX BookMaster CICS DFSM
- Page 448 and 449: Bibliography SMP/E Reference, SC28-
SIGNED<br />
Format: Logical-expression, function-invocation<br />
Operands:<br />
Arithmetic<br />
Output: SIGNED(aexpr) or (SIGNED aexpr) converts its arithmetic argument to<br />
a decimal character string representation of its value, with a leading minus<br />
sign if the argument is negative.<br />
Examples<br />
SIGNED(1)<br />
SIGNED(-1)<br />
| SYSATTRA<br />
| Format: Function-invocation<br />
| Operands: Character<br />
has value '1'<br />
has value '-1'<br />
Note: The SIGNED function creates properly signed values for display,<br />
whereas assigning a SETA value to a SETC variable produces only the<br />
magnitude of the SETA value. For example:<br />
&A SETA 1 &A has value 1<br />
&C SETC '&A' &C has value '1'<br />
&A SETA -1 &A has value -1<br />
&C SETC '&A' &C has value '1' (unsigned)<br />
| Output: SYSATTRA('symbol') returns the assembler-type value for the<br />
| specified symbol.<br />
| The 1 to 4 assembler type is returned, with trailing spaces removed.<br />
| Symbols without an assigned assembler type return null.<br />
| Examples<br />
| Given that symbol Sym1 has previously been assigned an assembler type of<br />
| GR, and variable symbol &SName has a value of SYM1, then:<br />
| SYSATTRA('Sym1') has value 'GR'<br />
| SYSATTRA('&Sname') has value 'GR'<br />
| SYSATTRP<br />
| Format: Function-invocation<br />
| Operands: Character<br />
| Output: SYSATTRP('symbol') returns the program-type value for the specified<br />
| symbol.<br />
| The 4 byte program type is returned.<br />
| Symbols without an assigned program type return null.<br />
| Examples<br />
| Given that symbol Sym1 has previously been assigned a program type of<br />
| “Box7,” and variable symbol &SName has a value of SYM1, then:<br />
| SYSATTRP('Sym1') has value 'Box7'<br />
| SYSATTRP('&SName') has value 'Box7'<br />
UPPER<br />
Format: Logical-expression, function-invocation<br />
Operands: Character<br />
380 <strong>HLASM</strong> V1R5 <strong>Language</strong> <strong>Reference</strong>