Appearance of text in this book

This book uses the following type styles:

CompCode
The name of a parameter of a call, a field in a structure, or an attribute of an object
dltmqbrk
A control command or command message
MQRFH
The name of a data type or structure
MQPS_COMMAND
The name of a constant
MQPSCommand Publish
Examples
"MQPSTopic"
A character string

How to read syntax diagrams

This book contains syntax diagrams (sometimes referred to as "railroad" diagrams).

Each syntax diagram begins with a double right arrow and ends with a right and left arrow pair. Lines beginning with a single right arrow are continuation lines. You read a syntax diagram from left to right and from top to bottom, following the direction of the arrows.

Other conventions used in syntax diagrams are:

Table 1. How to read syntax diagrams
Convention Meaning
Read syntax diagramSkip visual syntax diagram>>-A--B--C-----------------------------------------------------><

You must specify values A, B, and C. Required values are shown on the main line of a syntax diagram.
Read syntax diagramSkip visual syntax diagram>>-+---+-------------------------------------------------------><
   '-A-'

You may specify value A. Optional values are shown below the main line of a syntax diagram.
Read syntax diagramSkip visual syntax diagram>>-+-A-+-------------------------------------------------------><
   +-B-+
   '-C-'

Values A, B, and C are alternatives, one of which you must specify.
Read syntax diagramSkip visual syntax diagram>>-+---+-------------------------------------------------------><
   +-A-+
   +-B-+
   '-C-'

Values A, B, and C are alternatives, one of which you might specify.
Read syntax diagramSkip visual syntax diagram   .-,-----.
   V       |
>>---+---+-+---------------------------------------------------><
     +-A-+
     +-B-+
     '-C-'

You might specify one or more of the values A, B, and C. Any required separator for multiple or repeated values (in this example, the comma (,)) is shown on the arrow.
Read syntax diagramSkip visual syntax diagram   .-+---+-.
   | '-,-' |
   V       |
>>---+---+-+---------------------------------------------------><
     '-A-'

You might specify value A multiple times. The separator in this example is optional.
Read syntax diagramSkip visual syntax diagram   .-A-.
>>-+---+-------------------------------------------------------><
   +-B-+
   '-C-'

Values A, B, and C are alternatives, one of which you might specify. If you specify none of the values shown, the default A (the value shown above the main line) is used.
Read syntax diagramSkip visual syntax diagram>>-| Name |----------------------------------------------------><

Name:

|--A--+---+-----------------------------------------------------|
      '-B-'

The syntax fragment Name is shown separately from the main syntax diagram.
Punctuation and uppercase values Specify exactly as shown.
Lowercase values (for example, name) Supply your own text in place of the name variable.