How to implement custom MAI Node Name validation.

Document ID : KB000014469
Last Modified Date : 14/02/2018
Show Technical Document Details

How do I implement customer MAI Node Name validation?


RO73755 supports External validation of MAI session node names.

After applying RO73755 you will need to do the following - 


1. Create an NCL procedure member in the TESTEXEC library to validate 

   the value of a variable whose name is supplied in &$GPPNEXFIELD.   

   Note: Do not use a member name starting with $.                    

   Warning: Errors during execution will result in MAI sessions not   

   being updated.                                                     


   Example procedure to change 'A' to 'REPVAL1':-                     


&IF .&$GPPNEXFIELD EQ .$MASDLUNAME &THEN +                            


   &IF .&$MASDLUNAME EQ .A  &THEN +                                   

      &$MASDLUNAME = &STR REPVAL1                                     

   &ELSE &DO                                                          


      &RETCODE 8                                                      



&RETURN &SYSMSG                                                       


2. Update the NMINIT procedure in the TESTEXEC library to set         

   &&000$MAVNODE to the name of the procedure created in step 1.      


   &&000$MAVNODE = myproc   -* MAI session field validation exit      


3. To test the exit without restarting the region update the global   

   variable. In OCS or Command Entry enter the following:             


   $GLBL &&000$MAVNODE myproc                                         


4. Use /MSDM to update a session list and confirm that when updating  

   the Node Name field that the custom processing works as required.