Receive Unsolicited PPO Messages

Working with Other Products › Receive Unsolicited PPO Messages

Receive Unsolicited PPO Messages

CA NetMaster NA can receive PPO messages.

You perform this procedure using the PPO and the ISRIN Parameter Group panels.

PROD------------------ Customizer : Parameter Group ----------------Page 1 of 1 Command ===> Function=Browse .- PPO - PPO Message Interface Details ---------------------------------------. | | | PPO ACB Name .................... ________ (default NMPPO) | | | | 1 PPO Procedure Name .............. ________ (default $RSPPOPR) | | |

PROD------------------ Customizer : Parameter Group ----------------Page 1 of 1 Command ===> Function=Browse .- ISRIN - ISR (Inbound) -----------------------------------------------------. | | | PPO Messages: | | ISR Link Name ............. | | Is the ISR Link to NetView? ________ (No if NetMaster, Yes if NetView) |

To enable CA NetMaster NA to receive PPO messages

In the PPO parameter group, specify the required PPO ACB name. The PPO ACB Name is the name of the ACB used to receive unsolicited PPO messages. If the ACB is not resident in this region, specify the name of the region where it resides. Specify the name in the PPO Messages ISR Link Name field on the ISRIN Initialization Parameters panel. (The ISR Link Name is the name of the region in which the PPO ACB is located. This value automatically initiates a link from CA NetMaster NA to the other region.)
If the region specified in the ISRIN ISR Link Name field is CA NetMaster NM for SNA, specify an outbound ISR link from that region to the CA NetMaster NA region. In the CA NetMaster NM for SNA region, specify the link in the ISROUT parameter group.
The group issues the following commands to start a link:
```
LINK START=link-name
ISR ENABLE=PPO LINK=link-name SOL=YES UNSOL=OUT
DEFMSG DELIVER=(PPO,REMOTE) ALL
```
link-name is the PPO messages ISR link name in the ISROUT parameter group.
If the region specified in the ISRIN ISR Link Name field is NetView, specify YES in the Is the ISR Link to NetView? field. If not, specify NO.
Important! If you want to obtain PPO messages from another region, ensure that any &PPODEL verbs in the PPOPROC NCL procedure in that region use the LOCAL operand. The operand enables remote delivery of the affected messages.
The other field in the PPO parameter group is PPO Procedure Name whose value must be $RSPPOPR. If you have special processing requirements for your PPO messages, create a $RSPPOEX exit procedure in NCL and put it in the TESTEXEC data set.
The $RSPPOPR procedure calls this exit for every received PPO message. Ensure that your exit does not introduce delays that can cause overflow of the message queue. The following variables are shared to the exit:
- &PPO* message profile variables as described in the Network Control Language Programming Guide.
- &EXRESOURCE variable that contains the name of the resource that is associated with the message. Setting this variable ensures that only the messages in the SNA model for this resource are checked for state changes and actions. You can use this variable to attribute a message to a specific resource.
- &EXRESOURCE2 variable that contains the name of a second resource if the message is applicable to two resources.
If the exit sets 1 as the return code, the region ignores the PPO message. You can use this return code to filter out messages that do not require further processing.
Filter out messages that do not require further processing. If the exit sets 1 as the return code, the region ignores the PPO message.