Selection API

API Routine: APINSEL
Parameters: UGNLPARM, UGNLSEL

The Selection API allows users to select PAC objects with specific selection criteria. The following functions are available:

A Select an Application.
E Select a Migration Event.
H Select an Archive Event.
J Select a Job.
L Select an Application Status Links.
M Select a Maintenance Request.
S Select a Status.
T Select a Migration Path.
V Select a Versioned Object.

This document covers the following topics:


Local Data Area UGNLSEL

A definition of API-SEL-PARM is provided in LDA UGNLSEL.

APINSEL now returns 7251 rather than 7250 in API-PARM.API-MSG-NO if an existing application has been specified and there are no versioned objects or change control logs satisfying all selection criteria.

Field Name Format I/O
API-SEL-PARM    
CRIT-1 A32 in
CRIT-2 A32 in
CRIT-3 A32 in
OBJ-CNT P5 in/out
OBJ-1 A32 (1:10) 1* out
OBJ-1    
OBJ-1-ENTRY (1:10)  
CCL-PGM A8  
CCL-VER N4  
CCL-MREQ A20  
OBJ-1    
OBJ-1-ENTRY-V (1:10)  
OBJV-OBJECT-ID A32  
OBJ-2 A32 (1:10) 1* out
OBJ-2    
OBJ-2-ENTRY (1:10)  
CCL-LIB A8  
CCL-DB N3  
CCL-FNR N3  
CCL-USER A8  
CCL-STATE A3  
CCL-DATE T  
OBJ-2    
OBJ-2-ENTRY-V (1:10)  
OBJV-VERSION A4  
OBJV-TYPE A6  
PAC-AREA B126 in/out

1*: This is the proposed default value. Any value equal or greater 1 can be defined by the user.

Selection API Return Codes

1011 Invalid function.
7251 Object not found.
9999 End of selection.