BLSQSHDR — Generate model subheader

Description

The BLSQSHDR macro defines a text string, called a subheader, and makes it appear as part of the output of the model processor. Subheaders are also used to contain the character string or strings to be compared with the contents of a field within the data being formatted, and to determine whether the data is to be treated as hexadecimal or EBCDIC. See the description of the DTYPE=QANY parameter on the BLSQMFLD macro.

BLSQSHDR, with its text string, should be placed after the end of the format model definition. Create a format model definition by coding two BLSQMDEF macros, one at the beginning and one at the end of the definition. The BLSQMFLD macros define the data fields of the format model. They are included between the two BLSQMDEF macros. The SHDR fields of the BLSQMFLD macros refer to text strings (subheaders) that the user places after the end of the model definition. This is the order of the macros:

       BLSQMDEF
       BLSQMFLD
          .
          .
          .
       BLSQMFLD
       BLSQMDEF
       BLSQSHDR

Each BLSQSHDR macro placed after the end of the model must have a label that the BLSQMFLD macros within the model can reference. The text string of the BLSQSHDR macro is enclosed in single quotation marks. L(x) can also be coded when the length of the string is different than the length of the enclosed text string.

See z/OS MVS IPCS Customization for information about format models.

Environment

Because BLSQSHDR is not an executable macro, there are no specific environment requirements.

Programming requirements

None.

Restrictions

None.

Register information

Because BLSQSHDR is not an executable macro, there is no need to save and restore register contents.

Performance implications

None.

Syntax

This is the standard form of the BLSQSHDR macro:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede BLSQSHDR.

BLSQSHDR

␢	One or more blanks must follow BLSQSHDR.

L(`x`)	`x`: Length of subheader - when other than
	length of actual text

`'text'`	`text`: Text of subheader

Parameters

The parameters are explained as follows:

L(x): specifies the length of the subheader. Specify the length only when it is different from the length of the enclosed text string.

Examples

SHDR01  BLSQSHDR 'This is a subheader'

SHDR02  BLSQSHDR L(6)' '