PARMGEN z/OS DLA utility jobs and commands

The PARMGEN z/OS DLA integration provides not only the KCIJPDLA composite job, but also some function jobs and commands that you can run based on your requirements.

DLA jobs in the UTILITIES menu

In the UTILITIES menu, you have additional utility options for the KCIJPDLn jobs. Enter the option numbers in UTILITIES menu to bring up the jobs.
Table 1. DLA jobs in Utilities menu
Option number in the UTILITIES menu DLA job description
15 The composite KCIJPDLA job is presented for submission. You can also run the DLAJOB command on the Utilities menu command line to bring up the KCIJPDLA job in edit mode. Review the job for more information. KCIJPDLA job performs the functions of the standalone KCIJPDL1, KCIJPDL2 and KCIJPDL3 jobs. Other available sub-options under option 15 are as follows:
15s1
Similar to the DLAIDML command to view the KCIJPDLA output #1: RTE_PLIB_HILEV.RTE_NAME.IZD.IDML z/OS DLA IDML XML books dataset.
15s2
Similar to the DLARPT command to edit the KCIJPDLA output #2: RTE_PLIB_HILEV.RTE_NAME.WCONFIG($DLARPT) PARMGEN DLA report.
15s3r
Similar to the DLARTE command to edit the KCIJPDLA output #3: RTE_PLIB_HILEV.RTE_NAME.WCONFIG(DEMO) PARMGEN LPAR RTE user profile.
15s3g
Similar to the DLAGBL command to edit the KCIJPDLA output #4: RTE_PLIB_HILEV.RTE_NAME.WCONFIG($GBL$USR) PARMGEN global user profile.
16 The KCIJPDL1 job is presented for submission. You can also run the DLAJOB1 command on the Utilities menu command line to bring up the KCIJPDL1 job in edit mode. Review the job for more information.
Other available sub-option under option 16 is as follows:
16s
Similar to the DLAIDML command to view the KCIJPDL1 output RTE_PLIB_HILEV.RTE_NAME.IZD.IDML z/OS DLA IDML XML books dataset.
17 The KCIJPDL2 job is presented for submission. You can also run the DLAJOB2 command on the Utilities menu command line to bring up the KCIJPDL2 job in edit mode. Review the job for more information.
Other available sub-option under option 17 is as follows:
17s
Similar to the DLARPT command to edit the KCIJPDL2 output RTE_PLIB_HILEV.RTE_NAME.WCONFIG($DLARPT) PARMGEN DLA report.
18 The KCIJPDL3 job is presented for submission. You can also run the DLAJOB3 command on the Utilities menu command line to bring up the KCIJPDL3 job in edit mode. Review the job for more information.
Tip: When reviewing the resulting WCONFIG DEMO.... LPAR RTE and $GBL$USR global user profiles, run EXCLUDE FIND (XF Macro if set-up) on * from $DLARPT references to find all the parameter values extracted from the $DLARPT DLA report. For the updated WCONFIG override imbeds such as KMQ$CUSR or KQI$XML, look for the Discovered headers to find all the auto-discovered lines added to the imbeds for applicable active z/OS resources.
Other available sub-options under option 18 are as follows:
18sr
Similar to the DLARTE command to edit the KCIJPDL3 output #1: RTE_PLIB_HILEV.RTE_NAME.WCONFIG(DEMO) PARMGEN LPAR RTE user profile.
18sg
Similar to the DLAGBL command to edit the KCIJPDL3 output #2: RTE_PLIB_HILEV.RTE_NAME.WCONFIG($GBL$USR) PARMGEN global user profile.

DLA commands

Instead of typing the options in the UTILITIES menu, you can run DLA commands to bring up the jobs.
Table 2. DLA jobs in Utilities menu
DLA commands Command description
DLAJOB The RTE_PLIB_HILEV.RTE_NAME.WCONFIG(KCIJPDLA) "Composite PARMGEN z/OS Discovery Library Adapter (DLA) job." is presented for review and submission.
DLAJOB1 The RTE_PLIB_HILEV.RTE_NAME.WCONFIG(KCIJPDL1) "Create the z/OS DLA IDML books on active z/OS resources." is presented for review and submission.
DLAJOB2 The RTE_PLIB_HILEV.RTE_NAME.WCONFIG(KCIJPDL2) "Generate PARMGEN $DLARPT report from DLA IDML books dataset." is presented for review and submission.
DLAJOB3 The RTE_PLIB_HILEV.RTE_NAME.WCONFIG(KCIJPDL3) "Refresh DEMO/$GBL$USR user profiles with $DLARPT data." is presented for review and submission.
DLAIDML View the RTE_PLIB_HILEV.RTE_NAME.IZD.IDML dataset that contains the IDML DLA XML books. This dataset is created by submitting the KCIJPDLA composite job or the KCIJPDL1 "Create the z/OS DLA IDML books on active z/OS resources." job. The DLAIDML command displays the IDML books dataset is view mode only.
DLARPT Review the RTE_PLIB_HILEV.RTE_NAME.WCONFIG($DLARPT) DLA report. This report is created by submitting the KCIJPDLA composite job or the KCIJPDL2 "Generate PARMGEN $DLARPT report from DLA IDML books dataset." job. The DLARPT command displays the $DLARPT in edit mode if you want to customize the report further, prior to submitting the next job (KCIJPDL3), which uses the $DLARPT DLA report data to refresh the PARMGEN user profiles.
DLAMAP Review the RTE_PLIB_HILEV.RTE_NAME.WCONFIG ($DLAMAP) parameter DLA map report. This report is created by submitting the KCIJPDLA composite job, or the CKIJPDL3 "Refresh rte/$GLB&USR" user profiles with $DLARPT data" job. DLAMAP command displays the $DLAMAP report that maps what $DLARPT parameters equate to the equivalent PARMGEN rte and $GLB&USR user profile parameters.
DLADLTA Review the RTE_PLIB_HILEV.RTE_NAME.WCONFIG($DLADLTA) DLA delta report. This report is created by submitting the KCIJPDLA composite job, or the KCIJPDL2 "Generate PARMGEN $DLARPT report from DLA IDML books dataset" job if both $DLARPT and $DLAMAP reports already exist in the RTE's WCONFIG dataset. DLADLTA command displays the $DLADLTA delta report that compares the previous $DLARPT report with the latest $DLARPT report run. The delta report highlights the changes in the RTE user profile and the $GBL$USR global user profile.
DLARTE Review the RTE_PLIB_HILEV.RTE_NAME.WCONFIG(DEMO) LPAR RTE user profile. The LPAR RTE user profile is refreshed by the KCIJPDLA composite job or the KCIJPDL3 "Refresh DEMO / $GBL$USR user profiles with $DLARPT data." job. The DLARTE command displays the DEMO.... LPAR RTE user profile in edit mode if you want to customize the member further.
DLAGBL Review the RTE_PLIB_HILEV.RTE_NAME.WCONFIG($GBL$USR) global user profile. The $GBL$USR user profile is refreshed by the KCIJPDLA composite job or the KCIJPDL3 "Refresh DEMO / $GBL$USR user profiles with $DLARPT data." job. The DLAGBL command displays the $GBL$USR global user profile in edit mode if you want to customize the member further.