Notification Exit Program


  Required Parameter Group:

1 Change request Input CHAR(10)
2 Sequence number Input BINARY(4)
3 Activity Input CHAR(10)
4 Activity type Input CHAR(10)
5 Transport type Input CHAR(10)
6 Change management verb Input CHAR(10)
7 Global name Input CHAR(64)
8 Destinations Input Array of CHAR(*)
9 Number of destinations Input Array of BINARY(4)
10 User profile Input CHAR(10)
11 Activity results Input BINARY(4)

  Exit point name: QIBM_QNS_SDDSTNTFY

  Exit point format name: NTFY0100

The Notification exit program notifies a user program of a change management activity result.

The exit program is registered using the Add Exit Program (QUSADDEP) API and using QIBM_QNS_SDDSTNTFY as the exit point name, with format NTFY0100.


Required Parameter Group

Change request
INPUT; CHAR(10)
Change request name

Sequence number
INPUT; BINARY(4)
Sequence number of the change request

Activity
INPUT; CHAR(10)
Activity name

Activity type
INPUT; CHAR(10)
The type of activity that is being performed; for example, *OBJ or *PTF.

Transport type
INPUT; CHAR(10)
The method by which the object or request is sent to the managed system.
Value Description
*SVDS SNA/Distribution Services, queue type = *SVDS, is used to send the object or request when distributing using Change Management.
*SNADS SNA/Distribution Services, queue type = *SNADS, is used to send the object or request when distributing using the Object Distribution Facility (ODF).

Change management verb
INPUT; CHAR(10)
The function to be performed by the managed system.
Value Description
*ACC Accept
*ACT Activate
*DLT Delete
*INI Initiate
*INS Install
*RMV Remove
*RTV Retrieve
*SND Send
*SNDINI Send and initiate
*SNDINS Send and install

Global name
INPUT; CHAR(64)
The global name of the object that is to be manipulated.

Destinations
INPUT; Array of CHAR(*)
The destinations for the request. If the transport type is *SVDS or SNADS, each destination element has the following format:
APPN Network ID CHAR(8)
APPN Control point name CHAR(8)
Reserved CHAR(4)

Number of destinations
INPUT; BINARY(4)
The number of destinations for the distribution request.

User profile
INPUT; CHAR(10)
The user profile for which the distribution is being performed.

Activity result
OUTPUT; Array of CHAR(4)
The end status for each destination node. It indicates whether the change management activity completed successfully.

0 Successful
0-9 Successful with warnings
10-89 Failed
90-99 Did not run due to conditions or schedules

Usage Notes:

Since activities may complete at different times for different nodes, this exit program may be called many times for different nodes.


Top | SM1 Exit Programs | APIs by category