Previous Topic: &MSGREAD Message Profile

Next Topic: Sample APPC Conversations

&PPOREAD Message Profile

The message profile variables set following &PPOREAD are private to the PPOPROC system procedure, and are different from the variables that form the message profile for the &INTREAD, &LOGREAD and &MSGREAD verbs.

&PPOALERT

Value is YES if this message was routed to PPOPROC as a result of a &PPOALERT verb. &PPOALERT can be used to send messages to PPOPROC either locally or in remote systems. If the message was not originated by a &PPOALERT then value is NO.

&PPOCOLOR

Value is set according to the SYSPARMS PPOCOLOR= operand.

&PPODEFM

Value is YES if the message number has been defined by the DEFMSG command for delivery to PPOPROC. This variable can be set to NO if delivery for the UNSOLICITED class of messages PPOPROC delivery IS set but specific delivery for this message number is NOT.

&PPODOMID

The delete operator message identifier (DOMID) of the message if the PPO message is non-roll delete. Value is DOMID if &PPONRD = YES; otherwise, this variable is set to null value.

&PPODLOC

Value is YES if the message number is one that has been defined through the DEFMSG command for LOCAL delivery. Value is NO if message has not been defined for delivery to local receivers.

&PPODREM

Value is YES if the message number is one that has been defined through the DEFMSG command for REMOTE delivery. Value is NO if message has not been defined for delivery to remote receivers.

&PPOFIRST

Indicates the first message from a possible multi-line message block delivered to PPOPROC. The purpose of this variable is to indicate a new VTAM message group but not necessarily the first message of the group delivered by VTAM as these might not be eligible for delivery to PPOPROC.

&PPOHLITE

Value is set according to the SYSPARMS PPOHLITE= operand.

&PPOLDID

Domain ID of the last region to handle this PPO message. If generated by the local system, this variable will contain the domain ID of the local system. The value can be different from the originating domain ID if the message was onward routed by an intermediate system.

&PPOMSGNO

The VTAM message number of the PPO message just received. Note that this value is also available in the &ZMPPOVNO message profile variable following a &INTREAD, &LOGREAD, or &MSGREAD operation.

&PPOMSGSV

The VTAM message severity level associated with the PPO message just received. Value can be U (undeliverable), I (information), W (Important!), N (normal), or S (severe).

Note that the value is also available in the &ZMPPOSEV message profile variable following a &INTREAD, &LOGREAD, or &MSGREAD operation.

&PPONRD

Value is YES if the PPO message has the non-roll delete attribute (which occurs if a reply is required to the message). Otherwise, value is NO.

&PPOODID

The domain ID of the region from which the PPO message originated.

&PPOONETN

The network name of the VTAM that generated the PPO message.

&PPOONMID

The region ID (from the SYSPARMS ID= operand) of the system that generated the message.

&PPOPRIRN

If the PPO message contains qualified network resource names this is the primary NETWORK name.

Your product analyzes message text based on VTAM tables to extract resource names. This extraction does not necessarily reflect SNA class resources, and can vary with the version of VTAM.

CA recommends that resource extraction be performed at message level by PPOPROC, as the extracted values might not reflect the true resource hierarchy in the VTAM multi-line messages.

&PPOPRIRS

If the PPO message contains network resource names this is the primary resource name. In the context of PPOPROC, this is the resource name of the first message in a VTAM multi-line display.

Your product analyzes message text based on VTAM tables to extract resource names. This extraction does not necessarily reflect SNA class resources, and can vary with the version of VTAM.

CA recommends that resource extraction be performed at message level by PPOPROC, as the extracted values might not reflect the true resource hierarchy in the VTAM multi-line messages.

&PPOSECRS

If the PPO message contains network resource names this is the secondary resource name. If the message is part of a VTAM multi-line message, this is the first resource name in the current message.

&PPOSECRN

If the PPO message contains qualified network resource names, this is the secondary NETWORK name.

&PPOOSSCP

The SSCP name of the VTAM that generated the PPO message.

&PPOTEXT

The PPO message text.

&PPOTIME

The PPO message generation time in HH.MM.SS.TTT format. For messages delivered across an ISR link it reflects time from the remote system converted to the time on the local system.

&PPOTYPE

Defines the type of PPO message received. Value is PPO if the message is a standard unsolicited message delivered from VTAM, SPO if the message is actually the reply to a command issued by an OCS operator or NCL procedure or CMD if the message is a copy of a command entered by an OCS operator or NCL procedure.

&PPOUID

The user ID associated with a message or command which has &PPOTYPE = CMD or &PPOTYPE = SPO, or for which &PPOALRT = YES.

&PPOVMSG

Indicates (YES or NO) whether a message was found as a VTAM message in the DEFMSG table.