APINCCLG

#### Search Results

Search

# APINCCLG

This API lets the user retrieve and purge a change control log. It also allows the user to purge an open change control log.

APINCCLG can be invoked with:

    CALLNAT 'APINCCLG' API-PARM #API-CCLG-PARM

D | to retrieve a change control log.
P | to purge an open change control log.

Important
Reset the field SEL-DATE programmatically before the call is made to APINCCLG.

This document covers the following topics:

- Local Data Area UCCLCCLG

- Application API Return Codes

## Local Data Area UCCLCCLG

A definition of #API-CCLG-PARM is provided in LDA UCCLCCLG.

Field Name | Format | I/O
--- | --- | ---
#API-CCLG-PARM |  |
#API-CCLG-PARM-1 | A250 |
#API-CCLG-PARM-1 |  |
APPLICATION | A32 | in
OBJECT | A8 | in
LIBRARY | A8 | in
DBID | N5 | in
FNR | N5 | in
VERSION | N4 | in
SEL-DATE | T | in
REQUEST-ID | A20 | out
STATUS | A32 | out
OUT-VERSION | N4 | out
OUT-LIBRARY | A8 | out
OUT-DBID | N5 | out
OUT-FNR | N5 | out
OUT-USERID | A8 | out
OUT-TIME | T | out
OUT-TID | A8 | out
IN-VERSION | N4 | out
IN-LIBRARY | A8 | out
IN-DBID | N5 | out
IN-FNR | N5 | out
IN-USERID | A8 | out
IN-TIME | T | out
IN-TID | A8 | out

When APINCCLG is called:

- #API-CCLG-PARM.APPLICATION should carry the name of the change control log's application.

- #API-CCLG-PARM.OBJECT should carry the name of the object.

- #API-CCLG-PARM.LIBRARY should carry the library name of the NATURAL location of the maintenance deployment.

- #API-CCLG-PARM.DBID should carry the database number of the NATURAL location of the maintenance deployment.

- #API-CCLG-PARM.FNR should carry the file number of the NATURAL location of the maintenance deployment.

- #API-CCLG-PARM.VERSION should carry the object's version number.

If [API-PARM.API-MAIN-FUNC] = 'D' and the change control log is found then APINCCLG returns in the remaining parameter fields the change control log data including the name of the maintenance status and the name of the maintenance request (if one is associated with the log).

If [API-PARM.API-MAIN-FUNC] = 'P' and the change control log is found then APINCCLG purges it even if it is open.

## Application API Return Codes

APINCCLG returns the following [API-PARM.API-MSG-NO]:

1011 | if an [API-PARM.API-MAIN-FUNC] distinct from both 'D' and 'P' has been specified,
7251 | if the application is unknown or the change control log has not been found,
7255 | if the change control log has been retrieved,
7256 | if the change control log has been purged.

Other values of API-PARM.API-MSG-NO may be received in more unusual situations.

### On this page

- Local Data Area UCCLCCLG
- Application API Return Codes