JCL requirements for the LICON utility

To run the LICON utility program (FABLIU00), supply an EXEC statement and DD statements.

Subsections:

EXEC statement

The statement must have the following form: 
// EXEC PGM=FABLIU00,
//      PARM='IMSID=imsid,IMSPLEX=imsplex,DBRCGRP=dbrcgrp'
IMSID=imsid
A 4-character IMS ID specifying which global option module is to be used at the IMS subsystem level.

This parameter is optional. If you omit it, the LICON utility determines the IMS ID by use of the batch SCD module (DFSVC000) loaded from the IMS load module library.

IMSPLEX=imsplex
A 1 - 5 character IMSplex name to be used for RECON data sets. This parameter is optional.
DBRCGRP=dbrcgrp
A 1 - 3 character identifier (ID) assigned to a group of DBRC instances that access the same RECON data set in an IMSplex. This parameter is optional.

Summary of DD names

The following table summarizes the DD names for the LICON utility.

Table 1. DD names for the LICON utility
DDNAME Use Format Need
JOBLIB or STEPLIB Input PDS Required
DFSRESLB Input PDS Required
FABLICON Input and output KSDS Required (see Note 1)
FABLPRNT Output SYSOUT Required
FABLIN Input SYSIN Required
DBDLIB Input PDS Optional (see Note 2)
ACBLIB Input PDS Optional (see Note 2)
RECONx Input Optional (see Note 1)
Notes:
  1. If dynamic allocation is used, omit the DD statement.
  2. If IMS directory is not specified, either DBDLIB or ACBLIB DD statement is required.

DD statements

Code the following DD statements to identify the source of input and the placement of output information:
JOBLIB or STEPLIB DD
Specifies the load module library, which contains the following resources:
  • The LICON utility program (FABLIU00)
  • The global option modules (installation level and IMS subsystem level)
  • The IMS load module library
  • The library that contains DFSMDA dynamic allocation members for the RECON data sets. If the RECONx DD statement is omitted, the library is required (only for HALDBs)
  • The library that contains randomizing routines, segment edit/compression exit routines, HALDB partition selection exit, or DEDB partition selection exit when creating a new RDE or verifying a DMB against an RDE with CHKRAND=Y, CHKCOMP=Y, CHKPSEL=Y, or CHKFPSEL=Y option. Even if the exit routines are placed in the LPA and LINKLST, you must specify the library that contains them.
  • The SCI exit routine for the RECON data sets (optional)
  • The SGLXLOAD library of IMS Tools Base 1.7 or later if you use IMS directory (optional)
DFSRESLB DD
This DD statement is a required DD statement that specifies the library that contains the IMS load modules.
FABLICON DD
This statement defines the LICON data set. Do not use it if you want to make the LICON utility allocate the LICON data set dynamically.
DBDLIB DD
This statement specifies which input DBD library is to be used for the job.
ACBLIB DD
This statement specifies which input ACB library is to be used for the job.
Note: Either the DBDLIB or the ACBLIB DD statement is required. If both the DBDLIB and the ACBLIB DD statements are specified in your JCL, the commands of the LICON utility, except the VERIFY.DB command, use the DBDs in the specified DBDLIB data sets.
FABLPRNT DD
This statement specifies which output data set contains the report.
FABLIN DD
This statement specifies which input control statement stream.
RECONx DD
For HALDBs, the RECONx DD statement is required. If this DD statement is omitted, DBRC dynamically allocates the data sets by using DFSMDA dynamic allocation members.

JCL example

For a JCL example, see the relevant command topics under LICON utility reference.