Use the NOTE subcommand to direct messages to the IPCSPRNT data set, IPCSPDS data set, your terminal, or all three, and to control spacing and pagination.
Thus, a message may be truncated to a different length for each destination.
NOTE directs the message to the IPCSPRNT data set, IPCSPDS data set, your terminal, or all three, depending on the PRINT, PDS, and TERMINAL parameters. If you omit the PRINT, PDS, and TERMINAL parameters, NOTE uses the current local defaults for these parameters.
{ NOTE } ['text']
{ N }
[CAPS | ASIS ]
[PAGE | NOPAGE ]
[ SPACE[(count)] ]
[ NOSPACE ]
[ OVERTYPE ]
[ TOC ([indentation | 1] [toc-text ]) | NOTOC ]
-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.
[ FLAG(severity) ]
[ PRINT | NOPRINT ]
[ TERMINAL | NOTERMINAL ]
[ PDS | NOPDS ]
[ TEST | NOTEST ]
If you omit this parameter, IPCS transmits no message but performs the specified spacing or paging relative to the previous line on the terminal or in the IPCSPRNT and/or IPCSPDS data sets.
CAPS specifies that IPCS translate the message text to uppercase.
ASIS specifies that IPCS not translate the message text, but transmit it in its present form.
If you omit both CAPS and ASIS, the default is CAPS.
PAGE specifies a new page. PAGE affects printed output only. If the message is printed, NOTE precedes the message with a page eject. If the message is displayed on a user's terminal, NOTE ignores the PAGE parameter.
NOPAGE specifies that a new page not be forced before printing the message.
If you omit both PAGE and NOPAGE, the default is NOPAGE.
SPACE specifies the number of blank lines to be inserted before the message. The count may be specified as a decimal number. If you specify a count greater than PAGESIZE - 2 (as specified in the session parameters member), IPCS uses PAGESIZE - 2. If this parameter causes a page eject, you may lose 1 or 2 blank lines.
If you specify SPACE but omit the count, it defaults to 1.
NOSPACE inserts no blank lines before the message. The message becomes the next line in the output.
OVERTYPE overlays this message on the previous message. For example, you may use this parameter to underscore all or part of the previous message. The subcommand ignores this parameter if you specify no text or if the output is directed to a terminal.
If you omit SPACE, NOSPACE, and OVERTYPE, the default is NOSPACE.
NOTOC specifies that no table of contents entry is to be generated. NOTOC is the default.
See Standard subcommand return codes for a description of the return codes produced by the NOTE subcommand.