Updating IMS for DELTA IMS and DELTA IMS VIRTUAL TERMINAL customization

This topic describes the steps you must complete to update IMS.

  1. Define spare elements.You can postpone this step until after the initial installation; however, you will have to perform another IMSGEN at a later time.

    For more information about defining spare elements, see the product documentation.

  2. Add BMCLINK.Add the APPLCTN and TRANSACT macros that define BMCLINK to your IMS Stage-1 input as shown in the example below. You can replace the name BMCLINK with a name of your choice. If your site requires that IMS program names match PSB names, the BMCLINK program name is DLAXCTL0.

    Warning

    BMC does not recommend defining the BMCLINK program as a GPSB.

    APPLCTN  PSB=BMCLINK,PGMTYPE=(BATCH),
          SCHDTYP=SERIAL
    TRANSACT CODE=BMCLINK,AOI=YES

    Notes

    • If you are running IBM IMS Shared Queues with RM enabled, define the BMCLINK APPLCTN as SCHDTYP=PARALLEL.
    • The transaction code is not required for DBCTL regions. The PSB and transaction names must match the names that are specified in member DLA#ACB of the DLACNTL library.
    • Type 1 AOI (CMD) command security Application programs can issue IMS commands by using the CMD communications call and retrieve the command response by using the GCMD communications call. These commands are called Type 1 AOI commands.

    A RESOURCE record with a resource name of $TRANCM1 controls the security for Type 1 AOI commands. To create an IMS RESOURCE record for Type 1 AOI commands, enter the following INSERT subcommand:

    INSERT DIVISION(musid|jobname) RESOURCE.qualifier -
    NAME($TRANCM1) TYPE(ICM|type) {VALIDATE|NOVALIDATE}

    The eTrust CA-ACF2 for IMS interface performs validation processing for Type 1 AOI (CMD) commands by default. If you do not want to secure Type 1 AOI commands, you must deactivate the eTrust CA-ACF2 for IMS interface validation processing for these commands. To deactivate this command validation, create an IMS RESOURCE record for Type 1 AOI commands that specifies NOVALIDATE.

    BMCLINK uses Type 1 AOI (CMD) processing.

    For additional information, see eTrust CA-ACF2 for IMS documentation.

  3. If you will use DELTA IMS to customize one or more DBCTL regions, create BMCLINK subsystem control cards for the DBCTL regions. Otherwise, skip this step.A member that contains a BMCLINK subsystem control card must be stored in the PROCLIB of each DBCTL region that will be customized through DELTA IMS. The member must take the form iiiissss (where iiii is the IMSID of the DBCTL region and ssss is a four-character suffix that will be used for all BMCLINK subsystem control cards).

    Note

    BMC recommends that ssss be the same value that is specified for the SSM parameter in the DFSPBxxx member for this region.

    If you have not already done so, specify a value for the SSM parameter in the DFSPBxxx member. You will use this value during this installation for DBCTL regions.

    This is the same value that you will specify in the IMSID IMS DBCTL region 'SSM' suffix name option later in the configuration process.

    The PROCLIB member iiiissss contains a control card. The control card format depends on the IMS version that you are running. For example, under IMS 15.1, the format is ssn,BMC1,DLABETB7.

    The following table describes the information that you must provide in the control card.

    Keyword

    Description

    ssn

    A one- to four-character BMCLINK subsystem name. It can be any name and it does not have to match any other name. This name is used in the /DIS SUBSYS ssn command.

    BMC1

    A literal value.

    DLABETBx

    The name of the external Subsystem Module Table, where x is one of the following suffixes for the corresponding IMS version:

    6 for IMS Version 14.1

    7 for IMS version 15.1

  4. Perform an IMSGEN.If you intend to use DELTA IMS to add resource elements (applications, databases, transactions, route codes), at least one of each type of resource element that is needed must be SYSGENed in the system. You should add at least one of the appropriate resource element(s) to the system at this time so that you do not have to perform another IMSGEN later.

  5. Update AOIS.Perform one of the following modifications, as appropriate, to the applicable type of IMS region:

    • For DBCTL regions, update the AOIS keyword in PROCLIB member DFSPBxxx. You must specify a value that will authorize BMCLINK to issue IMS commands.
    • For IMS control regions, you must update IMS security.  You can authorize BMCLINK to unlimited command use . However, you must at least authorize it to use the CHANGE command. 

    Note

    If you used a transaction name other than BMCLINK in your IMS Stage-1 input, use the same name in the statements that you create to authorize IMS commands for BMCLINK.

  6. Perform an IMS PSBGEN and ACBGEN.A sample PSBGEN/ACBGEN job stream is provided in member DLA#ACB of the DLACNTL library (this is the job name only if you use the BMC defaults for the install JCL). The required PSB (with recommended IOASIZE) is as follows:

    PSBGEN PSBNAME=BMCLINK,IOASIZE=1024,LANG=ASSEM

    Use the following guidelines when you prepare for the PSBGEN:

    • The PSB and transaction names (transaction name does not apply to DBCTL regions) must match the names that are specified in member DLA#ACB of the DLACNTL library.
    • The IOASIZE value that you specify in your PSBGEN must match the value that you specify on the Global Options panel in the Maximum DL/I command size field. For more information, see Setting-global-options.

Related topic

Customizing-DELTA-IMS-and-DELTA-IMS-VIRTUAL-TERMINAL


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*