Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Ping Packet is used by Ping Messages (section 2.1.2) to allow an initiator to determine whether an acceptor is available and can accept a binary protocol sequence connection.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Flags |
Signature |
||||||||||||||||||||||||||||||
|
Cookie |
|||||||||||||||||||||||||||||||
|
QMGuid (16 bytes) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
Flags (2 bytes): A 16-bit unsigned short integer field that provides additional information about the packet.
-
Fields marked X are unused. They MAY be set when sent. They MUST be ignored on receipt.<19>
-
0
1
2
3
4
5
6
7
8
91
0
1
2
3
4
5R
C
R
F
X
X
X
X
X
X
X
X
X
X
X
X
X
X
-
Where the bits are defined as:
-
Value
Description
RC
Specifies the type of the initiator. An initiator MUST set this field in a Ping Request, as defined in Ping Message (section 2.1.2), if the OperatingSystemType ADM attribute of the QueueManager ([MS-MQDMPR] section 3.1.1.1) ADM element is neither WinServer nor WinEnt; otherwise, this field MUST NOT be set. An acceptor MUST set this field in a Ping Response, as defined in Ping Message (section 2.1.2), to the value of this field in the Ping Request from the initiator.
RF
An acceptor MUST set this field in a Ping Response if it would currently refuse a protocol session over TCP or SPX from this initiator; otherwise, the field MUST be clear if a protocol session would be accepted. An initiator MUST clear this field in a Ping Request.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
X
Unused bit field. MAY be set when sent and MUST be ignored on receipt.
Signature (2 bytes): A 16-bit unsigned short integer field that identifies the packet as a Ping Message packet. This value MUST be set to 0x5548. A receiver MUST ignore the packet if the signature is not set to this value.
Cookie (4 bytes): A 32-bit unsigned long integer that specifies a value used to correlate Ping Requests and Ping Responses. This value is generated by the initiator to uniquely identify the Ping Request. This field has a valid range from 0x00000000 to 0xFFFFFFFF.
-
When sending a Ping Response, an acceptor MUST set this field to the Cookie field value from the received Ping Request. When an initiator receives a Ping Response, it uses the Cookie field to correlate it to a Ping Request. An initiator MUST disregard a Ping Response that contains a Cookie field that does not correspond to the Cookie field in the most recent Ping Request that it has sent.
QMGuid (16 bytes): The GUID ([MS-DTYP] section 2.3.4.1) that identifies the queue manager where this packet was created, which is the initiator for Ping Requests and the acceptor for Ping Responses.