Authorization 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 |
BINARY(4) |
| 10 |
User profile |
Input |
CHAR(10) |
| 11 |
Authorization results |
Output |
Array of CHAR(4) |
Exit point name: QIBM_QNS_SDDSTAUTH
Exit point format name: AUTH0100
The Authorization exit program determines whether an activity is authorized
to occur on the specified nodes. This exit is called one or more times per
activity before the distribution operation occurs. If the exit is called more
than once, the list of nodes that are being checked is different each time. The
exit determines if the activity should be allowed to run based on the criteria
it specifies (that is, license information). The exit returns a value for each
node indicating whether the activity may be performed.
The exit program is registered using the Add Exit Program (QUSADDEP) API and
using QIBM_QNS_SDDSTAUTH as the exit point name, with format AUTH0100.
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. When the transport type is *SVDS or *SNADS,
each destination element has the following format:
| Network ID |
CHAR(8) |
| 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.
- Authorization result
- OUTPUT; Array of CHAR(4)
For each of the destinations, indicates whether the change management activity
may be performed.
- *YES
- *NO
Error Messages
If an error message is generated by the Authorization exit program, the
activity is not performed.