Table of Contents
Advertisement
HOST COMMAND SET REFERENCE
5.4.6
Gather Macro Response — 15
The GATHER MACRO RESPONSE command returns one or more macro
responses to the host computer. You can choose to retrieve the entire macro
response buffer data along with the MRSW or just the MRSW. You can also
choose to retrieve all the buffers specified or just those with their exception flags
set. The exception flag is cleared when the response buffer data is returned.
Command:
15 ss tt [bb]
Response:
15 ss tt [bb aa cccc llll pppp...]
Usage:
OPERATION
Modes:
MHIU, HIU
Parameters:
ss
The Source Id number.
tt
The response type which qualifies which buffers will be returned
and what kind of buffer data to return. If no buffers are qualified,
only the 'ss' and 'tt' fields are returned.
00 = Return all buffer data.
01 = For the macro buffer numbers requested, return the buffer
data only for those with their exception flags set.
02 = Same as option 01, but do not return the Primitive field
(pppp...). This option will not clear the exception flag since no
response data is returned.
bb
The macro buffer number to gather the response from. If 'bb'
equals 00, the HIU will ignore the 'tt' parameter and select the
first buffer for the Source Id to set its exception flag. Since the
exception flag is cleared when this command is processed, this
buffer will not be selected again until it sets the exception flag
again.
When selecting several specific buffers you must make sure that
the combined length of all responses will not exceed the
maximum message length or an ERROR RESPONSE will be
returned. The maximum message length is 290 bytes for the
BDLC protocol and 580 bytes for the NITP protocol, including the
command code and other parameters.
aa
The secondary device address to send the macro command to.
cccc
The Macro Response Status Word (MRSW) which indicates the
status of the macro response and the number of times the macro
has been updated as given in Table 5–3. The Termination Codes
are defined in Chapter 6.
5–31
UNILINK HOST ADAPTER
USER MANUAL
Advertisement
Table of Contents
