AddUserNote

This procedure can be called from assembler language code to add a USERdefinedNOTIFICATION notification to the note queue and cause the initiation of GetNextNote if it is waiting for a notification. Figure 1 shows a sample calling sequence.

Figure 1. Sample calling sequence

           LA    R13,PASCSAVE
           LA    R1,PASCPARM
           L     R15,=V(ADDUSERN)
           BALR  R14,R15
                  .
                  .
PASCSAVE   DS    18F     Register save area
ENV        DC    F'0'    Zero initially.  It is filled with
                         an environment address.  Pass it unchanged
                         in subsequent calls to ADDUSERN.
DATA1      DS    H       Data for Connection field of notification.
DATA2      DS    C       Data for Protocol field of notification.
DATA3      DS    XL40    Data for UserData field of notification.
RC         DS    F       AddUserNote stores return code here.
 
PASCPARM   DC    A(ENV)
           DC    A(DATA1)
           DC    A(DATA2)
           DC    A(DATA3)
           DC    A(RC)

Parameter

Description

ReturnCode (RC)

Indicates the success or failure of the call. Possible return values are:

OK
NObufferSPACE