Invoke the IUI Main Dialog (DGADISTR)

Typically, IUI invocation is done inside ISPF, since doing it outside ISPF via ISPSTART makes it difficult to use the other ISPF options. Connect:Direct® for z/OS® IUI invocation must be done using ISPF SELECT with PGM, not SELECT with CMD. The SELECT can be in a Panel, a CLIST or REXX, or in an ISPF command table entry. The only prerequisite is that all required application libraries are allocated, either via LIBDEF, or TSO ALLOCATE commands.

A new ISPF APPLID for IBM Connect:Direct for z/OS has to be specified by using NEWAPPL(applid). If LIBDEF was used to allocate the application component data sets, and NEWAPPL was specified in the SELECT, then you must also specify PASSLIB or the LIBDEFs are not used.

Panel

&ZSEL = TRANS( TRUNC (&ZCMD,'.') … CD,'PGM(DGADISTR) PARM(cd-netmap-dsn) …)

CLIST

ISPEXEC SELECT PGM(DGADISTR) PARM(cd-netmap-dsn)

REXX

ADDRESS ISPEXEC “SELECT PGM(DGADISTR) PARM(cd-netmap-dsn)”

CMD Table

ZCTACT = SELECT PGM(DGADISTR) PARM(cd-netmap-dsn)

Note that if the generic LIBDEF for DMNETMAP is active, “PARM(cd-netmap-dsn)” is not required and is ignored if specified.