Resolution Sequence
The dialogs that run when a terminal signs on (beginning with dialog KLGATEWY) resolve, (assign values to) the various data elements. The sequence begins by resolving the data element that identifies the user. It continues by examining data sources to resolve information about the various selections made.
The KLGDRES dialog implements the resolution sequence by invoking the data sources defined in the gateway configuration members KLGICFG1, KLGICFG2, and KLGICFG3 of &rhilev.RLSPARM.
The following list summarizes the resolution sequence:
- USERDATA is inspected, if it was supplied at logon.
- If information from USERDATA did not resolve the data element, NAM is searched.
- Panel sources (if any) are searched if either of the following
applies:
- Neither NAM nor USERDATA supplied a value.
- The DISPLAY keyword is specified in the configuration member to force panel invocation.
- The EXIT data source is inspected. An EXIT source is not invoked if a value is supplied by any of the prior sources, unless the EXAMINE keyword is included in the configuration member to force EXIT invocation.
- The data element is set to the default when no other data source can produce a value.
Table 7 lists the standard dialogs, data elements, and variable names involved in the resolution process.
| Standard Dialog | Data Element | Variable Name |
|---|---|---|
| KLGNTRY | USERID | VIGUSER |
| KLGNTRY | ACCOUNT | VIGACCT |
| KLGNTRY | GROUP | VIGGROUP |
| KLGNTRY | PROC | VIGPROC |
| KLGNTRY | NEWPSWD | VIGNPSWD |
| KLGNTRY | PASSWORD | VIGPSWD |
| KLSUINI1 | APPLIST | VIGAPLST |
| KLSCNTL | DEST | VIGDEST |
| KLGSSHG | USERDATA | VIGDATA |
| KLGSSHG | LOGMODE | VIGLMODE |
| KLGSSHG | POOL | VIGPOOL |
| KLGSSHG | PRTNODE | VIGPNODE |
| KLGSSHG | BRTPOOL | VIGPRTPL |
| KLGSSHG | LTERM | VIGLTERM |
| KLGSSHG | PRTLTERM | VIGPLTRM |
| KLGSSHG | PRTLGMOD | VIGPRTLG |
When a user logs on, the KLGATEWY dialog starts.
KLGGW2 calls the KLGNTRY dialog, which processes the data elements concerned with user identification and logon procedure information (see Table 6). The KLSPG00 dialog then issues either the VIGENTRY function, and/or the VSSENTRY CL/SuperSession function. One of those functions invokes the KLSUINI1 dialog as the initialization dialog and KLSCNTL as the control dialog. KLSUINI1 sets up the names of the commands, selection characters, and status codes for the user's environment. It also sets up a list of all the applications that a user is authorized to access. KLSUINI1 resolves the APPLIST data element (see Table 6).
KLSCNTL (called from either VIGENTRY or VSSENTRY in the KLSPG00 dialog after KLSMP230 completes) clears out the DEST data elements and calls the KLGDRES dialog to resolve them. In the KLGICFG1 configuration, KLGDRES calls the KLSVSEL dialog, which displays the selection menu. KLSVSEL1 waits for a user action. When a selection is made, KLSCNTL calls dialog KLGSSHG, which completes the data element resolution.