This general macro allows as many as 8 data records to be issued using the
same base register by creating 1 combination data macro.
At times, 2 or more data macros refer to a single data record and it is
often necessary that only one base register be used. One example of
this is an input message (AM0SG) located in an output message (UI0OM).
Because of the philosophy of the assemblers, 2 separate data macros cannot be
issued with USING statements for the same registers. The DATAS macro
can be issued to resolve this problem.
Format
- label
- A symbolic name can be assigned to the macro statement. It must be
used if you wish to reissue a USING statement.
- Rx
- This is a required parameter. The valid registers are R1-R7, R14,
R15.
- suffix
- This is a required parameter. Is defines a one-character suffix to
be used.
- name
- This is the name of a data macro. Up to eight data macros may be
specified.
Entry Requirements
- The records expanded in this macro must be suffixed.
- To reissue a USING statement, the DATAS macro must be labeled and the
USING statement will reference this label.
- A suffix character cannot be used more than once in any assembly for any
particular data macro.
- Any data macro included in a combination macro can be defined with another
register by using no suffix or a different suffix.
- When more than one record type is processed in a program and these records
share the same register, it is advisable that single data macros be issued
just prior to the code that deals with this record type. The
combination macro should be used only when the same record is defined by more
than one data macro.
Return Conditions
All the specified data macros will have been issued with the suffix and the
same base register.
Programming Considerations
- This macro is limited to those data macros identified in DATAS source
code.
- The specified register will be the base register for all the data macros
issued.
- To reissue a USING statement, DATAS must be labelled, and the USING
statement will reference this label.
- The same suffix character cannot be used more than once in any assembly
for any one particular data macro.
- DATAS can be used more than once within the same program. The
restrictions on DATAS are the same as those on noncombination data
macros:
- The same suffix cannot be used more than once in any assembly for any one
particular data macro.
- Two separate data macros cannot be issued with USING statements for the
same register.
- The DATAS macro may be used on any I-stream.
Examples
DATAS R1,X,UI0OM,AM0SG