The product JConnect, which is supplied and installed together with WebAdmin, is used for linking to the UTM applications that are to be administered.
The program KDCWADMI and the KDCWADMI TAC have to be generated for UTM applications. The following KDCDEF statements must be included in the generation:
PROGRAM KDCWADMI, COMP=ILCS | (in BS2000 systems) | |
| or | ||
PROGRAM KDCWADMI, COMP=C | (in Unix/Linux or Windows systems) | |
| and | ||
TAC KDCWADMI, PROGRAM=KDCWADMI, CALL=BOTH, ADMIN=Y |
The program unit is already supplied with openUTM and does not need to be explicitly linked.
In addition, an access must be generated for the UPIC client WebAdmin, e.g. using the following KDCDEF statements:
BCAMAPPL <bcapplname>, T-PROT=RFC1006 | |
TPOOL LTERM=<upiclt>, NUMBER=10, PRONAM=*ANY, PTYPE=UPIC-R | |
,BCAMAPPL=<bcapplname> | |
USER WEBADMIN, PASS=C'XYZ', PERMIT=ADMIN, RESTART=NO |
A password is not mandatory for the WebAdmin user. If a password is assigned, it must be printable and must comply with the character set restrictions prescribed by the UPIC interface.
Listener port and selector format: The listener port and the selector format must be specified when defining the UTM application in WebAdmin (see UTM applications) and must match the corresponding values in the generation of the UTM application.
For UTM applications in BS2000 systems the listener port is always implicitly set to 102. For Unix/Linux and Windows applications, the listener port is specified in the BCAMAPPL generation statement with the LISTENER-PORT=<port> parameter.
For BS2000 applications, the selector format is always implicitly Transdata. For Unix/Linux and Windows applications, the selector format can likewise be specified in the BCAMAPPL generation statement (TSEL-FORMAT=<format> parameter). The values T (Transdata), E (EBCDIC), and A (ASCII) are available. If this parameter is omitted in the BCAMAPPL statement, UTM uses the value Transdata if <bcapplname> uses the Transdata character set, otherwise it uses the value EBCDIC. It is advisable to explicitly specify the selector format using the TSEL-FORMAT parameter in the BCAMAPPL statement.
Notes on the UPIC sign-on service: If a UPIC sign-on service is generated for the UTM application (SIGNON UPIC = YES), it is best to deactivate the sign-on service in the BCAMAPPL statement used for communicating with WebAdmin (BCAMAPPL <bcapplname>,SIGNON-TAC=*NONE). If a UPIC sign-on service is nevertheless assigned to the respective BCAMAPPL, then the KDCWADMI TAC must be taken into account when programming this sign-on service.
Access via LTERM / PTERM As an alternative to access via a terminal pool (TPOOL statement), it is also possible to explicitly generate a connection for WebAdmin:
LTERM <upiclt> | |
PTERM <upicpt>, LTERM=<upiclt>, PRONAM=<upicpro>, BCAMAPPL=<bcapplname>, PTYPE=UPIC-R |
When defining the UPIC connection in WebAdmin, it is necessary to specify the PTERM name <upicpt>. In the case of an explicit UTM generation of a connection for WebAdmin, it is necessary to specify the name of the WebAdmin application host in <upicpro>. See the corresponding paragraph above for information on the listener port and selector format in the PTERM statement.
Advantage of an explicit connection for WebAdmin:
GeneratingMAX PRIVILEGED-LTERM=<upiclt>
makes it possible to minimize the response times of UTM applications under load.