How to implement custom MAI Node Name validation.

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

How do I implement customer MAI Node Name validation?

Answer:

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 +                            

&DO                                                                   

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

      &$MASDLUNAME = &STR REPVAL1                                     

   &ELSE &DO                                                          

      &SYSMSG = &STR '&$MASDLUNAME' IS NOT A SUPPORTED VALUE!         

      &RETCODE 8                                                      

   &DOEND                                                             

&DOEND          

&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.      

   eg.                                                                

   &&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.