High Level Assembler for z/OS & z/VM & z/VSE. Language Reference (Version 1 Release 6) - page 23
Table 71. Attributes (continued)
Can be used only if
Attribute
Notation
Can be used with:
Type Attribute is:
Can be used in:
Integer
I'
Ordinary symbols
H,F,G,D,E,L,K,P, and Z
SETA and ordinary
defined in open code;
arithmetic
symbolic parameters
expressions
inside macro
definitions;
&SYSLIST(n), and
&SYSLIST(n,m) inside
macro definitions
Count
K'
Symbolic parameters
Any letter or @ or $
SETA and ordinary
inside macro
arithmetic
definitions;
expressions
&SYSLIST(n), and
&SYSLIST(n,m) inside
macro definitions;
SET symbols; all
system variable
symbols
Number
N'
Symbolic parameters,
Any value
SETA and ordinary
&SYSLIST and
arithmetic
&SYSLIST(n) inside
expressions
macro definitions,
with dimensioned
SET symbols
Defined
D'
Ordinary symbols
Any value except M, N, O,
SETA arithmetic
defined in open code;
T, U
expressions
symbolic parameters
inside macro
definitions; &SYSLIST
and &SYSLIST(n)
inside macro
definitions; SETC
symbols whose value
is an ordinary symbol
Operation
O'
A character string, or
@, $, and any letter except
SETC expressions
Code
variable symbol
N, O and (only sometimes)
containing a character
U
Character relations
string.
Refer to Chapter 9, “How to write conditional assembly instructions,” on page 319
for usage restrictions of the attributes in Table 71 on page 420.
Table 72. Variable symbols
Variable
Declared
Initialized
Value changed Can be used
Symbol
by:
or set to:
by:
in:
Symbolic¹
Prototype
Corresponding
Constant
Arithmetic
parameter
statement
macro
throughout
expressions if operand
instruction
definition
is self-defining term
operand
Character expressions
SETA
LCLA or
0
SETA
Arithmetic
GBLA
instruction
expressions
instruction
Character expressions
Logical expressions
Appendix C. Macro and conditional assembly language summary
421
Table 72. Variable symbols (continued)
Variable
Declared
Initialized
Value changed Can be used
Symbol
by:
or set to:
by:
in:
SETB
LCLB or
0
SETB
Arithmetic
GBLB
instruction
expressions
instruction
Character expressions
Logical expressions
SETC
LCLC or
String of length SETC
Arithmetic
GBLC
0 (null)
instruction
expressions if value is
instruction
self-defining term
Character expressions
Logical expressions if
value is self-defining
term
Notes:
1. Can be used only in macro definitions.
Table 73. System variable symbols
Avail-
Type
Value
System Variable Symbol
ability¹
Type²
Attr.³
Scope
Initialized or set to
changed by
Can be used in
|
&SYS_HLASM_PTF
All
C
U
G
PTF level
Constant
Character
|
throughout
expressions
|
assembly
|
&SYS_HLASM_RPM
All
C
U
G
RPM level
Constant
Character
|
throughout
expressions
|
assembly
&SYSADATA_DSN
HLA2
C
U,O
L
Current® associated data
Constant
Character
file
throughout
expressions
assembly
&SYSADATA_MEMBER
HLA2
C
U,O
L
Current associated data
Constant
Character
file member name
throughout
expressions
assembly
&SYSADATA_VOLUME
HLA2
C
U,O
L
Current associated data
Constant
Character
file volume identifier
throughout
expressions
assembly
&SYSASM
HLA1
C
U
G
Assembler name
Constant
Character
throughout
expression
assembly
&SYSCLOCK
HLA3
C
U
L
Current date and time
Constant
Character
throughout
expressions
macro
expansion
&SYSDATC
HLA1
C,A
N
G
Assembly date (with
Constant
Arithmetic
century)
throughout
expressions
assembly
Character
expressions
&SYSDATE
AsmH
C
U
G
Assembly date
Constant
Character
throughout
expressions
assembly
422
HLASM V1R6 Language Reference
Table 73. System variable symbols
(continued)
Avail-
Type
Value
System Variable Symbol
ability¹
Type²
Attr.³
Scope
Initialized or set to
changed by
Can be used in
&SYSECT
All
C
U
L
Name of control section
Constant
Character
in effect where macro
throughout
expressions
instruction appears
definition; set
by START,
CSECT,
RSECT,
DSECT, or
COM
&SYSIN_DSN
HLA1
C
U
L
Current primary input
Constant
Character
data set name
throughout
expressions
definition
&SYSIN_MEMBER
HLA1
C
U,O
L
Current primary input
Constant
Character
member name
throughout
expressions
definition
&SYSIN_VOLUME
HLA1
C
U,O
L
Current primary input
Constant
Character
volume identifier
throughout
expressions
definition
&SYSJOB
HLA1
C
U
G
Source module assembly
Constant
Character
job name
throughout
expressions
assembly
&SYSLIB_DSN
HLA1
C
U
L
Current macro library
Constant
Character
filename
throughout
expressions
definition
&SYSLIB_MEMBER
HLA1
C
U,O
L
Current macro library
Constant
Character
member name
throughout
expressions
definition
&SYSLIB_VOLUME
HLA1
C
U,O
L
Current macro library
Constant
Character
volume identifier
throughout
expressions
definition
&SYSLIN_DSN
HLA2
C
U
L
Current object data set
Constant
Character
name
throughout
expressions
assembly
&SYSLIN_MEMBER
HLA2
C
U,O
L
Current object data set
Constant
Character
member name
throughout
expressions
assembly
&SYSLIN_VOLUME
HLA2
C
U,O
L
Current object data set
Constant
Character
volume identifier
throughout
expressions
assembly
&SYSLIST
All
C
any
L
Not applicable
Not applicable
N'&SYSLIST in
arithmetic
expressions
&SYSLIST(n)&SYSLIST(n,m)
All
C
any
L
Corresponding macro
Constant
Arithmetic
instruction operand
throughout
expressions if
definition
operand is
self-defining
term
Character
expressions
&SYSLOC
AsmH
C
U
L
Location counter in effect
Constant
Character
where macro instruction
throughout
expressions
appears
definition; set
by START,
CSECT,
RSECT,
DSECT, COM,
and LOCTR
Appendix C. Macro and conditional assembly language summary
423
Table 73. System variable symbols
(continued)
Avail-
Type
Value
System Variable Symbol
ability¹
Type²
Attr.³
Scope
Initialized or set to
changed by
Can be used in
&SYSMAC
HLA3
C
U,O
L
Macro name
Constant
Arithmetic
throughout
expressions
definition
&SYSMAC(n)₁
HLA3
C
U,O
L
Ancestor macro name
Constant
Arithmetic
throughout
expressions
definition
&SYSM_HSEV
HLA3
A
N
G
0
Mnote
Arithmetic
expressions
&SYSM_SEV
HLA3
A
N
G
0
At nesting and
Arithmetic
unnesting of
expressions
macros, from
MNOTE
&SYSNDX
All
C
N
L
Macro instruction index
Constant
Arithmetic
throughout
expressions
definition;
unique for
Character
each macro
expressions
instruction
&SYSNEST
HLA1
A
N
L
Macro instruction nesting
Constant
Arithmetic
level
throughout
expressions
definition;
unique for
Character
each macro
expressions
nesting level
|
&SYSOPT_CURR_OPTABLE
All
C
U
G
Current OPTABLE
ACONTROL
Character
|
OPTABLE
expressions
|
statements
&SYSOPT_DBCS
HLA1
B
N
G
DBCS assembler option
Constant
Arithmetic
indicator
throughout
expressions
assembly
Character
expressions
Logical
expressions
&SYSOPT_OPTABLE
HLA3
C
U
G
OPTABLE assembler
Constant
Character
option value
throughout
expressions
assembly
&SYSOPT_RENT
HLA1
B
N
G
RENT assembler option
Constant
Arithmetic
indicator
throughout
expressions
assembly
Character
expressions
Logical
expressions
&SYSOPT_XOBJECT
HLA3
B
N
G
XOBJECT assembler
Constant
Arithmetic
option indicator
throughout
expressions
assembly
Character
expressions
Logical
expressions
424
HLASM V1R6 Language Reference
Table 73. System variable symbols
(continued)
Avail-
Type
Value
System Variable Symbol
ability¹
Type²
Attr.³
Scope
Initialized or set to
changed by
Can be used in
&SYSPARM
All
C
U,O
G
User defined or null
Constant
Arithmetic
throughout
expressions if
assembly
value is
self-defining
term
Character
expressions
&SYSPRINT_DSN
HLA2
C
U
L
Current assembler listing
Constant
Character
data set name
throughout
expressions
assembly
&SYSPRINT_MEMBER
HLA2
C
U,O
L
Current assembler listing
Constant
Character
data set member name
throughout
expressions
assembly
&SYSPRINT_VOLUME
HLA2
C
U,O
L
Current assembler listing
Constant
Character
data set volume identifier
throughout
expressions
assembly
&SYSPUNCH_DSN
HLA2
C
U
L
Current object data set
Constant
Character
name
throughout
expressions
assembly
&SYSPUNCH_MEMBER
HLA2
C
U,O
L
Current object data set
Constant
Character
member name
throughout
expressions
assembly
&SYSPUNCH_VOLUME
HLA2
C
U,O
L
Current object data set
Constant
Character
volume identifier
throughout
expressions
assembly
&SYSSEQF
HLA1
C
U,O
L
Outer-most macro
Constant
Character
instruction identification-
throughout
expressions
sequence field
definition
&SYSSTEP
HLA1
C
U
G
Source module assembly
Constant
Character
job name
throughout
expressions
assembly
&SYSSTMT
HLA1
C,A
N
G
Next statement number
Assembler
Arithmetic
increments
expressions
each time a
statement is
Character
processed
expressions
&SYSSTYP
HLA1
C
U,O
L
Type of control section in
Constant
Character
effect where macro
throughout
expressions
instruction appears
definition; set
by START,
CSECT,
RSECT,
DSECT, or
COM
&SYSTEM_ID
HLA1
C
U
G
Assembly operating
Constant
Character
system environment
throughout
expressions
identifier
assembly
&SYSTERM_DSN
HLA2
C
U
L
Current terminal data set
Constant
Character
name
throughout
expressions
assembly
&SYSTERM_MEMBER
HLA2
C
U,O
L
Current terminal data set
Constant
Character
member name
throughout
expressions
assembly
&SYSTERM_VOLUME
HLA2
C
U,O
L
Current terminal data set
Constant
Character
volume identifier
throughout
expressions
assembly
Appendix C. Macro and conditional assembly language summary
425
Table 73. System variable symbols (continued)
Avail-
Type
Value
System Variable Symbol
ability¹
Type²
Attr.³
Scope
Initialized or set to
changed by
Can be used in
&SYSTIME
AsmH
C
U
G
Source module assembly
Constant
Character
time
throughout
expressions
assembly
&SYSVER
HLA1
C
U
G
Assembler release level
Constant
Character
throughout
expressions
assembly
Notes:
1. Availability:
All
All assemblers, including the DOS/VSE Assembler
AsmH
Assembler H Version 2 and High Level Assembler
HLA1
High Level Assembler Release 1
HLA2
High Level Assembler Release 2
HLA3
High Level Assembler Release 3
HLA4
High Level Assembler Release 4
HLA5
High Level Assembler Release 5
2. Type:
A
Arithmetic
B
Boolean
C
Character
3. Type Attr:
N
Numeric (self-defining term)
O
Omitted
U
Undefined, unknown, deleted, or unassigned
4. Scope:
L
Local - only in macro
G
Global - in entire program
426
HLASM V1R6 Language Reference
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
Mail Station P300
2455 South Road
Poughkeepsie New York 12601-5400
U.S.A.
Such information may be available, subject to appropriate terms and conditions,
including in some cases, payment of a fee.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law: INTERNATIONAL
BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
427
PURPOSE. Some states do not allow disclaimer of express or implied warranties in
certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
If you are viewing this information softcopy, the photographs and color
illustrations may not appear.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the Web at Copyright and
trademark information at http://www.ibm.com/legal/copytrade.shtml.
Linux is a registered trademark of Linus Torvalds in the United States, other
countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
428
HLASM V1R6 Language Reference
Bibliography
High Level Assembler Documents
HLASM General Information, GC26-4943
HLASM Installation and Customization Guide, SC26-3494
HLASM Language Reference, SC26-4940
HLASM Programmer's Guide, SC26-4941
Toolkit Feature document
HLASM Toolkit Feature User's Guide, GC26-8710
HLASM Toolkit Feature Debug Reference Summary, GC26-8712
HLASM Toolkit Feature Interactive Debug Facility User's Guide, GC26-8709
HLASM Toolkit Feature Installation and Customization Guide, GC26-8711
Related documents (Architecture)
z/Architecture Principles of Operation, SA22-7832
Related documents for z/OS
z/OS:
z/OS MVS JCL Reference, SA23-1385
z/OS MVS JCL User's Guide, SA23-1386
z/OS MVS Programming: Assembler Services Guide, SA23-1368
z/OS MVS Programming: Assembler Services Reference, Volume 1 (ABE-HSP),
SA23-1369
z/OS MVS Programming: Assembler Services Reference, Volume 2 (IAR-XCT),
SA23-1370
z/OS MVS Programming: Authorized Assembler Services Guide, SA23-1371
z/OS MVS Programming: Authorized Assembler Services Reference, Volumes 1 - 4,
SA23-1372 - SA23-1375
z/OS MVS Program Management: User's Guide and Reference, SA23-1393
z/OS MVS System Codes, SA38-0665
z/OS MVS System Commands, SA38-0666
z/OS MVS System Messages, Volumes 1 - 10, SA38-0668 - SA38-0677
z/OS Communications Server: SNA Programming, SC27-3674
UNIX System Services:
z/OS UNIX System Services User's Guide, SA23-2279
DFSMS/MVS:
z/OS DFSMS Program Management, SC27-1130
z/OS DFSMSdfp Utilities, SC23-6864
TSO/E (z/OS):
z/OS TSO/E Command Reference, SA32-0975
SMP/E (z/OS):
SMP/E for z/OS Messages, Codes, and Diagnosis, GA32-0883
SMP/E for z/OS Reference, SA23-2276
SMP/E for z/OS User's Guide, SA23-2277
429
Related documents for z/VM
z/VM: VMSES/E Introduction and Reference, GC24-6243
z/VM: Service Guide, GC24-6247
z/VM: CMS Commands and Utilities Reference, SC24-6166
z/VM: CMS File Pool Planning, Administration, and Operation, SC24-6167
z/VM: CP Planning and Administration, SC24-6178
z/VM: Saved Segments Planning and Administration, SC24-6229
z/VM: Other Components Messages and Codes, GC24-6207
z/VM: CMS and REXX/VM Messages and Codes, GC24-6161
z/VM: CP System Messages and Codes, GC24-6177
z/VM: CMS Application Development Guide, SC24-6162
z/VM: CMS Application Development Guide for Assembler, SC24-6163
z/VM: CMS User's Guide, SC24-6173
z/VM: XEDIT User's Guide, SC24-6245
z/VM: XEDIT Commands and Macros Reference, SC24-6244
z/VM: CP Commands and Utilities Reference, SC24-6175
Related documents for z/VSE
z/VSE: Guide to System Functions, SC33-8312
z/VSE: Administration, SC34-2627
z/VSE: Installation, SC34-2631
z/VSE: Planning, SC34-2635
z/VSE: System Control Statements, SC34-2637
z/VSE: Messages and Codes, Vol.1 , SC34-2632
z/VSE: Messages and Codes, Vol.2, SC34-2633
z/VSE: Messages and Codes, Vol.3, SC34-2634
REXX/VSE Reference, SC33-6642
REXX/VSE User's Guide, SC33-6641
430
HLASM V1R6 Language Reference