Previous Topic: LOWLIGHT KeywordNext Topic: REWORD Keyword

CA Automation Point Keywords › Keywords for Controlling the Display › PREFIX Keyword

PREFIX Keyword

The PREFIX keyword specifies the prefix of messages appearing in certain CA Automation Point windows or files.

This keyword has the following format:

PREFIX(string)
string

Specifies the prefix of the messages appearing in the following CA Automation Point windows or files:

Specify this prefix information in a series of character strings separated by blank spaces. You form these character strings from a set of twelve alphanumeric characters, each representing a character from a different type of information. For example, the letter T represents a character from the message time stamp, and the letter J represents a character from a job name.

For example, if your message string contains TTTTTT, all six characters of the time stamp appear in the message text:

122433   IEC501A M 480, MIM,BLP, 1600 BPI, MIM02, CLONETAP

The order and punctuation of the character strings determine the order and punctuation of the actual pieces of information they represent. For example, the following character strings display both the time and the job name, in that order.

TT:TT:TT JJJJJ
12:24:33   MIM10 IEC501A  M 480, MIM,BLP, 1600 BPI, MIM02, CLONETAP

Character

Meaning

3

Represents &JES3name for SYSPLEX or JES3MCS consoles, or system name for other sessions.

A

Represents the action indicator. If the message is issued as an action message, this indicator has a non-blank value, usually the asterisk (*) or the at-sign (@).

C

Represents a character of the &MONTYPE access variable. Use uppercase C only; stands for category.

E

Represents a character of the &MONPRTY access variable. Use uppercase E only; stands for error.

H

Represents a character of the &MONNAME access variable. Use uppercase H only; stands for host.

J

Represents a character of the job name or identifier from the message. Use uppercase J only.

L

Represents the string specified in the session definition as a window title. Use uppercase L only.

N

Represents a character of the &MONNUM access variable. Use uppercase N only; stands for number.

P

Represents a character of the default system name that is displayed with messages received from a session. Use uppercase P only. (You set a default system when you define your session.) Some processors need this character to route the information properly.

R

Represents a character of the reply ID for a write-to-operator with reply (WTOR) message. Use uppercase R only.

S

Represents a character of the session name for the session receiving the message. Use uppercase S only. This name is the ID that you assign to a session when you define the session.

T

Represents a character of the timestamp from the message. Use uppercase T only.

Global Default: SSSSSSSS TTTTTT JJJJJJJJ RRA.

To provide no prefix, specify two single quotes ('') in the edit box. This setting overrides the default.

Default: The value the Local Session Prefix in the session definition

Usage Note:

CA Automation Point formats multi-line messages so that each line uses all 80 columns of the display area. If these messages included prefixes, CA Automation Point splits the messages onto two lines.

Example:

The following message is the first line of a multi-line message issued in response to a DISPLAY CONSOLES command:

IEE249I 13.30.23 CONSOLE DISPLAY 741

The following rule prevents the CA Automation Point prefix from appearing at the beginning of the message, and prevents CA Automation Point from splitting the message:

MSGID(IEE249I), PREFIX()