Previous Topic: Insert a New IMS Environment MemberNext Topic: Select/Repeat a BMP Environment Member


Select/Repeat a DLI Environment Member

To define, maintain, or update a DLI environment, and to save this environment definition into a member of the IMS Environment Parm PDS, you can use the DLI Environment Parameters screen. A DLI environment is required for each set of data sets used to invoke an IMS process in DLI mode.

For example: Various QA and test systems that require different DBDLIB, PSBLIB, or RESLIB data sets require separate DLI environments.

Each batch or on-line process that performs functions such as browsing, editing, printing, unloading, reloading, or updating an IMS database, needs to know the IMS data sets to use when invoking IMS in DLI mode to perform the function. The use of DLI environments allows a set of IMS data sets to be catalogued and referenced by the DLI Environment Name.

To select or repeat a DLI environment member

  1. Select SETUP from the Main Menu.

    The Setup and Processing Parameters screen opens.

  2. Select IMS ENV from the menu.

    The Update IMS Environment screen opens.

  3. Type S (select) or R (repeat) next to the environment whose definition you want to select or repeat.

    The DLI Environment Parameters screen opens with the DLI Environment parameters populated with their current values.

    --------CA File Master Plus for IMS -- DLI Environment Parameters ---------- Command ===> __________________________________________________________________ IMS Environment ===> DLIPROD Description ===> Production DLI Environment RESLIB #1 ===> 'YOUR.PROD.IMS.RESLIB' #2 ===> #3 ===> More? ==> N PSBLIB #1 ===> 'YOUR.PROD.IMS.PSBLIB' #2 ===> #3 ===> More? ==> N DBDLIB #1 ===> 'YOUR.PROD.IMS.DBDLIB' #2 ===> #3 ===> More? ==> N VSAM Parm Mem ===> 'YOUR.PROD.IMS.PARMLIB(DFSVSAMP' Log DSN ===> 'YOUR.PROD.IMS.IEFREDR' Change Log Parameters: Volume Serial ===> ______ or Generic Unit Name ===> ________ Primary Cyls ===> 0 (0 = No Logging) Secondary Cyls ===> 0 PF1 HELP PF3 END PF8 FWD

  4. Complete the following fields, and press F8.
    IMS Environment

    Displays the IMS environment member name that identifies the DLI environment that is defined by this screen. The IMS environment name is the member name of the IMS environment parm PDS that will be updated when you exit this screen.

    Description

    Defines the use of this IMS DLI environment and differentiates it from other IMS environments.

    Limits: 42 characters.

    RESLIB

    Defines up to 3 RESLIB DSNs. The More field to the right of the IMS RESLIB #3 field is used to enter more than 3 RESLIB DSNs. When more than 3 RESLIB DSNs are defined for the DLI environment, this field contains the protected literal + More DSNs.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    PSBLIB

    Defines up to 3 PSBLIB DSNs. The More field to the right of the IMS PSBLIB #3 field is used to enter more than 3 PSBLIB DSNs. When more than 3 PSBLIB DSNs are defined for the DLI environment, this field contains the protected literal + More DSNs.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    DBDLIB

    Defines up to 3 DBDLIB DSNs. The More field to the right of the IMS DBDLIB #3 field is used to enter more than 3 DBDLIB DSNs. When more than 3 DBDLIB DSNs are defined for the DLI environment, this field contains the protected literal + More DSNs.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    More?

    Defines whether you want to add more data sets to these library concatenations. Contains up to a total of 99 DSNs for each library concatenation.

    Values: Y (Yes), N (No)

    + More DSNs

    Defines whether the library concatenations contain more data sets than the three displayed on this panel. Placing the cursor anywhere on this character string, and pressing Enter, displays the entire library's concatenation.

    VSAM Parm Mem

    Defines the DSN and member name for the VSAM/OSAM Buffer Information Parm. IMS batch jobs created by the user interface will have this parm member allocated to the DFSVSAMP DDNAME.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    Log DSN

    Defines the DSN for the IMS log data set. Required for any online or batch IMS process in which there is update intent on a database. This file is required for recovery and restart of any IMS job. If the DSN already exists, it must be allocated with RECFM=VB LRECL=4092 BLKSIZE=4096.

    The DSN entered can be a valid DSN or may contain any of the following variable specifications to support the use of multiple log files for a DLI environment:

    • &USERID—TSO User ID
    • &DATE—Dyymmdd where yymmdd is the date in YYMMDD format
    • &TIME—Thhmmss where hhmmss is the time in hours, minutes, and seconds
    • &DBDNAME—DBD name of the database being processed

    For example, a value of &USERID.&DATE.FMIMS.LOG would request an IMS log data set with the TSO User ID in the first node and the date in the second node. If USER01 does an update on Dec. 25, 2006, it will be written to the log USER01.D061225.FMIMS.LOG.

    If the IMS log data set does not exist when the online process or online creation of JCL occurs, an IMS log data set will be created.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    Change Log Parameters:
    Volume Serial

    Specifies the 6 digit volume serial of the volume that the Change Log file should be created on.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    Generic Unit Name

    Defines the DASD unit name used to allocate the Change Log file. Common DASD unit names are SYSDA and SYSALLDA.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    Primary Cyls

    Defines the primary number of cylinders to allocate to a new Change Log file. Specifiy the estimated number of cylinders to contain the before and after images of all changed segments, plus any inserted or deleted segments during an EDIT session or sessions.

    If this value is 0, no Change Log records are written and no Change Log file is allocated to the EDIT session. Any value greater than zero allocates the Change Log file and causes the EDIT function to record Change Log records for any segment changes during and EDIT session.

    Default: Zero

    Values: Numeric, between 0 and 9999999.

    Note: This value cannot be set to 0 when Change Log is activated by your CA File Master Plus for IMS administrator.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    Secondary Cyls

    Defines the number of secondary cylinders to allocate to a new Change Log file if the primary cylinder allocation is exceeded.

    Default: Zero

    Values: Numeric, between 0 and 9999999.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

  5. Press PF8 to go to the second DLI Environment Parameter screen.

    The DLI Environment Parameters screen opens.

    ---------- CA File Master Plus for IMS -- DLI Environment Parameters ---------- Command ===> __________________________________________________________________ IMS Environment ===> DLIPROD Page 2 of 2 Description ===> Production DLI Environment DBRC Usage ===> _ Blank = Defer to IMS System Definition Specification (Default) Y = Use DBRC N = Do not use DBRC RECON Dataset Overrides: RECON1 ===> ______________________________________________ RECON2 ===> ______________________________________________ RECON3 ===> ______________________________________________ PF1 HELP PF3 END PF7 BACK

  6. Complete the following fields, and press End to save the DLI member.
    IMS Environment

    Displays the IMS environment member name that identifies the DLI environment that is defined by this screen. The IMS environment name is the member name of the IMS environment parm PDS that is updated when you exit this screen.

    Description

    Defines the use of this IMS DLI environment and differentiates it from other IMS environments.

    Limits: 42 characters.

    DBRC Usage

    Defines the DBRC value when CA File Master Plus for IMS calls IMS either through its online or batch functions.

    Values: Blank (IMS's current DBRC value), Y (Yes), N (No)

    RECON1

    Defines the RECON1 dataset that overrides the RECON1 dataset that would have been otherwise dynamically allocated by IMS.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    RECON2

    Defines the RECON2 dataset that overrides the RECON2 dataset that would have been otherwise dynamically allocated by IMS.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

    RECON3

    Defines the RECON3 dataset that overrides the RECON3 dataset that would have been otherwise dynamically allocated by IMS.

    Note: This field may be restricted by the CAWKOPT COM_IMSENV_DLI installation option. If this is the case, the user must have File Master DBA authority to update this protected field.

The DL1 member is saved.

Note: This value cannot be set to 0 when Change Log is activated by your CA File Master Plus for IMS administrator.