Previous Topic: &PPOALERT

Next Topic: &PPODEL


&PPOCONT

Resumes normal processing of a VTAM PPO message and optionally overrides delivery options or queues a copy of the message to a specific ISR link.

&PPOCONT [ NONE | LOCAL | REMOTE | ALL |
           LINK={ linkname | * } |
           DOMAIN={ domainid | * } ] 
         [ ALARM={ YES | NO } ] 
         [ COLOR=color ] 
         [ HLIGHT=highlight ] 
         [ INTENS={ HIGH | NORMAL } ]

Used within a PPOPROC procedure to return a message from the previous &PPOREAD to your product region for processing.

The message may either be returned for standard delivery, or delivery may be overridden by the &PPOCONT verb.

Operands:

NONE

This operand indicates that delivery will take place according to delivery options specified for the VTAM message in the DEFMSG table. All other delivery options will override those specified in DEFMSG.

LOCAL

The PPO message will be released for delivery to local PPO recipients only. The message is no longer available to PPOPROC.

REMOTE

The PPO message will be released for delivery to eligible ISR links enabled for PPO/ISR outbound traffic. LOCAL delivery is suppressed. The message is no longer available to PPOPROC.

ALL

This releases the PPO message for delivery to authorized PPO receivers, and to all eligible ISR-connected systems (unless any ISR delivery has already been performed). The message is no longer available to PPOPROC.

LINK={ linkname | * } | DOMAIN={ domainid | * }

If a specific link or domain is indicated, a copy of the message is queued to the specified link. Addressing to a local link name, or a remote domain ID may be used.

When an asterisk (*) is specified, a copy of the message is queued to all ISR links that are enabled for PPO/ISR outbound traffic.

The message is not released, but remains available to PPOPROC.

ALARM={ YES | NO }

Specifies whether the terminal alarm is sounded when the message is delivered.

COLOR=color

Specifies the screen display color for the message. Valid values are:

RED GREEN BLUE TURQUOISE YELLOW PINK WHITE

HLIGHT=highlight

Specifies whether the message is to be highlighted. Valid values are:

REVERSE BLINK USCORE

INTENS={ HIGH | NORMAL }

Specifies the message intensity required.

Examples: &PPOCONT

&PPOCONT LINK=CENTRAL

An &PPOCONT issued when no VTAM PPO message is available is ignored.

If the current message is a copy of an SPO (VTAM command response) message, or a copy of a VTAM command, the message or command is never delivered locally.

Notes:

An &PPOCONT need not be issued if another &PPOREAD is issued. If a message is being processed and another &PPOREAD is issued without an intervening &PPODEL or &PPOREPL, an implied &PPOCONT is performed and the message is returned for standard processing before the next &PPOREAD is carried out.

&PPOCONT is used to free a message for delivery even though the PPOPROC procedure continues processing before issuing another &PPOREAD.

When PPO messages are delivered to connected systems the Inter System Routing facility (ISR) is used to carry the PPO message traffic; this facility allows centralized collection of PPO message traffic.

If LINK=linkname or DOMAIN=domainid is specified, the &ZFDBK system variable is set, following execution, as follows:

0

Message queued satisfactorily.

4

Not sent, message originated or arrived from nominated link, or already sent to this link.

8

The specified link or domain was not enabled for PPO. This may mean that the link has not been started or PPO ISR has not been enabled for the link.

12

The specified link or domain is enabled for PPO but is not enabled for outbound unsolicited PPO traffic.

16

Message not sent, storage error.

20

Message not sent, ISR queue overflow.

24

Previous &PPODEL LINK/DOMAIN has blocked this link.

28

ISR internal error.

If &PPOCONT LINK=* or DOMAIN=* is used, the &ZFDBK system variable is set as follows:

0

Message queued to at least one ISR link.

4

Message not queued to any ISR link.

8

Previous &PPODEL LINK/DOMAIN=* has prevented any delivery.

In all other cases, &ZFDBK is set to zero (0) by &PPOCONT.

Message COLOR and HIGHLIGHT values you specify in the &PPOCONT verb override the PPOCOLOR and PPOHLITE SYSPARM variables.

More information:

&PPOREAD

&PPODEL

&PPOREPL