General
Application area: | Multiprocessor systems; see "Multiprocessor systems" |
Macro type: | Type S, MF format 1: standard/L/E form; see "S-type macros" |
The new macro MCSINFO is available as of BS2000/OSD-BC V3.0 and replaces the MRSINF and MRSSTA macros.
Macro description
This macro is only available to users of the multiprocessor system (see the “HIPLEX MSCF” manual [26 (Related publications)]).
The MRSSTA macro gives information on all active and potential connections between the local processor and other processors in the MSCF network.
Macro format and description of operands
MRSSTA |
{HOST={’bcamname’ / addr1 / (r1)} / AREA={addr2 / (r2)}} ,MF=S / (E,..) / L |
HOST=
Specifies a host computer whose connection to the local processor is to be interrogated.If this operand is specified, an appropriate return code will be set in register R15 only.
bcamname
Is the processor's BCAM name (as defined during BCAM generation).
addr1
Symbolic address of a BCAM name.
(r1)
r1 = Register that contains the address of the BCAM name.
AREA=
Specifies the address of an area in which all active and potential connections to the local processor are to be stored. The area must start on a halfword boundary. Before a macro is called, the length of the user area must be entered in the first two bytes (length field). After
the macro is executed the length field will contain the total length of all entries for the processor name. The first name is always the name of the local processor. If the HOST operand is also specified, the AREA operand will be ignored.
After execution of the macro, the area specified by AREA contains the following information:
Byte 1 - 8: | Processor name |
Byte 9: | Return code from register R15, which is set when the HOST operand is |
Byte 10: | X'FF' in the last entry, otherwise X'00' |
addr2
Symbolic address of the area in which the connections are to be stored.
(r2)
r2 = register which contains the address of the area
MF=
For a general description of the MF operand, its operand values and any subsequent operands (e.g. for a prefix), see section “S-type macros”. The valid MF values are given at the start of the macro description under “Macro type” and are included in the macro format.
Notes
Since the length of a processor name entry is 10 bytes, the required size of the user area is calculated as number of processors * 10 + 2 bytes.
See also the “HIPLEX MSCF” manual [26 (Related publications)] for information on MSCF communication.
Return information and error flags
R15:
+---------------+ | | | | | |0|0|0|0|0|0|a|a| +---------------+
A return code relating to the execution of the MRSSTA macro is transferred in the rigtmost byte of register R15.
Return code | Meaning |
X'00' | HOST is local. |
X'00' | All known processor names are stored in the user area. |
X'04' | HOST is connected to the local MSCF. |
X'08' | HOST is not connected to the local processor. |
X'0C' | MSCF communication is not active. |
X'10' | Processor unknown in MSCF network. |
X'14' | Operand error. |
X'18' | Specified length too small to store all names. |
X'FF' | MSCF is not included in this BS2000. |
X'04A7' | Invalid address of the MRSSTA operand list. |