Using Notification Manager › Creating Your Own Invocation Programs › Architected Parameters

Architected Parameters

Notification Manager always passes the following parameters to your program. Do not place these parameters in the Notification Manager database if possible.

Ask

Specifies question and answer arguments. For a detailed description of this parameter, see the Command and Keyword Reference Guide.

Debug

Determines whether your program produces debugging messages in the ASOTRACE log. Values are:

YES—Your program should produce debugging messages in the ASOTRACE log. For an example of how to do this from a REXX program, see the DEBUGMSG subroutine in either the NMPAGE or the NMVOICE program. You can also use the ERRORMSG subroutine found in either of these programs.

NO—Your program should not produce debugging messages in the ASOTRACE log.

Item

Each time NMFIND is invoked, it obtains a unique four-digit number (called its item number) that distinguishes it from all other active NMFIND requests. This is that number. Only specify this parameter if you intend to allow your target person to use the call-in feature.

ItemDepth

When NMFIND is invoked, it builds a tree that contains all the time blocks that are active for the contact and time specified. This number specifies the depth of the tree node containing the time block that is causing your code to be invoked. Only use this parameter if you intend to pass parameters to other invocations of your code.

ItemIX

When NMFIND is invoked, it builds a tree that contains all the time blocks that are active for the contact and time specified. This number specifies the index of the tree node containing the time block that is causing your code to be invoked. Only use this parameter if you intend to pass parameters to other invocations of your code.

Tell

The string or voice file that you want to tell the notified personnel. The maximum length of the TELL string is 250 characters.

Use

Determines whether your program should handle the ASK parameter, the TELL parameter, or both parameters on this particular invocation. Values are:

ASK—Your program should only handle the ASK parameter.

TELL—Your program should only handle the TELL parameter.

BOTH—Your program should handle both the ASK and the TELL parameters.